先看懂：界面配置和本地配置不是两套东西
CC Switch 的价值，是把 Codex 中转 API 的关键字段可视化管理起来。你在界面里填写的服务名称、*ase **L、Model ID 和 API Key，本质上都是为了让本地 Codex 请求指向正确的接口。
因此，接入时不要把界面和配置文件割裂开看。界面用于创建、切换和维护线路；字段规则用于判断请求是否正确；终端重启用于让新配置真正被 Codex 读取。三者连起来，接入流程才完整。
- 界面层：CC Switch 负责保存和启用配置卡。
- 字段层：*ase **L、Model ID、API Key 决定请求是否成功。
- 终端层：新会话读取当前启用线路。
- 验证层：最小提示词确认链路是否可用。
第一步：从灵能API准备三类服务信息
接入前先打开灵能API入口，准备三类信息：接口地址、模型 ID、API Key。不要直接复制旧教程里的字段，也不要用别人截图里的示例值。入口：https://www.lnsns.com/
如果你之前已经接通过一次，也建议重新确认灵能API页面。模型、额度、接口说明都有可能更新，旧笔记只能作为参考。
- 接口地址：确认当前推荐的 *ase **L。
- 模型 ID：从当前模型列表复制。
- API Key：从自己的账户创建。
- 账户状态：确认额度和权限可以完成测试。
第二步：API Key 只负责鉴权，不负责修复地址错误
很多新手遇到报错就反复换 Key，但 Key 只负责鉴权。*ase **L 错、Model ID 错、终端没重开，都不是换 Key 能解决的。正确做法是先判断错误类型，再决定改哪个字段。
401：优先检查 API Key
404：优先检查 *ase **L 和 Model ID
timeout：优先检查网络、终端会话和任务体量
429：优先检查用量、频率和并发把 Key 的职责说清楚，能避免很多无效操作。灵能API提供凭证和模型入口，CC Switch负责把这些信息写进本地线路。
- Key 要使用 Codex 专用凭证。
- 排错记录不要保存完整 Key。
- Key 泄露后直接撤销，不继续使用。
第三步：在 CC Switch 建立配置卡
打开 CC Switch，新建一张配置卡。卡片名称建议写成“灵能API-Codex-Config”，让它明显区别于排错卡、备用模型卡或项目专用卡。
第一次接入时，不建议同时创建多张相似配置。先让一张卡跑通，再扩展备用模型、项目卡和排错卡。
- 名称：灵能API-Codex-Config。
- 用途：学习字段对照和首次接入。
- 模型：先选择稳定模型，方便验证。
- 备注：记录创建日期和适用场景。
**步：把字段和含义逐项对上
接入中最重要的不是记住某个截图位置，而是理解每个字段的含义。服务名称方便识别，*ase **L 决定请求入口，Model ID 决定模型，API Key 决定身份。
服务名称：灵能API-Codex-Config
*ase **L：https://www.lnsns.com/v1
Model ID：从灵能API当前模型列表复制
API Key：自己的 Codex 专用 Key字段填完后先保存，不要急着跑真实项目。接下来要确认配置卡已启用，并让新终端读取它。
- 服务名称写错不会导致请求失败，但会导致排错混乱。
- *ase **L 写错最容易触发 404 或连接失败。
- Model ID 写错容易触发 model not found。
- API Key 写错通常触发 401。
⚙️ 第五步：保存启用后再看终端是否生效
保存配置不等于生效，启用配置也不等于旧终端已经读取。推荐流程是：保存配置卡，确认启用，关闭旧终端，打开新终端，再启动 Codex 做最小测试。
codex --version
codex如果你刚刚切换过模型或配置卡，重开终端尤其重要。很多“配置明明改了却不生效”的问题，都卡在这一步。
- 版本命令先确认本地工具可用。
- 新终端启动 Codex，避免旧会话干扰。
- 不要在多个终端窗口里混合测试。
第六步：用固定提示词验证字段是否正确
首次验证只需要一个短提示词，不需要读取项目文件，也不需要让 Codex 执行命令。目标是确认灵能API线路、CC Switch 字段和终端状态已经连通。
New-Item -ItemType Directory codex-config-check
Set-Location codex-config-check
codex请只返回：配置字段验证通过如果能返回固定文本，说明基础字段基本正确。如果失败，就根据错误码回到对应字段排查，不要一次性重填全部内容。
第七步：配置文件思维怎么帮助排错
即使你主要使用 CC Switch，也要具备配置文件思维：每张卡最终都可以理解成一组字段组合。排错时不要只看界面有没有保存，而要问：当前 Codex 到底读取的是哪组字段？
排错记录建议：
当前卡片：灵能API-Codex-Config
*ase **L：https://www.lnsns.com/v1
模型：当前 Model ID
错误码：404
操作：已重开终端，已使用固定提示词复测这样写排错记录，比一句“不能用”更有效。你可以清楚看到问题可能属于地址、模型、Key、终端还是任务本身。
- 记录卡片名称，避免误查旧卡。
- 记录 *ase **L 和模型，但不记录完整 Key。
- 记录是否重开终端，方便判断生效问题。
第八步：真实项目只读验证字段链路
空目录验证通过后，可以进入真实项目，但第一轮仍然建议只读。让 Codex 读取指定目录并输出计划，用来确认配置链路在真实项目中也稳定。
请只读分析当前项目，不要修改文件。
允许读取：README.md、src、tests
禁止读取：.env、密钥文件、生产配置
输出：项目结构、建议检查文件、下一步计划只读阶段成功后，再允许小范围修改。这样可以把接口接入问题和项目任务问题分开，避免排错时混在一起。
常见字段错误速查
字段排错的原则很简单：一次只改一个字段，改完重开终端，用同一个固定提示词复测。这样才能知道是哪一步真正解决了问题。
- *ase **L 多写 /v1：检查是否变成 /v1/v1。
- *ase **L 写完整路径：不要把 chat/completions 当基础地址。
- 模型 ID 写展示名：从灵能API模型列表复制接口 ID。
- Key 粘贴带空格：重新复制并检查首尾。
- 配置卡未启用：确认 CC Switch 当前启用状态。
- 终端未重开：关闭旧会话，用新终端测试。
✅ 最后一份字段对照接入清单
理解字段对照之后，Codex 中转 API 接入会从“照着截图填”变成“知道每个字段为什么存在”。灵能API提供服务入口，CC Switch管理本地配置，而字段对照和生效验证负责让整条链路清楚可控。
- 灵能API入口、账户、模型和额度已确认。
- API Key 已单独为 Codex 准备并安全保存。
- CC Switch 配置卡已创建，名称和用途清楚。
- *ase **L、Model ID、API Key 含义已对照清楚。
- 配置卡已保存、启用，并重新打开终端。
- 空目录固定提示词验证通过。
- 排错记录不包含完整 Key。
- 真实项目先做只读验证，再执行修改。
