多项目使用最怕什么：线路和目录互相串台

一个人可能同时维护网站、脚本、数据处理工具和个人实验项目。如果所有任务都在同一个终端、同一张配置卡里执行，出现错误时很难判断是哪个项目、哪个模型或哪条线路导致的。多项目工作流的第一原则，是把项目目录、配置卡和测试任务分开。

这样做的目的不是增加流程，而是在错误发生时快速回答三个问题：当前在哪个项目？当前启用了哪张卡？当前任务允许修改哪些内容？

• 项目隔离：每个任务从自己的工作目录启动 Codex。
• 线路隔离：主线路、实验线路和备用线路分别命名。
• 权限隔离：首次进入项目只读指定文件。
• 结果隔离：每次切换后记录卡片名称和测试结果。

️ 先设计一套命名规则

配置卡和项目目录都建议使用可读名称。配置卡可以包含服务、客户端、用途和模型角色；项目目录使用项目名和环境区分。名称清晰后，切换线路时不会误把实验配置带到重要项目。

配置卡：灵能API-Codex-主线路
配置卡：灵能API-Codex-实验模型
配置卡：灵能API-Codex-备用线路
项目目录：D:\work\site-project
项目目录：D:\work\**ta-tool

不要使用“新配置”“默认配置 2”这种没有用途信息的名称。配置卡数量变多后，模糊命名会直接增加切换和排错成本。

第一步：统一记录灵能API服务参数

进入灵能API公开页面或控制台，记录当前可用模型、Model ID、接口地址和账户状态。不同项目可以使用不同模型，但服务参数应从同一份当前信息中获取，避免一个项目使用旧地址、另一个项目使用过期模型。

服务页面上的模型和价格可能更新，旧截图仅用于定位操作位置。正式使用前要重新确认当前页面信息。

• 官网入口：https://www.lnsns.com/
• Model ID：从当前模型列表复制。
• *ase **L：按当前接口说明填写版本路径。
• API Key：每个设备或用途尽量使用独立令牌。

️ 第二步：为每个项目建立自己的启动检查

进入项目目录后，不要直接让 Codex 执行修改。先检查本地工具、版本控制状态和当前目录。每个项目都可以保存一组简短的启动检查，减少不同项目之间的环境差异。

node -v
npm -v
codex --version
git status

如果某个项目依赖特殊 Node.js 版本、**或环境变量，应在项目说明中记录，但不要把 API Key 直接写入项目文件。敏感值放在本地私密位置，项目中只保留不含密钥的模板。

# 项目模板示意
CODEX_MODEL=<当前项目模型>
CODEX_*ASE_**L=https://www.lnsns.com/v1
CODEX_API_KEY=<仅在本机设置>

✍️ 第三步：在 CC Switch 中创建项目用途卡

如果不同项目需要不同模型，不要每次进入字段页面手动替换 Model ID。可以为任务角色创建卡片，例如快速问答、项目阅读、长上下文分析和实验线路。卡片名称表达用途，备注写明适用项目或限制。

复制稳定卡片创建新卡片时，必须重新检查四个字段：协议、*ase **L、Model ID 和 API Key。复制只解决录入效率，不代表新卡片已经验证。

• 日常项目：使用稳定主线路。
• 实验项目：使用独立实验卡片。
• 重要项目：保留经过验证的恢复卡片。

**步：地址、模型和密钥按项目角色填写

*ase **L 一般填写到 /v1，Model ID 从灵能API当前列表复制，API Key 使用与项目用途对应的专用令牌。不要把官网首页当成请求地址，也不要把完整接口路径重复拼到 *ase **L 后面。

服务名称：灵能API-Codex-site-project
*ase **L：https://www.lnsns.com/v1
Model ID：以当前项目测试结果为准
API Key：对应设备或项目用途的专用密钥

如果一个项目只需要短问答，不必默认使用最复杂的模型；如果项目需要大量上下文，先用一小段真实代码测试，再决定是否启用更强模型。每次变更都在独立卡片中进行。

第五步：项目首次启动只做三件事

第一次在项目中启动 Codex，建议按照‘确认目录—读取局部—提出计划’的顺序。不要一上来就让它扫描整个仓库或修改多个文件。

cd D:\work\site-project
git status
codex

第一条任务可以是：请只阅读指定文件，说明它的入口、依赖和风险，不要修改任何文件。第二条任务再让 Codex 给出小范围修改计划。确认计划后，才允许它执行单文件改动。

如果项目目录中包含密钥、生产配置或用户数据，先明确哪些文件不能读取，并在工作区权限和项目规则中做限制。不要因为连接成功，就默认可以访问目录中的所有内容。

✅ 第六步：用测试面板和空目录确认线路

切换配置后，保存并启用目标卡片，关闭旧的 Codex 和 PowerShell，再打开新终端。界面测试通过只能说明字段基本可用，真正的 Codex 进程仍然需要重新启动验证。

mkdir codex-workspace-check
cd codex-workspace-check
codex

空目录测试使用只读任务即可：请确认当前目录状态，并说明如果这里是项目，你会如何开始检查，不要创建、删除或修改文件。测试通过后再进入真实项目，能够减少环境和线路问题互相干扰。

多项目排错：先看目录，再看卡片，最后看接口

多项目环境出现错误时，建议按固定顺序排查。先确认终端当前目录是否正确，再确认 CC Switch 当前启用卡片，最后检查 *ase **L、Model ID 和 API Key。不要一看到错误就直接换模型。

排错记录可以包含项目名、卡片名、错误码和时间，但不要包含完整 API Key、账号信息或敏感项目内容。

• 401：检查当前卡片和对应 Key 是否有效。
• 403：检查额度、分组和模型权限。
• 404：检查 *ase **L，确认没有重复 /v1。
• model not found：重新复制当前 Model ID。
• 读取了错误项目：检查 PowerShell 的当前目录和启动命令。
• 切换不生效：关闭旧进程，重新启动 Codex。

团队协作时，公开模板不要包含真实配置

如果需要和团队成员共享接入方法，分享不含密钥的配置模板和截图即可。每个人在自己的灵能API控制台创建令牌，再在本机 CC Switch 中配置。不要把同一枚 Key 发到群聊、网盘或项目仓库。

查看当前服务说明、模型和令牌状态时，可通过可点击的灵能API官网入口进入：https://www.lnsns.com/。页面信息优先于团队旧文档。

• 共享内容：字段说明、脱敏截图、错误码和操作顺序。
• 本地内容：API Key、账号信息、项目路径和敏感文件。
• 版本管理：提交前检查 .env、配置文件和终端脚本。

最终检查：一个项目一条清晰链路

当项目、配置卡和权限边界都清楚时，Codex 才适合进入持续开发流程。后续增加项目时，只需要复制这套检查路径，不必重复猜测配置。

• 当前终端目录与目标项目一致。
• CC Switch 当前启用卡片名称清晰。
• *ase **L、Model ID 和 Key 对应当前用途。
• 旧 Codex 进程已经关闭并重新启动。
• 空目录或低风险项目测试已经通过。
• 真实项目首次任务只读取局部内容。
• 主线路和恢复线路都能在需要时切换。