Codex 中转站零基础实战教程：灵能API CC Switch 从安装检查到项目运行
第一次把 Codex 接入中转线路时，很多人能完成字段填写，却不知道接下来如何安全进入真实项目。本文不只讲配置，还把首次启动、只读确认、项目分析、局部修改、测试和退出整理成连续步骤，让没有经验的用户也能从空目录逐步走到可控的项目任务。
先理解：接入成功只是起点
Codex 接入 API 后，并不会自动知道你的项目规则，也不会自动判断哪些文件可以修改。灵能API负责模型请求，CC Switch负责线路管理，Codex负责在当前目录里执行工作。真正安全的使用方式，是把‘线路测试’和‘项目操作’分成两个阶段。
只要顺序不跳步，出现问题时就能迅速判断是配置错误还是项目本身的问题。
- 先在空目录验证线路。
- 再在项目中确认目录和权限。
- 最后才执行局部修改和测试。
第一步：检查本机工具是否齐全
开始之前，确认 Codex 能启动、CC Switch 能打开，并检查项目常用的运行时。即使暂时不运行代码，也建议知道当前 Node.js、npm、Python 或 Git 是否可用。
codex --version
node -v
npm -v
python --version
git --version- 命令不存在：先修复本机环境，不要急着配置 API。
- 版本不符合项目要求：读取项目文档和版本文件。
- 工具版本未知：不要直接升级全部依赖。
第二步：从灵能API获取当前接口信息
打开灵能API服务入口，先确认当前可用模型、*ase **L 和令牌入口。版本变化后，旧笔记里的地址和模型名可能不再适用，所以所有关键字段都应以当前说明为准。
灵能API入口：https://www.lnsns.com/。不要在文章、截图或项目仓库中放置完整令牌。
- *ase **L：从接口说明复制。
- Model ID：从当前列表复制，不凭记忆填写。
- API Key：创建后只在本机安全字段中使用。
第三步：创建一枚用于测试的令牌
首次接入建议使用单独的测试令牌，而不是直接拿长期主令牌做实验。令牌名称可以写‘codex-first-test’，分组和权限按照当前服务说明选择。测试通过后，再决定是否创建用于日常开发的独立令牌。
创建后把 Key 粘贴到受控位置，不要通过截图或聊天记录传递完整内容。
- 测试令牌与日常开发令牌分开。
- 只授予当前需要的模型和额度。
- 令牌可能暴露时立即撤销并重新生成。
️ **步：在 CC Switch 添加渠道
打开 CC Switch，进入 Codex 配置页面，点击新增渠道。供应商名称建议写成‘灵能API-Codex-首次测试’，这样测试卡和长期使用卡可以清楚区分。
保存之前逐项核对地址、令牌和用途是否一致。不要为了测试同时修改多个高级选项。
- API Key：粘贴测试令牌并检查空格。
- API 请求地址：填写当前 *ase **L。
- 高级参数：没有明确要求时先保持默认。
第五步：获取模型并完成字段复核
点击获取模型列表。如果列表可以返回，说明基本的地址和鉴权已经打通。接下来选择一个当前任务需要的模型，保存渠道。列表获取失败时，优先核对 *ase **L、Key、分组和网络，不要立即重新安装 Codex。
- 401：检查 Key 是否完整、有效。
- 403：检查权限、额度和分组。
- 404：检查路径是否重复拼接。
- 模型不存在：重新复制当前 Model ID。
第六步：启用渠道并重启客户端
保存渠道后，还要点击启用或切换。接着关闭旧 Codex 进程并重新打开。配置切换后不重启，是最常见的‘明明填写正确却还是失败’原因之一。
启用：灵能API-Codex-首次测试
停止：旧 Codex 窗口和终端进程
启动：重新打开 Codex
验证：空目录只读请求如果重启后仍然使用旧配置，检查是否有环境变量、项目配置或另一个 CC Switch 卡片覆盖了当前值。
第七步：空目录完成三项验证
首次启动先不要进入正式项目。创建空目录后，依次验证工作目录、模型回复和只读文件读取。每一步都得到正常结果，再进入下一步。
New-Item -ItemType Directory codex-on*oarding-check
Set-Location codex-on*oarding-check
codex可以输入：‘请确认当前工作目录，并说明你不会修改任何文件。’这类请求足够验证线路，又不会产生项目变更。
- 测试一：确认当前目录。
- 测试二：回答一个固定的短问题。
- 测试三：只读测试目录中的无敏感文件。
第八步：进入真实项目先做只读检查
进入项目根目录后，第一条指令仍然不要修改代码。先让 Codex 确认目录、读取 README 和依赖文件，并说明项目的启动命令。这样可以确认它没有读错项目，也没有把测试目录的上下文带进来。
请确认当前工作目录和项目名称。
只读取 README.md、package.json 和项目配置。
不要修改任何文件。
说明项目的启动和测试命令。- 检查 Git 状态，保护已有未提交修改。
- 限制读取范围，排除依赖和构建目录。
- 先看项目规则，再提出下一步任务。
️ 第九步：第一次修改采用小范围任务
验证读取正常后，选择一个低风险、范围明确的任务，例如补充一个测试、修复一个提示文案或解释一个函数。要求 Codex 先给出计划，确认后只修改指定文件。
只处理 src/utils/**te.ts 的一个格式化问题。
先说明原因和修改计划。
不要修改其他文件，不要升级依赖。
完成后展示 diff，并运行对应测试。- 修改前：确认工作区已有变更。
- 修改中：限制文件和任务范围。
- 修改后：查看 diff 和测试结果。
第十步：用错误码快速定位问题
接入过程中最常见的错误并不需要全部重装。先记录错误码和当前卡片名称，再按顺序检查字段、权限、进程和网络。
一次只调整一个变量，才能知道哪个动作解决了问题。
- 401：令牌未被接受，核对复制内容和有效状态。
- 403：请求被拒绝，检查权限、额度和模型分组。
- 404：地址或 Model ID 不匹配。
- 超时：缩小上下文，检查网络和客户端**。
- 切换不生效：关闭旧进程并重新启动。
✅ 第十一步：完成接入后的安全收尾
这样做完后，灵能API接入 Codex 就不只是一次成功的试运行，而是一套可以重复使用、出错可恢复的工作流程。
- 测试令牌是否需要保留，决定后及时禁用。
- 配置卡名称是否清晰，是否能区分项目和环境。
- 项目 .env 是否被 Git 忽略。
- 截图、日志和文档中没有完整 API Key。
- 保留一张已验证的稳定配置作为回滚点。