先确认一次完整接入包含哪些环节
完整接入不是把一个地址粘贴进软件就结束，而是要依次确认服务入口、令牌、模型、配置卡和新启动的 Codex 进程。任何一环没有更新，都可能出现配置保存了但请求仍然失败的情况。
第一次排错时建议只使用一张基础卡片和一个测试模型，等请求闭环后再增加实验线路。一次同时改地址、模型和令牌，会让错误来源难以判断。
- 服务层：确认当前模型、接口地址和令牌入口。
- 工具层：确认 Node.js、npm、Codex 和 CC Switch 可用。
- 配置层：确认 *ase **L、Model ID 和 API Key 匹配。
- 运行层：保存并启用配置后，重新启动 Codex。
第一步：准备当前服务参数
打开灵能API公开页面或控制台，先确认当天可用模型和接口说明。模型展示名称不一定等于接口 Model ID，配置时应从当前列表复制精确字符串。
建议为 Codex 单独创建一枚令牌，名称写清设备和用途。完整令牌只保存在本地私密位置，不放进截图、文章、日志或代码仓库。
如果页面同时显示模型名称、接口 ID 和计费信息，配置时优先记录接口 ID。后续遇到模型错误，可以直接回到这份记录与当前列表逐字符对比。
- 官网入口：https://www.lnsns.com/
- *ase **L：以当前接口说明为准，通常包含版本路径。
- Model ID：从当前模型列表复制。
️ 第二步：检查本地环境
node -v
npm -v
where.exe node
where.exe npm
npm install -g @openai/codex
codex --version每条命令单独执行。若命令无法识别，先处理 Node.js、npm 或 PATH，不要直接进入 API 排错。版本命令都有输出后，再打开 CC Switch。
Windows 上重新打开 PowerShell 很重要，因为新安装的软件和 PATH 变化不一定会被已经打开的终端读取。确认工具层通过后，再开始配置远程服务。
️ 第三步：在 CC Switch 创建渠道
进入 Codex 配置页面，新增自定义供应商。名称建议写成“灵能API-Codex-主线路”，备注说明设备和用途。保留一张已知可用的旧卡片，便于测试失败时回退。
建议把主线路、测试线路和备用线路分别命名。即使它们使用同一个服务入口，也要让用途和模型角色在卡片名称中可见。
- 名称只用于管理，但必须能区分主线路和实验线路。
- 复制卡片后仍要重新核对模型和密钥。
✍️ **步：填写三项核心请求参数
服务名称：灵能API-Codex-主线路
*ase **L：https://www.lnsns.com/v1
Model ID：以当前模型列表为准
API Key：自己的专用令牌*ase **L 通常填写到 /v1，不要填官网首页，也不要重复写成 /v1/v1。出现 404 先查地址，出现 model not found 先查模型，出现 401 再查令牌。
填写顺序建议是先地址、再模型、最后密钥。这样可以先发现路径层级和字符串格式问题，再处理敏感字段，排错记录也更容易脱敏。
✅ 第五步：获取模型、启用渠道并验证
保存地址和令牌后，如果 CC Switch 提供获取模型列表功能，可以先执行获取。选择一个适合短任务的模型，点击添加并启用当前渠道。
启用后关闭旧的 Codex 和 PowerShell，重新打开终端，在空目录执行 codex。第一条任务只确认目录状态，不创建、删除或修改文件。测试成功后再进入真实项目。
如果空目录测试通过而真实项目失败，优先检查项目规模、环境变量和上下文长度；如果空目录也失败，回到当前卡片、令牌和地址检查。
常见错误与回退顺序
排错时只修改一个变量。恢复顺序是先切回已知可用卡片，再做空目录测试，最后才考虑重新安装。
- 401：检查令牌、当前启用卡片和密钥首尾空格。
- 403：检查额度、分组和模型权限。
- 404：检查 *ase **L 是否重复 /v1。
- model not found：重新复制当前 Model ID。
- 切换不生效：关闭旧进程后重新启动。