Documentation
🌀 Codex 配置

Codex 配置

请确认你已完成 环境检查,拥有可用的 API Key。

什么是 Codex

OpenAI Codex CLI 是 OpenAI 推出的命令行编程助手,支持在终端中与 GPT 模型进行交互式编程。通过 AiFirst 中转,你可以使用 Codex 的全部功能。

安装 Codex

npm install -g @openai/codex

安装完成后,验证是否成功:

codex --version

配置 AiFirst API

方式一:环境变量(推荐)

export OPENAI_BASE_URL=https://apiaifirst.com/v1
export OPENAI_API_KEY=sk-xxx
⚠️

Codex 的 Base URL 需要加 /v1,填 https://apiaifirst.com/v1

写入 shell 配置文件(永久生效):

echo 'export OPENAI_BASE_URL=https://apiaifirst.com/v1' >> ~/.zshrc
echo 'export OPENAI_API_KEY=sk-xxx' >> ~/.zshrc
source ~/.zshrc

方式二:配置文件

创建或编辑 ~/.codex/config.json

{
  "provider": "openai",
  "model": "gpt-5.5",
  "providers": {
    "openai": {
      "name": "AiFirst",
      "baseURL": "https://apiaifirst.com/v1",
      "envKey": "OPENAI_API_KEY"
    }
  }
}

启动 Codex

codex

如果看到 Codex 的交互界面,说明配置成功!🎉

指定模型

AiFirst 支持多种模型,你可以在启动时指定:

# 使用 gpt-5.5
codex --model gpt-5.5
 
# 使用 gpt-5.4-mini(更快更便宜)
codex --model gpt-5.4-mini
💡

登录 AiFirst 控制台 (opens in a new tab),点击左侧 「可用渠道」 查看当前支持的全部模型。

常见问题

详见 Codex 常见问题