先分清三个东西：Codex、CC Switch 和中转服务

Codex 是实际执行任务的客户端，CC Switch 是用于保存和切换配置的管理工具，灵能API则提供 API 地址、令牌和模型信息。三者各自负责不同环节：CC Switch 配置正确，不代表 Codex 进程已经读取；Codex 能启动，也不代表当前模型和令牌有效。

理解这三个角色后，遇到问题就能知道应该回到安装、配置还是服务页面检查。

• Codex：打开会话、读取项目、执行任务。
• CC Switch：管理服务商、模型和当前启用线路。
• 灵能API：提供当前接口、模型、令牌和账户信息。

第一步：安装前先检查 Windows 环境

首次安装建议使用新的 PowerShell 窗口。先确认 Node.js 和 npm 是否可用，再安装 Codex。每条命令单独执行并观察结果，避免一口气粘贴多条命令后无法定位失败位置。

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

如果提示无法识别，先安装 Node.js LTS 并重新打开终端。如果版本号正常但路径异常，检查 PATH 是否加载了正确的安装目录。这个阶段不需要修改 API 配置。

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

安装成功的最低标准是 node、npm 和 codex 都能返回版本或帮助信息。

第二步：从灵能API页面准备当前参数

打开灵能API公开页面或控制台，确认当前模型列表、Model ID、接口地址和令牌入口。不要直接复制旧教程里的固定模型名，模型、价格和页面说明可能更新。

建议为首次启动创建一枚单独的 Codex 令牌，名称中注明设备或用途，例如 Codex-Windows-First-****。完整令牌只保存在本地私密位置，不要进入截图、文章或仓库。

• 官网入口：https://www.lnsns.com/
• *ase **L：按照当前接口说明填写版本路径。
• Model ID：从当天模型列表复制。
• API Key：使用首次测试专用密钥。

️ 第三步：在 CC Switch 中创建首次启动卡

打开 CC Switch，进入 Codex 配置区域并新增自定义服务商。首次使用不建议同时创建很多模型，先建立一张基础卡，确认流程成功后再复制出主线路、实验线路和备用线路。

服务名称建议写成“灵能API-Codex-首次测试”。备注可以写设备、日期和用途。名称只影响本地识别，但清晰命名能帮助你判断当前到底启用了哪条线路。

• 名称：灵能API-Codex-首次测试。
• 备注：Windows / First **** / 只读。
• 旧卡片：如已有可用配置，保留用于回退。

✍️ **步：填写字段并确认配置没有串台

建议按照协议、地址、模型、令牌的顺序填写。先处理不敏感的格式字段，再粘贴 API Key。复制配置卡后尤其要重新核对 Model ID，旧卡片的模型不会自动适应新任务。

服务名称：灵能API-Codex-首次测试
*ase **L：https://www.lnsns.com/v1
Model ID：以当前模型列表为准
API Key：首次测试专用令牌

*ase **L 通常填写到 /v1，不要填官网首页，也不要把完整接口路径重复拼接进去。出现 404 时先查地址；出现 model not found 时先查 Model ID；出现 401 时再查 Key。

如果 CC Switch 提供获取模型列表按钮，可以先保存地址和 Key，再点击获取。列表获取成功是基础连接通过的信号，但最终还要用 Codex 新进程测试。

第五步：保存、启用，再重新打开客户端

新卡片保存后，确认它已经出现在列表中，并点击启用或设为当前配置。接着关闭旧的 Codex、PowerShell 和相关**进程，再重新打开。只点击切换而不重启，旧进程可能仍然使用之前的配置。

命令行和桌面端如果分别读取不同配置，建议先只验证一种启动方式。命令行验证通过后，再打开桌面端或其他入口，避免两个进程同时使用不同线路导致结果难以判断。

codex --version
mkdir codex-first-session
cd codex-first-session
codex

✅ 第六步：用空目录完成第一次会话

首次会话建议在空目录中完成，不要直接进入重要项目。进入 Codex 后发送一条只读任务：请确认当前目录是否为空，并说明如果这里是一个项目，你会按什么顺序检查文件，不要创建、删除或修改任何文件。

这条任务可以同时检查命令是否启动、令牌是否有效、模型是否返回以及当前工作目录是否正确。若返回正常，再进入真实项目执行局部读取任务。

第一次不要直接发送批量重构、删除文件或长时间自动执行任务。先观察模型是否理解指令，确认线路稳定后再增加任务范围。

第七步：恢复项目会话时先确认目录和线路

需要继续某个项目时，先在 PowerShell 中进入正确目录，再检查版本控制状态和当前配置卡。不要从上一次打开的终端直接继续，尤其是中途切换过线路或模型的情况。

cd D:\work\your-project
git status
codex

进入项目后的第一条任务建议是只读取一个指定文件，说明入口、依赖和潜在风险，不修改内容。确认 Codex 读取的是正确项目后，再提出下一步计划。

如果项目包含多个环境配置，先说明哪些文件可以读取、哪些文件不能触碰。API Key、生产配置和用户数据不要因为‘项目已经打开’就自动暴露给模型。

第八步：用测试面板确认线路是否真的生效

界面测试和 Codex 会话分别验证不同环节。CC Switch 测试更接近地址、令牌和模型字段；Codex 会话则验证客户端进程是否读取了当前配置。两者都通过，才算首次接入完成。

排错记录只保留卡片名称、错误码、Model ID 和时间，不记录完整 API Key。

• 测试失败：先检查卡片字段和服务状态。
• 测试成功但 Codex 失败：关闭旧进程并重新启动。
• Codex 成功但项目失败：缩小项目读取范围。

首次使用常见问题

恢复顺序建议是：切回已知可用卡片、关闭旧进程、空目录测试、比较字段，最后才考虑重新安装。

• 命令不存在：检查 Node.js、npm、Codex 和 PATH。
• 401：确认令牌完整、有效且属于当前卡片。
• 403：检查额度、模型权限和分组范围。
• 404：检查 *ase **L 是否重复 /v1。
• model not found：从当前列表重新复制 Model ID。
• 切换无效：保存并启用卡片后，关闭旧进程再启动。
• 项目读取错误：检查 PowerShell 当前目录。

首次接入后的安全收尾

首次会话成功后，把测试令牌和正式令牌分开管理。测试结束后，如果不再使用测试令牌就撤销；正式线路只保留必要权限。不要把完整配置文件直接发给团队成员，分享时只提供脱敏模板。

灵能API官网：https://www.lnsns.com/

• API Key 不进入 Git、截图、文章和公开日志。
• 测试线路和正式线路分别命名。
• 升级 Codex 或 CC Switch 后重新完成空目录测试。
• 需要查看当前模型和服务信息时，通过官网入口进入。

最终检查：第一次能用，之后也能恢复

完成这份检查后，首次接入就不再是一次性复制配置，而是一套可以重复启动、切换和恢复的使用流程。

• Node.js、npm 和 Codex 命令可用。
• CC Switch 中的首次测试卡已保存并启用。
• *ase **L、Model ID 和 API Key 已逐项核对。
• 旧终端已关闭，新进程完成空目录只读任务。
• 进入真实项目前确认目录和版本控制状态。
• 主线路、备用线路和测试线路用途清晰。