为什么要用中转方式接入 Codex

Codex 本身更像一个执行任务的客户端，真正决定它使用哪种模型的，是你提供的账户或 API 配置。对于希望按量使用模型、需要在多个模型之间切换，或者不想频繁修改本地配置文件的用户，中转站配合 CC Switch 是一条相对清晰的管理路径。

它的价值不在于把所有模型都堆进来，而在于把入口、密钥、模型和切换动作集中管理。配置完成后，可以按任务选择线路；遇到某条线路异常，也可以切换到备用配置进行对照。

需要先说明的是：不同服务商的页面字段和模型名称可能不同，本文的具体地址和品牌信息以灵能API当前页面为准。

• 配置集中：API 地址、令牌和模型可以在一张卡片中管理。
• 模型可选：根据任务需要选择不同能力和成本的模型。
• 便于切换：不用反复手动编辑多个本地配置文件。
• 排错清晰：可以保留主线路和备用线路进行对照。

开始前准备：只需要两类工具和三项参数

接入前先准备本地客户端和服务参数。建议使用新的 PowerShell 窗口，避免旧环境变量或旧进程干扰第一次测试。

node -v
npm -v
npm install -g @openai/codex
codex --version

如果 node、npm 或 codex 无法识别，先解决本地安装和 PATH 问题。工具链通过后再创建令牌，可以避免把软件安装错误误判成 API 请求错误。

• 本地工具：Node.js、npm、Codex 和 CC Switch。
• 服务参数：API Key、*ase **L、Model ID。
• 安全准备：一个只读测试目录，以及保存密钥的**位置。

第一步：先看灵能API的模型信息

进入灵能API公开页面或控制台后，先查看当前模型列表、模型接口 ID 和计费说明。模型页面的展示名是给人看的，CC Switch 最终需要的是服务端能够识别的 Model ID。不要直接照抄旧教程里的固定模型名称。

阅读模型信息时，至少记录三项：模型名称、输入价格、输出价格。输入通常包括你的问题、项目上下文和代码；输出则是模型生成的回答、代码或修改建议。长任务往往同时消耗大量输入和输出，因此不能只看其中一项价格。

• 官网入口：https://www.lnsns.com/
• 模型 ID：从当前列表复制，不凭记忆输入。
• 价格单位：确认是按 1M Tokens、余额或其他单位展示。

第二步：创建一枚专门用于 Codex 的令牌

在控制台创建令牌时，名称只要能识别用途即可，例如 Codex-Windows 或 Codex-Project-****。不要把多个应用的密钥混在一起，专用令牌便于查看调用、控制风险和后续撤销。

如果页面提供分组、渠道或模型范围选项，先理解它们的含义，再提交。分组通常影响可用模型、路由范围或计费折算；它不是简单的备注字段。Codex 使用哪一组，应以控制台当天的说明和可用模型列表为准。

令牌生成后通常只完整显示一次。复制时不要粘贴到公开文档，也不要把完整密钥发给他人。若复制失败或怀疑泄露，直接撤销并生成新令牌，不要继续使用不确定的旧密钥。

• 名称：写清客户端、设备或用途。
• 分组：选择与 Codex 和目标模型匹配的分组。
• 权限：只开启完成任务所需的范围。

第三步：看懂折扣、输入输出和倍率

模型价格页面常见折扣、输入、输出和倍率几个概念。它们可能来自不同的计费层，不能简单地把一个数字当成最终成本。比较模型时，先确认单位和计算方式，再判断是否适合自己的任务。

Token 可以粗略理解为模型处理文本时使用的计量单位。中文、英文、代码、标点和空格的占用方式并不完全相同，所以不要用字数直接等同于 Token。项目级任务往往同时包含大量输入上下文和输出代码，实际消耗会比一句短问答高。

更稳妥的选择方式是：先用低风险、短文本测试模型，再根据任务长度和回答质量决定是否切换到更强模型。不要为了追求最低单价，忽略上下文、稳定性和返回质量。

• 折扣：表示相对某个基准价格的折算比例，不等于最终余额扣除额。
• 输入价格：处理提示词、上下文、代码和问题的费用。
• 输出价格：处理模型生成内容的费用，长回答通常更明显。
• 倍率：平台内部对模型、输出或分组进行换算的参数。

️ **步：在 CC Switch 中新建 Codex 配置

打开 CC Switch，进入 Codex 菜单并点击新增渠道或自定义供应商。CC Switch 的主要作用是保存和切换配置，因此可以同时保留多个线路。配置名称建议包含灵能API、Codex 和用途，方便之后确认当前启用的卡片。

新增时先填写服务名称和备注，再处理请求字段。服务名称本身不会改变接口，但清晰的命名可以降低切换错误。建议保留原有已知可用配置，测试新渠道失败时可以立即切回。

• 供应商名称：灵能API-Codex-主线路。
• 备注：Windows / Codex / 日常开发。
• 官网链接：https://www.lnsns.com/

✍️ 第五步：填写 API 地址、密钥和模型

进入详细字段后，按照‘地址—模型—密钥’的顺序填写。地址先确认路径层级，模型再核对接口 ID，最后粘贴令牌。这样出现 404 或 model not found 时，可以先排除格式问题，再检查鉴权。

供应商名称：灵能API-Codex-主线路
API Key：粘贴刚刚创建的专用令牌
API 请求地址：https://www.lnsns.com/v1
模型名称：以灵能API当前模型列表为准

*ase **L 通常填写到 /v1，不要把官网地址当成 API 地址，也不要把完整的接口路径重复拼进去。最常见的地址错误是 /v1/v1、少写版本路径，或者把不属于当前服务的域名粘贴进来。

如果 CC Switch 提供获取模型列表按钮，可以先保存地址和 Key，再执行获取。能够拉到模型列表，说明地址、密钥和基础协议至少已经形成了初步闭环；但最终仍要通过 Codex 实际启动验证。

第六步：选择模型、保存并启用渠道

获取模型列表后，从当前可用列表中选择一个适合测试的模型。首次接入建议选择响应快、任务范围适中的模型，不要一上来就用最长上下文或最复杂的模型。选择后点击添加或保存，并确认这张卡片已经出现在 Codex 渠道列表。

注意：新建配置通常不会自动成为当前线路。保存后还要点击启用、切换或设为当前配置。界面上应能看到选中状态或启用标记。若没有启用，Codex 仍会继续使用旧渠道。

• 模型列表能加载：地址、Key 和基础连接大概率正确。
• 模型已添加：说明配置卡保存完成。
• 卡片已启用：说明下一次新进程可以读取它。

✅ 第七步：重启 Codex 并***低风险验证

切换渠道后必须关闭旧的 Codex 和 PowerShell 窗口，再重新打开。旧进程可能仍然持有之前的环境变量或配置状态，只在 CC Switch 中点击切换而不重启，容易造成‘页面显示新线路，实际请求走旧线路’。

mkdir codex-relay-check
cd codex-relay-check
codex

进入 Codex 后，先发一条只读指令：请确认当前目录是否为空，并说明如果这里是一个代码项目，你会先检查哪些内容，不要创建、删除或修改文件。这个任务可以验证命令启动、身份认证、模型返回和工作目录。

如果空目录测试成功，再进入真实项目读取一个指定文件。确认返回稳定后，才允许它提出或执行小范围修改。第一次接入不建议直接运行批量重构、删除文件或长时间自动任务。

常见问题：按错误码定位，不要反复重装

排错时记录错误码、卡片名称、模型 ID 和时间，不要记录完整 API Key。一次只修改一个字段，才能判断哪项变化解决了问题。

• 401：检查令牌是否完整、是否被撤销，以及当前启用的卡片是否正确。
• 403：检查账户额度、分组权限、模型权限或访问策略。
• 404：检查 API 请求地址，尤其确认没有重复 /v1。
• model not found：回到模型列表重新复制精确 Model ID。
• 模型列表获取失败：检查地址、Key、网络和客户端协议选项。
• 切换后没有变化：关闭旧终端和 Codex 进程，启用卡片后重新打开。
• 请求超时：先缩短任务，减少上下文，再检查网络、**和服务状态。

安全收尾：让这套配置可以长期使用

令牌能用不等于可以随意传播。建议为不同设备或用途创建独立令牌，把完整 Key 保存在密码管理器中。需要分享教程或截图时，只展示字段位置，不展示真实密钥、账号信息和完整请求头。

需要查看当前模型、令牌和服务信息时，通过可点击的灵能API官网入口进入：https://www.lnsns.com/。实际页面说明优先于旧截图和旧文章。

• 主线路、测试线路和备用线路分别命名。
• 更换令牌时先创建新 Key 并验证，再撤销旧 Key。
• 模型或客户端升级后重新***空目录测试。
• 不要把含密钥的配置文件提交到 Git 或公开网盘。

最终清单：五分钟完成一次自检

当这份清单全部通过时，中转接入就从一次性的复制配置，变成了一套可以复查、切换和维护的工作流程。

• Node.js、npm 和 Codex 命令可用。
• 令牌由自己的控制台创建，且没有出现在公开内容中。
• 分组或渠道与 Codex 和目标模型匹配。
• *ase **L 和 Model ID 来自当前服务列表。
• CC Switch 渠道已保存并启用。
• 旧 Codex 已关闭，新终端完成只读验证。
• 真实项目首次只读取局部文件，修改前已确认回退方式。