Codex 连接灵能API教程：cc-switch 配置中转站与 GPT-5.6 的实战流程

分类：军事历史

作者：佚名

主角：

来源：灵能API

更新时间： 2026-08-03 17:07:04

开始阅读阅读更多

精彩片段

Codex 连接灵能API教程：cc-switch 配置中转站与 GPT-5.6 的实战流程如果你希望让 Codex 通过中转站稳定调用模型，真正需要掌握的不是复制一段配置，而是弄清楚账号、API Key、Base URL、模型 ID、cc-switch 当前启用状态和终端缓存之间的关系。本篇以灵能API为示例，从准备工作开始，一步步完成配置、验证、切换与

Codex 连接灵能API教程：cc-switch 配置中转站与 GPT-5.6 的实战流程

如果你希望让 Codex 通过中转站稳定调用模型，真正需要掌握的不是复制一段配置，而是弄清楚账号、API Key、*ase **L、模型 ID、cc-switch 当前启用状态和终端缓存之间的关系。本篇以灵能API为示例，从准备工作开始，一步步完成配置、验证、切换与排错。

发布日期：2026-08-03

一、先明确目标：让 Codex 只认一条**证的线路

本教程要完成的结果是：在 Windows 电脑上安装 Codex，通过 cc-switch 新增一条灵能API配置，填入自己的 API Key、接口地址和可用模型，然后在全新终端中完成一次只读请求。只有这条最小链路跑通后，才建议继续增加备用模型、多个项目配置或自动化脚本。

可以把整条请求链路理解成五个节点：Codex 负责发起任务；本地配置负责告诉它访问哪里；cc-switch 负责保存和启用线路；灵能API负责接收鉴权并转发请求；模型服务负责返回结果。任何一个节点出错，终端里的表现都会不同，所以要按节点排查，而不是反复重装。

安装失败：优先检查 Node.js、npm 和 PATH。
鉴权失败：优先检查灵能API API Key、账户权限和启用状态。
模型不存在：优先检查控制台显示的精确模型 ID。
改完不生效：优先关闭旧终端和旧 Codex 进程。

二、在灵能API控制台准备账户和 API Key

先打开灵能API官网：https://www.lnsns.com/，登录账户并进入控制台。第一次配置建议单独创建一枚“Codex 专用” API Key，这样后续查看用量、撤销权限或更换线路时，不会影响其他项目。官网入口是 https://www.lnsns.com/，如果你已经登录，也可以直接从控制台的密钥管理页面继续。

接下来还要在灵能API**确认可用模型。教程标题使用 GPT-5.6 作为示例，但具体账户能否调用、控制台实际展示什么名称，必须以灵能API当前模型列表为准。模型名称多一个字符、少一个连字符，都可能返回 model not found。

进入灵能API控制台并完成登录。
找到 API Key、密钥管理或令牌管理入口。
创建一枚用途明确的密钥，例如 Codex-Windows。
复制密钥后立即保存到密码管理器，不要发布到文章、截图或 Git 仓库。

三、检查 Windows 环境：先验证工具，再验证接口

在 PowerShell 中执行以下命令。每条命令都有返回结果后再进入下一步，可以避免把本地安装问题误判为灵能API接口问题。

node -v
npm -v
where.exe node
where.exe npm

如果前两条没有版本号，先安装 Node.js LTS；如果有版本号但 where.exe 找不到路径，关闭当前 PowerShell 后重新打开。npm 的下载源只影响 Codex 安装包下载，不会改变灵能API请求地址。需要时可以执行：

npm config set registry https://registry.npmmirror.com
npm config get registry

完成环境检查后，安装 Codex 并确认命令已进入 PATH。

npm install -g @openai/codex
codex --version
codex --help

四、理解 cc-switch：它管理的是“当前启用配置”

cc-switch 的核心作用是集中管理多套供应商配置，并把其中一套写入 Codex 当前会读取的位置。保存一张卡片，不代表 Codex 已经开始使用；你还需要启用这张卡片，并重启读取旧配置的终端。

cc-switch Codex 配置页截图 — 图 1：先切换到 Codex 页面，再点击添加配置按钮。

打开 cc-switch 后，先进入 Codex 对应页面。不要在 Claude 或其他工具的页面中新增配置，因为不同工具的字段结构和配置文件可能不一样。进入 Codex 页面后，再点击添加配置或新增供应商。

五、新增灵能API配置：先命名，再填连接信息

在 cc-switch 的 Codex 页面选择“自定义配置”。供应商名称可以填写“灵能API-Codex”，备注可以写“GPT-5.6 主线路”或项目名称。命名的目的不是影响请求，而是让你以后切换时一眼知道哪张卡片对应灵能API。

cc-switch 自定义配置入口截图 — 图 2：新增供应商时选择自定义配置，便于填写灵能API的连接信息。

供应商名称：灵能API-Codex。
备注：写明用途，例如 Windows Codex 主线路。
官网链接：填写 https://www.lnsns.com/，用于本机识别和回到控制台。
API Key：粘贴从灵能API控制台创建的完整密钥。
API 请求地址：填写 https://www.lnsns.com/v1，注意不要重复追加 /v1。
模型名称：填写灵能API模型列表中的精确模型 ID。

六、四个字段的常见误填方式

第一个高频错误是把灵能API官网地址和 API 请求地址混用。官网地址 https://www.lnsns.com/ 用于进入控制台；请求地址 https://www.lnsns.com/v1 用于程序发送兼容接口请求。两者相关，但作用不同。

第二个错误是复制 API Key 时带入了空格或换行。建议在粘贴后用键盘方向键检查首尾，不要自行给密钥加引号。第三个错误是模型名称凭记忆输入，正确做法是回到灵能API模型列表复制。**个错误是接口地址重复写成 https://www.lnsns.com/v1/v1，这通常会造成 404。

官网地址： https://www.lnsns.com/
API 请求地址： https://www.lnsns.com/v1
模型名称：以灵能API控制台显示的实际 model ID 为准
API Key：使用自己的密钥，不要使用示例值

如果 cc-switch 提供获取模型列表或管理与测速按钮，可以先填 API Key 和请求地址，再执行一次轻量测试。获取模型列表成功后，再把准确的模型 ID 写入模型名称，通常比直接猜名称更稳。

七、保存、启用、重启：三个动作缺一不可

点击添加或保存后，先确认灵能API-Codex卡片已经出现在 Codex 配置列表中。然后点击启用，使它成为当前线路。最后关闭旧的 Codex 进程和 PowerShell，重新打开终端。Codex 通常在启动时读取配置，旧终端不会因为 cc-switch 状态变化而自动刷新。

cc-switch 供应商字段填写截图 — 图 3：重点核对 API Key、请求地址和模型名称，示例内容不能直接替代自己的账户信息。

建议按这个顺序操作：保存灵能API配置 → 启用灵能API卡片 → 完全退出旧终端 → 新开 PowerShell → 在小目录启动 Codex。不要在旧终端中连续重试，因为那样很可能一直使用旧的 auth.json 或 config.toml。

八、先测短请求，再进入真实项目

如果 cc-switch 内置测试返回成功，说明当前卡片至少能够完成一次基础请求。接下来新建一个空目录，避免真实项目中的环境变量、**或项目级配置干扰验证。

cc-switch 配置测试结果截图 — 图 4：先在 cc-switch 中完成轻量测试，再进入终端验证 Codex。

mkdir codex-lingneng-check
cd codex-lingneng-check
codex

进入 Codex 后，先输入只读任务：请分析当前目录，列出文件并说明下一步需要哪些信息，不要修改任何文件。如果返回正常，再让它解释一段短代码或生成一个小型修改计划。此时如果出现错误，可以更明确地判断是灵能API连接、模型能力还是项目权限问题。

如果你需要回到灵能API控制台查看余额、模型和密钥状态，官网入口仍然是 https://www.lnsns.com/。不要为了测试把真实 API Key 粘贴到 Codex 对话内容中，密钥应该只存在于受控配置位置。

九、cc-switch 没有生效时，检查本地文件

如果界面显示灵能API已启用，但 Codex 仍然访问旧线路，可以检查用户目录下的 .codex 文件夹。常见文件包括 config.toml 和 auth.json。先备份，再查看，不要一上来删除整个目录。

$codexHome = Join-Path $HOME '.codex'
Get-ChildItem $codexHome -Force
Get-Content (Join-Path $codexHome 'config.toml') -ErrorAction SilentlyContinue

下面是帮助理解字段关系的示例。灵能API的接口地址、模型和鉴权方式要以当前控制台及 Codex 版本说明为准；如果你的版本字段不同，不要把示例强行覆盖到现有配置中。

model_provider = "lingneng"
model = "gpt-5.6"

[model_providers.lingneng]
name = "灵能API"
*ase_url = "https://www.lnsns.com/v1"
wire_api = "responses"
requires_openai_auth = true

检查文件后，只修改一个变量并重启终端验证。不要同时修改模型、地址、Key 和环境变量，否则即使问题解决，也很难知道是哪一步起作用。