先了解这套接入方式
Codex 是客户端，CC Switch 是配置切换工具，灵能API提供模型接口。三者分工不同：灵能API负责接收请求并返回模型结果，CC Switch 保存和切换线路，Codex 则负责在项目或对话中发起任务。
理解这三个角色后，遇到问题就能判断应该检查服务、配置卡还是客户端进程，而不是反复重填所有字段。
- 灵能API：提供 *ase **L、模型和令牌。
- CC Switch：管理多条配置，减少手工修改。
- Codex：读取当前启用线路并执行开发任务。
开始前需要准备什么
正式配置前，先准备好 Codex、CC Switch 和一个用于测试的空目录。Codex 与 CC Switch 的菜单名称可能随版本变化，但整体流程通常是：安装客户端、创建 API 令牌、添加渠道、获取模型、启用渠道、重启 Codex。
首次接入建议先使用较小额度进行验证，确认地址、模型、权限和客户端流程都正常后，再用于长任务。
- Codex 已安装并可以启动。
- CC Switch 已安装，并能打开 Codex 配置页面。
- 已准备灵能API账户和可用额度。
- 准备一个不含敏感代码的空目录做首次测试。
第一步：确认灵能API的接口信息
打开灵能API服务入口，查看当前可用模型、接口说明和令牌管理入口。不同模型的标识和权限可能不同，不建议使用旧教程中的地址或手动猜测 Model ID。
灵能API官网入口：https://www.lnsns.com/。本文示例不会展示真实令牌，也不会把令牌写入项目文件。
- *ase **L：从当前接口说明复制。
- Model ID：从当前模型列表复制精确标识。
- API Key：创建后只在安全位置查看和保存。
第二步：创建专用 API 令牌
在令牌管理页面创建一枚用于 Codex 的令牌。名称建议写成‘codex-local’或‘project-a-codex’，方便后续识别。不要把邮箱、密码或完整 Key 写进名称，也不要把同一枚高权限令牌长期分发给所有设备。
创建完成后，复制令牌并立即保存到本机安全位置。若页面只显示一次，关闭页面后不要尝试从聊天记录或截图中找回。
- 令牌名称：写用途和设备，不写秘密内容。
- 令牌分组：选择明确支持 Codex 的分组，或按照当前说明选择。
- 权限范围：只授予当前任务需要的模型和额度。
- 有效期：临时测试尽量使用可撤销或短周期令牌。
第三步：看懂模型、Token 和倍率
中转服务的模型页面通常会同时展示输入价格、输出价格和分组倍率。输入是你发送给模型的提示词、代码和上下文；输出是模型生成的回答。Token 可以理解为模型计量文本和代码的一种单位，中文、英文、符号和代码的拆分方式并不完全相同。
比较价格时不要只看一个折扣数字，还要确认输入、输出、上下文和分组的具体规则。长代码任务通常会同时产生较多输入和输出消耗。
- 输入价格：发送内容所消耗的计费单位。
- 输出价格：模型生成内容所消耗的计费单位。
- 倍率：服务对不同模型或渠道进行换算的规则。
- 分组：可能对应不同权限、价格和调用范围。
️ **步：在 CC Switch 创建 Codex 渠道
打开 CC Switch，进入 Codex 菜单，点击新增渠道或加号。供应商名称可以写‘灵能API-Codex’，这样以后和其他模型线路并存时更容易识别。
不要把完整 Key 写进截图、文章或公共配置文件。配置卡用于本机调用，分享时只分享字段结构。
- 供应商名称：写清品牌和用途。
- API Key：粘贴刚刚创建的令牌，检查前后空格。
- API 请求地址：填写当前说明中的 *ase **L。
- 其他字段：没有明确要求时先使用默认值。
第五步：获取模型并保存渠道
填写地址和 Key 后，点击获取模型列表或类似按钮。如果能成功返回模型，通常说明地址和基本鉴权已经通过；如果获取失败，先检查 *ase **L、Key 和当前分组，不要立即更换多个字段。
模型列表返回后，只选择当前任务需要的模型，并保存渠道。先不要批量添加所有模型，减少后续选择和排错的复杂度。
- 列表为空：确认接口地址和分组是否匹配。
- 401：重新检查令牌是否复制完整。
- 404：检查是否重复填写版本路径。
- 模型不存在：从当前列表重新选择 Model ID。
第六步：启用渠道并重启 Codex
新渠道保存后，通常还需要手动启用或切换。很多新手以为点击保存就已经生效，实际上 Codex 进程可能仍在使用切换前的配置。正确顺序是：启用渠道、关闭旧 Codex、重新打开 Codex。
1. 在 CC Switch 中启用灵能API-Codex
2. 关闭已经打开的 Codex 窗口和终端进程
3. 重新启动 Codex
4. 进入空目录发送只读测试如果切换后仍然返回旧模型，优先怀疑旧进程、环境变量或重复配置，而不是马上重新创建令牌。
第七步：用最小任务完成首次验证
首次验证不要直接让 Codex 修改真实项目。创建一个空目录，让它只执行目录确认、短文本解释或简单只读任务。这样可以同时验证线路、模型、权限和客户端是否真正完成切换。
New-Item -ItemType Directory codex-first-check
Set-Location codex-first-check
codex启动后可以输入：‘请确认当前工作目录，并用三句话说明你能做什么，不要修改任何文件。’如果能稳定返回，再进入真实项目。
️ 第八步：进入真实项目时分阶段操作
首次接入成功后，也不要直接进行大型改造。先让 Codex 读取项目结构和关键说明，再让它提出计划；确认计划后才执行局部修改；最后运行项目已有的测试命令。
把线路接入和项目变更分开验证，出现问题时才知道是配置问题还是代码问题。
- 阶段一：确认目录、分支和项目说明。
- 阶段二：读取与任务相关的文件。
- 阶段三：输出修改计划和风险点。
- 阶段四：只修改明确允许的文件。
- 阶段五：运行局部测试并检查 diff。
常见问题和处理顺序
排错时一次只修改一个变量，记录错误码、配置卡名称和测试时间，不要把完整令牌发给他人协助排查。
- 无法获取模型：检查地址、Key、分组和网络。
- 401：检查令牌是否完整、有效并被当前卡片使用。
- 403：检查模型权限、余额、额度和分组。
- 404：检查 *ase **L 是否重复拼接路径。
- 切换后仍是旧配置：关闭旧进程并重新启动。
- 长任务超时：缩小上下文，分阶段执行并减少并发。
✅ 接入完成后的检查清单
完成这些步骤后，灵能API就可以作为 Codex 的一条稳定线路使用。后续需要切换其他模型时，复制配置卡并单独验证即可，不必反复破坏当前可用配置。
- Codex 和 CC Switch 已安装并能启动。
- 灵能API令牌已创建并安全保存。
- *ase **L 和 Model ID 来自当前接口说明。
- CC Switch 渠道已保存并明确启用。
- 切换后已经重启 Codex。
- 空目录最小测试通过。
- 真实项目先只读，再计划，再修改和测试。