接入前先明确：这不是只复制一个 Key

Codex 中转 API 的接入过程，可以理解为把本地 Codex 的请求路线改到新的服务入口。API Key 只是通行凭证，*ase **L 决定请求去哪里，模型 ID 决定调用哪个模型，CC Switch 决定本地当前启用哪条线路。

所以接入时不要只问“Key 填哪里”。更有效的方式是按顺序完成四件事：先让本地 Codex 能启动，再准备灵能API服务信息，然后在 CC Switch 填写配置，最后用最小请求验证。

• 本地环境：终端和 Codex 命令可用。
• 服务信息：Key、*ase **L、Model ID 准备完整。
• 配置切换：CC Switch 保存并启用正确卡片。
• 首次验证：空目录最小请求返回正常。

️ 第一步：先检查本地 Codex 能不能启动

在配置中转 API 之前，先确认本地命令行环境没有问题。打开 PowerShell 或终端，检查 Codex 命令是否能正常响应。如果本地命令都无法启动，先处理安装或环境变量问题，不要急着改 CC Switch。

codex --version

这一步很基础，但能省掉很多误判。中转站配置再正确，也解决不了本地命令不存在的问题。

• 能返回版本：说明本地 Codex 命令基本可用。
• 提示找不到命令：检查安装路径和环境变量。
• 启动后卡住：先关闭旧进程，再重新打开终端。

第二步：进入灵能API准备服务信息

本地命令确认后，再打开灵能API服务入口，准备接入所需的三类信息：API Key、*ase **L、Model ID。入口建议直接保存到自己的接入文档里，后续换电脑或排错时能快速回到同一个位置：https://www.lnsns.com/

如果你不确定哪个模型适合第一次验证，先选择一个稳定、响应快、成本可控的模型。首次接入的目标是跑通线路，不是测试模型能力上限。

• API Key：从自己的账户创建，不使用示例值。
• *ase **L：使用服务提供的统一接口入口。
• Model ID：从当前模型列表复制，注意大小写和连字符。

第三步：给 Codex 单独创建一枚 Key

建议给 Codex 单独创建一枚 API Key，不要混用浏览器插件、其他项目或团队成员的 Key。这样一旦出现异常用量、权限变化或需要撤销时，可以只处理 Codex 这条线路。

推荐命名：
Codex-Local-202608
Codex-C**witch-Main
Codex-Project-****

记录方式：只记录用途和创建日期，不记录完整 Key 明文

如果曾经把 Key 发给别人或写进共享文档，直接撤销再生成新的。对接入教程来说，安全边界和跑通流程同样重要。

• 复制 Key 后检查首尾是否多空格。
• 不要把 Key 放进截图、文章或公开仓库。
• 排错时只记录 Key 名称，不贴完整内容。

**步：在 CC Switch 新建本地接入卡

打开 CC Switch 后，新建一张本地接入卡。名称不要太随意，最好能体现服务、工具和用途，例如“灵能API-Codex-Local”。这样后面切换、截图、排错时都能看得懂。

新手常见错误是一次创建多张卡，结果不知道当前启用哪一张。第一次接入先保留一张主卡，跑通后再扩展。

• 服务名称：建议包含灵能API和 Codex。
• 用途备注：本地首次接入或日常开发。
• 模型选择：先使用基础稳定模型。
• 高级参数：第一次接入不建议填太多。

第五步：填写三个核心字段

CC Switch 中真正需要仔细核对的是 *ase **L、Model ID 和 API Key。*ase **L 如果多写一层路径，可能出现 404；模型 ID 如果写成展示名，可能出现 model not found；Key 如果复制不完整，通常会出现 401。

服务名称：灵能API-Codex-Local
*ase **L：https://www.lnsns.com/v1
Model ID：从灵能API当前模型列表复制
API Key：粘贴 Codex 专用 Key

字段填完后先保存，不要马上进入真实项目。下一步要确认这张卡真的被启用。

• *ase **L 不要写成完整 chat/completions 路径。
• 不要把 /v1 重复写两次。
• 模型字段使用接口接受的 ID，而不是说明文字。

⚙️ 第六步：保存、启用并重开终端

保存配置和启用配置是两件事。保存只是把字段写进 CC Switch，启用才表示 Codex 会走这张卡。启用后还要重新打开终端，让本地进程读取最新状态。

很多“明明配置了但不生效”的问题，都和旧终端有关。配置变更后重开终端，是接入流程里的固定动作。

• 确认卡片已保存，字段没有丢失。
• 确认当前启用的是灵能API-Codex-Local。
• 关闭旧 PowerShell、旧 Codex 会话和旧终端。
• 打开新终端后再执行 Codex。

第七步：用空目录做首次调用

首次调用不要在复杂项目里进行。新建一个空目录，只验证 Codex 能否通过灵能API中转 API 返回固定文本。这样失败时排查范围最小。

New-Item -ItemType Directory codex-local-relay-test
Set-Location codex-local-relay-test
codex

请只返回：本地 Codex 中转 API 接入成功

如果能稳定返回固定文本，说明本地 Codex、CC Switch 和灵能API线路已经连通。此时再进入真实项目会稳很多。

第八步：进入项目后先做只读任务

接入成功后，第一次进入项目仍然建议只做只读任务。比如让 Codex 解释目录结构、梳理模块入口、定位一个报错可能涉及的文件。不要一上来就要求它改多个文件。

请只读分析当前项目，不要修改文件。
输出：
1. 项目主要目录
2. 入口文件判断
3. 适合下一步检查的文件
4. 可能需要我确认的风险

只读任务通过后，再做小范围修改。这样能确认 Codex 读取范围、理解能力和中转线路都没有明显问题。

第九步：失败时按错误码处理

排错时一次只改一个变量。比如只换 Key、只改 *ase **L、只换模型。这样才能判断到底是哪一步修复了问题。

• 401：检查 API Key 是否完整、有效、属于当前灵能API账户。
• 403：检查额度、模型权限和账户访问策略。
• 404：检查 *ase **L 是否多写路径，模型 ID 是否存在。
• 429：暂停连续重试，降低频率，检查用量。
• timeout：先用空目录最小请求复测，再检查网络和**。
• 仍走旧线路：确认 CC Switch 已启用，并重开终端。

✅ 最后给一份本地接入清单

按这份清单做下来，Codex 中转 API 接入会清晰很多。灵能API提供服务入口，CC Switch管理本地线路，Codex负责执行任务；三者各司其职，接入和排错都会更顺。

• 本地 codex --version 能正常返回。
• 灵能API账户、模型和额度已确认。
• 已创建 Codex 专用 API Key。
• CC Switch 已创建灵能API-Codex-Local 配置卡。
• *ase **L、Model ID、API Key 已填写并逐项检查。
• 配置卡已保存、启用，并重新打开终端。
• 空目录首次调用通过。
• 真实项目先做只读分析，再放开小范围修改。