Codex CLI

OpenAI 官方的命令行编码助手。装好后在终端里用 codex 启动。

Codex 家族有三个东西，先分清

名称	是什么	本页
Codex CLI	OpenAI 官方命令行工具	✅ 就是本页
Codex 桌面端	OpenAI 官方图形应用，命令 codex app	另一页
Codex++	第三方启动器，给桌面端换供应商用	另一页

三者装法不同、配置方式也不同。只想要命令行的，看完本页就够了。

协议对应关系

Codex 走 OpenAI 兼容协议， 而 Claude Code 走 Anthropic 协议。 地址和变量名都不一样，不能混用。

客户端	协议	地址	密钥
Claude Code	Anthropic	https://api.juheai.shop	ANTHROPIC_AUTH_TOKEN
Codex CLI	OpenAI 兼容	https://api.juheai.shop/v1	OPENAI_API_KEY

第一步：安装

方式一：官方安装脚本

macOS / Linux：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

方式二：包管理器

npm install -g @openai/codex

brew install --cask codex

确认装上了：

codex --version

第二步：配置网关

Codex 读 ~/.codex/config.toml （Windows 是 %USERPROFILE%\.codex\config.toml）。 新建或编辑它：

[model_providers.juheai]
name = "juheai"
base_url = "https://api.juheai.shop/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

[profiles.juheai]
model_provider = "juheai"
model = "你的模型名"

env_key 写的是变量名而不是密钥本身 —— 密钥单独放进环境变量：

export OPENAI_API_KEY="sk-你的密钥"

PowerShell：

$env:OPENAI_API_KEY = "sk-你的密钥"

用这个 profile 启动：

codex --profile juheai

第三步：认证方式

Codex 默认引导你用 ChatGPT 账号登录（Sign in with ChatGPT）。 走本站网关时不需要，用 API Key 即可。除了上面配的环境变量，也可以显式登录一次：

codex login --with-api-key

直接把密钥粘进去回车即可。注意：旧的 --api-key 参数已被官方改成报错 （避免密钥出现在命令历史和进程列表里）。
启动后用 /status 可以查看当前模型、审批策略和 token 用量。

常用参数

参数	作用
codex	交互式启动
codex --profile juheai	用指定 profile 启动
codex "帮我写个脚本"	带初始指令
codex exec "跑一下测试"	非交互执行（脚本里用）
codex --model 模型名	临时指定模型
codex app	启动桌面应用（见另一页）

排查

报 401 Unauthorized

• 确认密钥填在 OPENAI_API_KEY，不是 ANTHROPIC_AUTH_TOKEN
• 确认 base_url 以 /v1 结尾（Codex 要 /v1， Claude Code 不要）
• 密钥是否已被删除或额度用尽，去网站「API 密钥」页确认

报模型不存在 / model_not_found

模型名不对，或你的分组没有开放该模型。到「可用渠道」页面按分组查实际可用的 模型名，逐字复制。

配置了 profile 但没生效

• 确认启动时带了 --profile juheai
• 确认配置文件路径正确（Windows 是 %USERPROFILE%\.codex\config.toml）
• TOML 对缩进和引号敏感，检查有没有中文引号混进去

启动报错 / 一直空流或 404

• 检查配置里是不是写了 wire_api = "chat" —— 官方已移除该取值，改成 "responses" 即可。
• 确认 base_url 是 https://api.juheai.shop/v1（Codex 要带 /v1，Claude Code 不要）。
• 确认 --profile juheai 带上了，且配置文件里的 model_provider 名字与 profile 里写的一致。

同时装了 Claude Code 和 Codex，互相干扰吗

不会。两者读的是不同的环境变量（ANTHROPIC_* 与 OPENAI_*），可以共存。只要别把它们指向彼此的地址即可。

官方安装方式与文档： github.com/openai/codex、 openai.com/zh-Hans-CN/codex。 本站不代为分发安装包。