Codex CLI

OpenAI 开源的终端编程智能体

用 TokenMix CLI 接入

官方 TokenMix CLI 一条命令即可完成接入，无需手动配置环境变量：

npx tokenmix codex

自动处理登录、API 地址和密钥。如果你偏好手动配置，完整步骤见下方。

简介

Codex CLI 是 OpenAI 的开源终端编程智能体。它读取文件、编写代码、运行沙箱化 shell 命令，并持续迭代直到任务完成。与基于浏览器的工具不同，Codex 完全在本地运行。通过 TokenMix 配置后，可以以 TokenMix 定价使用 gpt-5.5、gpt-5.4 等强大模型。

前提条件

• macOS、Linux 或 Windows（推荐 WSL）
• Node.js 22 或更高版本 — 运行 node -v 确认
• TokenMix 账号及以 sk-tm- 开头的 API Key → 在 tokenmix.ai 注册 → 控制台 → API Keys

配置步骤

1. 安装 Codex CLI

npm install -g @openai/codex

验证：

codex --version

2. 创建配置文件

Codex 从 ~/.codex/config.toml 读取提供商配置。创建目录和文件：

mkdir -p ~/.codex

用编辑器打开 ~/.codex/config.toml 并添加：

model = "gpt-5.5"
model_provider = "tokenmix"

[model_providers.tokenmix]
name = "TokenMix"
base_url = "https://api.tokenmix.ai/v1"
env_key = "TOKENMIX_API_KEY"
wire_api = "responses"

3. 设置 API Key

将环境变量添加到 Shell 配置文件（~/.zshrc 或 ~/.bashrc）：

export TOKENMIX_API_KEY="sk-tm-你的密钥"

重新加载：

source ~/.zshrc

4. 启动 Codex

cd ~/你的项目
codex

使用其他模型：

codex --model gpt-5.4

可用 TokenMix 模型：gpt-5.5、gpt-5.4

验证

codex -q "当前目录中有哪些文件？"

Codex 应列出目录内容。如果看到认证错误，请确认当前 Shell 中已导出 TOKENMIX_API_KEY。

常见问题

Q: wire_api = "responses" 是什么意思？ 它告诉 Codex 使用 OpenAI Responses API 协议，这是 Codex 支持的唯一格式。TokenMix 与该格式完全兼容。

Q: 可以用 Codex 使用 Claude 模型吗？ Codex 围绕 Responses API 设计，针对 GPT 模型优化。如需使用 Claude 模型，请使用 Claude Code 或 Cline。

Q: 模型名称无法识别怎么办？ 确保 config.toml 中的 model 字段与 TokenMix 账号中可用的 short_id 匹配。可在 tokenmix.ai/models 查看可用模型列表。