本文说明如何安装 Codex CLI，并把卡特 Token 站创建的 API Key 配置到 Codex 中。
Codex 使用 OpenAI 兼容接口，Base URL 必须写成 https://api.cutaihub.com/v1。不要把「GPT生图专用」分组用于 Codex 对话或编程请求。
前置准备
开始前请先完成：
- 已安装 Node.js、npm 和 Git。
- 已在卡特 Token 站创建 API Key。
- API Key 分组支持 Codex 或 OpenAI 兼容对话请求。
如果还没有完成，可以先查看「Node.js和Git环境配置」和「创建和使用 APIKEY」。
安装 Codex CLI
三系统都可以使用 npm 安装：
npm install -g @openai/codex
安装常见问题
permission denied 或 EACCES
macOS / Linux 不建议直接加 sudo 安装。可以把 npm 全局目录改到用户目录：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
~/.bashrc 换成 ~/.zshrc。
Windows 可以用管理员身份打开 PowerShell 后执行：
npm config set prefix "$env:APPDATA\npm"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
command not found: codex
通常是 npm 全局 bin 目录没有加入 PATH。先执行：
确认该目录下的 bin 路径已经加入系统 PATH，然后重新打开终端。
配置 API
Codex 主要读取两个配置文件：
| 系统 | config.toml | auth.json |
|---|
| Windows | C:\Users\用户名\.codex\config.toml | C:\Users\用户名\.codex\auth.json |
| macOS / Linux | ~/.codex/config.toml | ~/.codex/auth.json |
.codex 目录不存在，可以手动创建。
编辑 config.toml
写入以下配置：
model_provider = "cutai_codex"
[model_providers.cutai_codex]
name = "cutai_codex"
base_url = "https://api.cutaihub.com/v1"
requires_openai_auth = true
这里的 base_url 必须带 /v1。如果只写 https://api.cutaihub.com，Codex 请求通常会失败。
编辑 auth.json
把你在卡特 Token 站创建的完整 API Key 写入 auth.json：
{
"OPENAI_API_KEY": "你的API Key"
}
不要把 auth.json 上传到公开仓库，也不要截图公开完整 Key。
可选配置
如果你需要固定模型或调整推理参数，可以在 config.toml 中继续添加：
model = "你的模型名称"
model_reasoning_effort = "medium"
disable_response_storage = true
supports_websockets = false
| 参数 | 说明 |
|---|
model_provider | 选择上方定义的供应商配置 |
model | 默认使用的模型名称 |
model_reasoning_effort | 推理强度，常见值为 low、medium、high |
disable_response_storage | 是否关闭服务端响应存储，建议保持 true |
supports_websockets | 是否启用 WebSocket 传输，普通代理场景建议 false |
开始使用
进入你的项目目录后启动 Codex：
看到输入框后，可以直接输入需求，例如：
帮我用 Python 实现一个二叉搜索树，包含插入、删除、查找方法。
排查清单
如果请求失败，优先检查：
base_url 是否是 https://api.cutaihub.com/v1。auth.json 中的 OPENAI_API_KEY 是否完整。- API Key 是否选择了支持 Codex 的分组。
- 是否误用了「GPT生图专用」分组。
- 账号余额是否充足。
config.toml 和 auth.json 是否放在正确的 .codex 目录。
