Codex 命令行

终端里使用 Codex。

在终端里使用 Codex。需要一把 OpenAI 分组的密钥，并已安装 Node.js。零基础可以看图文逐步版。

Codex 不读取 OPENAI_BASE_URL 环境变量，接口地址只能写在 config.toml 里。只设环境变量的话，请求会被发去 OpenAI 官方而不是比高AI。

1. 安装 Codex

Terminal

npm install -g @openai/codex --registry=https://registry.npmmirror.com --prefix "$HOME/.bigao"
export PATH="$HOME/.bigao/bin:$PATH"
grep -qsF 'export PATH="$HOME/.bigao/bin:$PATH"' "$HOME/.zshrc" || echo 'export PATH="$HOME/.bigao/bin:$PATH"' >> "$HOME/.zshrc"

运行 codex --version 输出版本号即安装成功。

2. 写入 config.toml

在 ~/.codex/（Windows 为 %USERPROFILE%\.codex\，没有就新建）下创建 config.toml，内容如下。已有旧配置的，建议先备份。不要删除整个 .codex 目录，里面有你的历史会话。

~/.codex/config.toml

model = "gpt-6.1-sol"
model_provider = "bigao"
model_context_window = 200000
model_auto_compact_token_limit = 160000

[features]
apps = false

[model_providers.bigao]
name = "Bigao AI"
base_url = "https://api.bigao.ai/v1"
env_key = "BIGAO_API_KEY"
wire_api = "responses"

3. 设置密钥

Terminal

export BIGAO_API_KEY="sk-PASTE_YOUR_KEY"
grep -qsF 'export BIGAO_API_KEY="sk-PASTE_YOUR_KEY"' "$HOME/.zshrc" || echo 'export BIGAO_API_KEY="sk-PASTE_YOUR_KEY"' >> "$HOME/.zshrc"

第一行让当前窗口立即生效，第二行让以后打开的窗口也生效。

4. 开始使用

Terminal

cd 你的项目目录
codex

启动时出现 “Model metadata not found” 黄字是正常提示，不影响使用。

常见问题

返回 401 或提示未登录？

确认 BIGAO_API_KEY 已在启动 Codex 的同一个窗口设置，且密钥属于 OpenAI 分组、未过期。

请求跑去了 OpenAI 官方 / 用的是自己的 ChatGPT 账号？

config.toml 没被读到或 model_provider 不是 bigao，检查文件路径和内容。

Windows 打开 config.toml 是乱码 / Codex 拒绝启动？

文件必须是 UTF-8 编码。用记事本另存为时选择 UTF-8，或直接复制上面的命令重新写入。

怎么在 Codex 里换模型？

在 Codex 里输入 /model 选择，或修改 config.toml 第一行的 model。