Codex 中转站接入教程：灵能API CC Switch 从旧线路迁移到新线路
很多人不是第一次接入 Codex 中转站，而是已经有一条旧线路在用，后来想切换到更稳定、更清晰的新线路。迁移时如果直接覆盖配置，很容易出现旧 Key 残留、*ase **L 混用、模型 ID 不匹配、终端仍走旧会话等问题。本文以灵能API和 CC Switch 为例，整理一套从旧线路备份、新配置建立、最小请求验证到真实项目回归的迁移接入流程。
迁移前先别覆盖旧配置
从旧中转线路迁移到新线路时，最容易犯的错就是直接覆盖原配置。看起来省事，实际会让排错变得很麻烦：你不知道旧 Key 是否还在生效，不知道旧 *ase **L 是否被某个终端缓存，也不知道模型 ID 是来自旧服务还是新服务。
更稳的做法是先备份旧配置摘要，再建立新的灵能API配置卡。旧线路保留为回滚参考，新线路单独验证。等新线路在空目录、测试项目和真实项目里都通过后，再决定是否停用旧线路。
- 旧配置先备份，不直接覆盖。
- 新线路单独建卡，不和旧卡混在一起。
- 迁移验证分阶段完成。
- 成功后再清理旧 Key 和旧卡片。
第一步：打开灵能API确认新线路信息
迁移的第一步，是进入灵能API服务入口，确认新线路所需的信息：账户状态、模型列表、额度、*ase **L 和 API Key 创建入口。入口：https://www.lnsns.com/
不要把旧线路的模型名称直接搬到新线路里。不同服务的展示名称、接口 ID、版本后缀可能不完全一致，最终应以灵能API当前模型列表为准。
- 确认账户能正常登录。
- 确认当前模型列表里有要用于 Codex 的模型。
- 确认额度足够完成迁移测试。
- 准备创建 Codex 专用 API Key。
第二步：记录旧线路的非敏感摘要
迁移前可以记录旧线路信息，但不要复制完整 API Key。旧线路摘要的价值是方便对照和回滚，不是把敏感凭证再存一份。
旧线路摘要：
旧卡片名称：Codex-Old-Relay
旧 *ase **L：只记录域名和路径，不记录 Key
旧模型：旧线路默认模型
用途：日常开发或测试
状态：迁移前是否可用
备注：不要保存完整 API Key如果旧线路本来就已经失败，也要记录错误码。这样新线路验证失败时，才不会误以为所有问题都是迁移造成的。
- 记录卡片名称，方便区分旧线路。
- 记录旧模型和用途，方便判断迁移后是否等价。
- 记录是否可用，方便排查迁移前后的差异。
第三步：为新线路创建 Codex 专用 Key
新线路不建议复用旧 Key，也不要把其他工具的 Key 拿来混用。迁移时最好创建一枚明确用于 Codex 的新 Key，命名里写清用途和日期。
Key 命名建议：
Codex-Lingneng-Main-202608
Codex-Migration-****-202608
Codex-ProjectA-NewRelay
记录：用途、创建日期、负责人
禁止：完整 Key 明文进入截图、文章、日志如果迁移是因为旧 Key 泄露，则不要等待验证完成，应该尽快撤销旧 Key，并用新 Key 完成接入。
- 新 Key 创建后立即保存到安全位置。
- 复制到 CC Switch 前检查首尾空格。
- 迁移成功后再决定旧 Key 是否撤销。
**步：在 CC Switch 新建迁移配置卡
打开 CC Switch，新建一张独立配置卡，不要直接改旧卡。建议命名为“灵能API-Codex-Migration”或“灵能API-Codex-Main-New”。这样迁移阶段可以清楚地区分新旧线路。
迁移卡的目标是建立一条干净的新基线。等新线路通过验证后，再根据旧卡需求补充项目参数或备用模型。
- 卡片名称要包含灵能API和迁移用途。
- 用途备注写清新线路验证。
- 模型先选择稳定模型，降低排错难度。
- 不要一开始就复制旧卡所有高级参数。
第五步：填写新线路核心字段
迁移卡里最关键的仍然是 *ase **L、Model ID 和 API Key。三个字段必须来自同一套灵能API账户信息，不要把旧线路的地址、旧模型和新 Key 混在一起。
服务名称：灵能API-Codex-Migration
*ase **L：https://www.lnsns.com/v1
Model ID：从灵能API当前模型列表复制
API Key：新创建的 Codex 专用 Key字段填完后保存配置卡，并确认当前启用的是新迁移卡，而不是旧线路卡。
- *ase **L 不要重复 /v1。
- 不要把完整接口路径当成基础地址。
- Model ID 不要沿用旧服务里的展示名称。
- API Key 粘贴后检查首尾空格。
⚙️ 第六步：启用新卡后重开终端
CC Switch 切换到新迁移卡后，要关闭旧 Codex 会话和旧终端。旧会话可能仍然读取旧线路，继续在里面测试会造成误判。
codex --version
codex如果你同时打开多个项目窗口，迁移测试阶段建议全部关闭，只保留一个新终端，减少线路混淆。
- 先确认 Codex 命令能正常启动。
- 再进入空目录做最小测试。
- 不要在旧终端里判断新线路是否生效。
第七步：空目录验证新线路
新线路第一次验证不要放在真实项目里。新建空目录，只发送固定短提示词。这样可以排除项目文件、依赖、测试命令和长上下文干扰。
New-Item -ItemType Directory codex-migration-check
Set-Location codex-migration-check
codex请只返回：新 Codex 中转线路验证通过如果返回成功，说明新灵能API线路、CC Switch 卡片和新终端会话已经基本连通。如果失败，就按错误码定位，不要马上修改真实项目。
第八步：真实项目先做只读回归
空目录通过后，进入真实项目仍然先做只读回归。让 Codex 读取有限目录并输出项目结构、关键文件和下一步计划，确认新线路在真实项目上下文中也稳定。
请只读分析当前项目，不要修改文件。
允许读取：README.md、src、tests
禁止读取：.env、密钥文件、生产配置、数据库备份
输出：项目结构、关键文件、下一步建议只读回归通过后，再做一个低风险小修改，例如更新 README 或补充单个测试。不要刚迁移完成就执行大规模重构。
第九步：迁移失败时按错误码处理
迁移排错时一次只改一个变量。先修 Key，再查地址，再查模型，最后看项目任务体量。这样才能知道到底是哪一步解决了问题。
- 401：检查新 Key 是否完整、是否属于当前灵能API账户、是否首尾带空格。
- 403：检查账户额度、模型权限和访问策略。
- 404：检查 *ase **L 是否重复 /v1，模型 ID 是否来自新线路。
- 429：暂停重试，降低频率，检查近期用量。
- timeout：先用空目录短提示词复测，再检查网络和**。
- 仍走旧线路：确认 CC Switch 已启用新卡，并重开终端。
第十步：迁移成功**理旧线路
新线路通过空目录和真实项目验证后，再处理旧线路。根据情况可以停用旧卡、撤销旧 Key、归档旧配置摘要，并在团队文档中更新新线路说明。
清理旧线路不是可有可无。长期保留多个不明用途的卡片和 Key，会让后续排错越来越难。
- 旧 Key 已泄露：立即撤销。
- 旧线路不再使用：停用或删除旧卡。
- 仍需观察：标记为旧线路，不作为默认入口。
- 团队使用：同步更新接入文档和负责人。
✅ 最后一份迁移接入清单
按迁移流程接入后，Codex 中转站会更容易长期维护。灵能API提供新的中转 API 和模型入口，CC Switch负责新旧线路切换，而备份、验证和清理流程负责让迁移过程不混乱。
