Codex CLI快速开始指南

前置条件：安装 Node.js 环境

Codex 依赖 Node.js 运行环境，请先参考Node.js 环境安装指南完成安装并验证。

1. 安装 Codex

Windows、macOS 和 Linux 均可运行：

如果提示权限不足，建议使用 Node.js 版本管理器，或将 npm 全局目录配置到当前用户可写的位置；不建议直接使用 sudo npm install -g。

验证安装：

输出版本号即表示安装成功。

2. 创建 API Key

填写密钥名称，选择Codex分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。新手建议直接使用默认配置。

安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。

3. 导入密钥到 Codex

推荐使用 CC Switch 工具进行一键配置，也可手动创建配置文件。

方式一：CC Switch（推荐）

前往 CC Switch Releases 下载安装后，点击 导入到 CCS 完成一键导入：

导入后点击启用即可。

方式二：手动配置文件

创建配置目录

# Windows (PowerShell)
New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null

不要删除 .codex 目录。 其中可能包含已有配置、认证信息、命令历史、日志和缓存。

创建 `config.toml`

在 ~/.codex/（Windows 为 %USERPROFILE%\.codex\）目录下创建 config.toml：

model_provider = "anyroute"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.anyroute]
name = "AnyRoute"
base_url = "https://cc.anyroute.io"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

设置 API Key

点击密钥旁的复制按钮获取 API Key：

在当前终端会话中设置环境变量，并将 YOUR_API_KEY 替换为你在控制台创建的密钥。

Windows PowerShell：

$env:OPENAI_API_KEY = "YOUR_API_KEY"

macOS / Linux：

长期使用建议优先通过 CC Switch 或操作系统的安全凭证管理方式配置，不要把 API Key 写入代码仓库或共享脚本。

4. 开始使用

进入任意项目目录，运行：

Codex 会以当前目录作为工作区启动。更多用法请参考 OpenAI 官方 Codex 文档。

常见问题（FAQ）

Q：运行 npm install -g 提示权限不足？
A：建议使用 Node.js 版本管理器，或把 npm 全局目录配置到当前用户可写的位置；不建议直接使用 sudo npm install -g。

Q：codex --version 提示命令不存在？
A：确认 npm 全局目录已加入系统 PATH，可运行 npm prefix -g 查看全局前缀，然后把对应的可执行文件目录加入 PATH。

Q：连接失败或返回 401 错误？
A：检查 config.toml 中 base_url 是否为 https://cc.anyroute.io，确认 OPENAI_API_KEY 已在启动 Codex 的同一终端会话中设置，并检查 Key 是否有效、未过期且属于 Codex 兼容分组。

Q：如何切换不同模型或倍率？
A：在 AnyRoute 控制台创建不同分组的密钥，更新当前终端中的 OPENAI_API_KEY，或通过 CC Switch 在多个配置间快速切换。

Codex CLI快速开始指南

前置条件：安装 Node.js 环境#

1. 安装 Codex#

2. 创建 API Key#

3. 导入密钥到 Codex#

方式一：CC Switch（推荐）#

方式二：手动配置文件#

创建配置目录#

创建 config.toml#

设置 API Key#

4. 开始使用#

常见问题（FAQ）#