Codex — Fast AI Docs

适合人群

OpenAI 生态用户

希望使用 OpenAI 官方编码代理，并保留本地终端执行能力。

主配置文件

~/.codex/config.toml

Codex 官方文档明确支持个人级与项目级配置文件。

认证文件

~/.codex/auth.json

当前这套接入方式需要手动写入 API Key。

官方文档

Codex 中文介绍

OpenAI 官方中文页面，适合先了解产品定位。

Codex 配置参考

开发者配置文档，补充 `config.toml`、provider 和配置层级说明。

特点与使用场景

特点

OpenAI 官方编码代理，终端和 IDE 扩展体验一致，配置体系和工具链文档较完整。

适用场景

你已经在使用 ChatGPT / OpenAI 开发工具，或者希望把编码代理、规则、插件和本地环境放在同一套 OpenAI 体系里。

第 1 步：安装 Codex

使用 npm 或 Homebrew

按官方 README 安装即可。

npm

npm install -g @openai/codex

Homebrew

brew install --cask codex

验证安装

执行 codex，确认命令可用。首次启动时会引导你选择登录方式。

第 2 步：配置 Fast AI 认证

这里按当前实际可用方式处理，直接手动编辑 auth.json。

这里就是要手改

按当前这套接入方式，auth.json 需要手动写入 OPENAI_API_KEY。文档应该和实际操作保持一致，不再额外引导你改走环境变量方案。

编辑 `~/.codex/config.toml`

如果你只想在某个项目中生效，也可以放到项目目录下的 .codex/config.toml。

~/.codex/config.toml

model_provider = "FastAI"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = false
max_context = 1000000               # 1M 上下文
context_compact_limit = 800000      # 80% 时触发压缩

[model_providers.FastAI]
name = "FastAI"
base_url = "https://api.fastai.run/v1"
wire_api = "responses"
requires_openai_auth = true

编辑 `~/.codex/auth.json`

在同目录下创建或修改认证文件，把 Fast AI 的 API Key 写进去。

~/.codex/auth.json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

第 3 步：验证连接

运行 Codex

在终端执行 codex 或直接给它一个任务，例如 codex "总结当前仓库结构"。

Terminal

codex "总结当前仓库结构并指出最值得先修的问题"

确认模型已走 Fast AI

如果任务可以正常返回，且你在 Fast AI 控制台能看到对应请求记录，说明配置成功。