Codex

Codex 桌面应用与 Codex CLI 是两种不同的使用形态，两者使用同一套 OpenAI 接入配置。请先选择要使用的形态，再按对应步骤安装和配置。

安装 Codex 桌面应用或 Codex CLI

先选择你要使用的方式。桌面应用和 CC Switch 不要求 Node.js；只有使用 Codex CLI 时才需要 Node.js LTS。

CLIENT

Codex 客户端

直接下载适合当前系统的官方客户端。

下载 Codex 客户端

加载中...

HELPER

CC Switch 桌面应用

用于管理 Codex 配置并快速切换 API 密钥与 Base URL。

下载 CC Switch 桌面应用

加载中...

如果你使用 Codex CLI，点击展开仅命令行用户需要

Codex CLI 需要 Node.js LTS 运行环境。桌面应用用户可以跳过这一部分。

RUNTIME

Node.js LTS

安装命令行版本所需的运行环境。

下载 Node.js

加载中...

PowerShell / Terminal

npm i -g @openai/codex
codex --version

如果提示找不到命令，先关闭当前终端窗口，重新打开后再执行验证。

通过 CC Switch 配置（推荐）

1
打开控制台的 API 密钥
新用户先创建一把密钥；如果已有可用密钥，直接打开对应密钥的编辑面板。
2
选择 Codex 桌面应用或 Codex CLI
在密钥创建弹窗或编辑面板中，点击“选择 Codex 使用方式”，先选择 Codex 桌面应用或 Codex CLI。系统会按你的选择准备对应客户端；CLI 用户还需要 Node.js LTS。
3
允许打开并确认配置
浏览器询问是否通过 ccswitch:// 打开外部应用时，选择允许。按 CC Switch 提示完成配置后，确认已出现 NUSI 配置，并检查 Base URL 与控制台当前端点一致。
确认已选中 NUSI 配置，并核对画面中的 Base URL 与控制台当前端点一致。

如果想手动配置，可通过 config.toml 连接 Codex与 CC Switch 二选一

WINDOWS%USERPROFILE%\.codex\config.toml

MACOS / LINUX~/.codex/config.toml

在对应路径创建或编辑 config.toml，并将模型 ID 替换为控制台当前可用值。将 API 密钥保存为环境变量 OPENAI_API_KEY，不要写入配置文件：

config.toml

model = "YOUR_MODEL_ID"
model_provider = "nusi"

[model_providers.nusi]
name = "NUSI"
base_url = "https://nusi.si/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

完成第一次验证

1
重新启动工具
桌面应用用户完全退出并重新打开 Codex；CLI 用户重新打开 PowerShell（Windows）或 Terminal（macOS），然后运行 codex。
2
打开测试目录
打开一个可读取的测试项目。首次运行如出现目录访问或命令执行确认，请先阅读内容再决定是否允许。

第一次验证提示词

先不要改代码。请先读取当前项目结构，并告诉我入口文件和主要目录。

能正常读取目录并回复，说明 Codex、API 密钥、CC Switch 配置与 NUSI 调用链路已打通；如果出现“Operation not permitted”，说明 macOS 尚未授予 Codex 或终端访问项目文件的权限，请先开启“文件与文件夹”或“完全磁盘访问”后重试。

常见失败排查

现象处理方式

切换配置后仍使用旧地址

完全退出 Codex 或关闭终端，确认 CC Switch 当前选中 NUSI，再重新打开。

401、403 或提示无效密钥

回到控制台检查密钥状态；如密钥已删除、过期或疑似泄露，创建新密钥并重新配置。

找不到 codex 命令

确认 Node.js LTS 与 Codex CLI 安装成功，重新打开终端后运行 codex --version。

无法读取项目文件

检查系统“文件与文件夹”或“完全磁盘访问”权限，然后在同一测试目录重试。

还需要配置 Claude Code CLI？查看 Claude Code CLI 配置

NUSI 上手指南 · 持续更新中 · 2026.09