Codex 中转站多项目接入教程：灵能API CC Switch 环境隔离、切换与回滚
当一台电脑同时维护多个项目时，最容易发生的错误不是不会配置，而是项目之间互相污染。旧的环境变量、错误的工作目录、复用的模型卡片，都可能让 Codex 连接到不该使用的线路。本文从目录、配置卡和环境变量三个边界入手，整理一套适合多项目工作的隔离流程。
多项目接入最容易混淆的三个边界
每个项目至少有三个边界：项目目录、项目运行环境和 Codex 接入配置。目录决定读取哪些文件，运行环境决定使用哪些命令和变量，配置卡决定请求发往哪条线路。三者混在同一个终端里，就很难判断问题来自哪里。
接入前先写清边界，再建立对应卡片；不要把所有项目都指向一张名为‘默认’的配置。
- 目录边界：当前工作区和允许读取的文件。
- 运行边界：Node、Python、包管理器和 .env。
- 线路边界：*ase **L、模型、Key 和权限。
第一步：给每个项目建立线路登记表
打开灵能API服务入口，先确认项目需要的模型、接口地址和权限，再为每个项目登记一行信息。登记表只保存用途和配置元数据，不保存完整 API Key。
项目：do**-tool
环境：local
用途：代码阅读与文档生成
*ase **L：<当前接口地址>
Model ID：<当前模型标识>
Key：<本机安全存储>灵能API入口：https://www.lnsns.com/。项目登记表的作用是让你知道‘哪张卡给哪个项目使用’，而不是替代安全的令牌存储。
️ 第二步：在 CC Switch 中按项目命名配置卡
建议使用‘项目-环境-用途’的命名顺序，例如‘do**-tool-local-development’。如果同一项目有测试和生产线路，环境必须写进卡片名称，避免切换时依赖颜色或位置记忆。
卡片名称清楚之后，切换线路的动作就可以被检查和复述，团队成员也不必猜测当前状态。
- 每个项目保留一张已验证的基线卡。
- 测试卡和日常开**分开。
- 停用卡片标明日期和原因，不直接删除历史记录。
第三步：每次启动前确认工作目录
Codex 的上下文与当前工作目录密切相关。启动前先确认 PowerShell 位置，再检查项目根目录是否包含预期的 package.json、pyproject.toml 或其他入口文件。不要从另一个项目的终端窗口直接继续。
Get-Location
Get-ChildItem -Force | Select-O*ject Name
git status- 目录名称与配置卡中的项目名称对应。
- Git 状态属于当前项目，而不是另一个工作区。
- 启动命令从项目根目录执行。
**步：让项目变量与线路配置各自负责
项目的 .env 文件用于应用运行时，CC Switch 配置用于 Codex 客户端线路。两者可能都出现模型或地址字段，但来源不同。最稳妥的方式是明确谁是最终来源，避免系统变量、项目变量和客户端配置互相覆盖。
# .env.example
APP_ENV=development
APP_MODEL=<项目运行时模型>
APP_API_KEY=<本机填写，不提交仓库>- 模板保留占位符，真实值只在本机或安全存储中出现。
- 检查 .gitignore 是否忽略真实 .env。
- 不要用项目变量无意覆盖 Codex 的线路配置。
第五步：用固定流程切换项目
切换项目时，建议固定为‘停止旧进程、确认目录、启用卡片、重新启动、最小测试’五步。少做其中一步，就可能出现界面显示新卡片、实际进程仍使用旧配置的情况。
1. 关闭旧 Codex 进程
2. 进入目标项目根目录
3. 启用目标配置卡
4. 重新启动 Codex
5. 先执行只读测试不要在多个项目之间快速点击切换并同时保留多个终端。先完成一个项目的状态确认，再开始下一个项目。
第六步：用只读任务确认没有串项目
进入新项目后，第一条指令不要直接要求修改文件。可以让 Codex 列出当前目录、解释指定配置文件或概括一个模块，并明确告诉它不要写入。回答中如果出现另一个项目的文件名或约束，立即停止并检查上下文。
请确认当前工作目录和项目名称。
只读取 README.md 和 package.json。
不要修改任何文件。
说明当前项目的启动命令。只读验证通过后，再让 Codex 执行安装、测试或局部修改。这样即使线路切错，也能在没有写入变更前发现。
↩️ 第七步：为每个项目保留可回滚点
项目切换和线路调整都应该有回滚点。最简单的做法是保留上一张已验证卡片，并在项目变更前记录当前配置卡名称、工作目录和 Git 状态。发生异常时先回到这组已知状态，再逐项排查。
不要为了证明某个配置可用而删除项目现有修改。回滚动作必须明确范围，并保留当前状态记录。
- 配置回滚：切回上一张已验证卡。
- 代码回滚：只处理本次变更，不覆盖用户已有修改。
- 环境回滚：恢复项目所需的运行时和变量。
多项目场景常见错误
遇到问题时，先恢复到‘正确目录 已知稳定卡 只读任务’这个最小状态，再决定下一步。
- 卡片切换了但进程没重启：旧配置仍在内存中。
- 同名卡片太多：无法确认当前启用的是哪张。
- 从错误目录启动：Codex 读取了另一个项目。
- 环境变量覆盖客户端字段：界面值和实际请求不一致。
- 共享完整 .env：项目秘密扩散到不必要的设备。
- 测试直接写文件：还没确认线路就产生了项目变更。
✅ 多项目接入验收清单
灵能API与 CC Switch 适合被纳入项目工作流，但稳定的关键仍是清晰的目录边界、配置边界和验证顺序。
- 每个项目都有清晰的配置卡名称。
- 配置卡记录用途和环境，不记录完整令牌。
- 启动前能确认当前工作目录。
- 项目变量和 Codex 线路变量没有无意覆盖。
- 切换流程包含关闭旧进程和重新启动。
- 每次切换先执行只读验证。
- 每个项目都有可用的卡片和环境回滚点。