OpenAI Codex CLI

OpenAI 的本地编程 Agent

OpenAI OpenAI 兼容格式 macOSLinuxWindows

Codex CLI 是 OpenAI 的本地编程 Agent，在终端里读代码、改文件、执行命令。适合想复用 OpenAI 生态、或用自有 OpenAI 兼容网关的工程师。它通过 config.toml 里的自定义 provider 指向任意 OpenAI 兼容端点。

网关 base_url（国内站）https://api.shinloo.com/v1填到各工具的 base_url / OPENAI_BASE_URL / apiBase 之类设置里。OpenAI 线路填 /v1；Anthropic / Gemini 线路填网关根 https://api.shinloo.com。

OpenAI 兼容调用路径https://api.shinloo.com/v1/chat/completionsOpenAI 线路的客户端用这个地址（GET /v1/models 可查你的 Key 可用模型）。

自定义端点设置不支持该工具没有自定义 base URL / 自定义 provider 的设置项。

推荐模型（国内站已开通）deepseek-v4.1-flashdeepseek-v4-proqwen3.8-max-0902以上为本站公示的模型名，实际可用清单以你的 Key 调 GET /v1/models 返回为准。

国内站暂不支持直连

Codex CLI 0.153+ 已不再支持 wire_api = "chat"，只接受 wire_api = "responses"（即 /v1/responses）。国内站 https://api.shinloo.com 当前只提供 OpenAI 兼容的 /v1/chat/completions，未提供 /v1/responses，因此 国内站暂不支持 Codex 直连，请使用国际站 https://quantoport.com。

1 · 安装

从 OpenAI Codex CLI 自己的官方来源安装。

安装

npm install -g @openai/codex
# 或 Homebrew：
brew install --cask codex
# 或官方脚本：
curl -fsSL https://chatgpt.com/codex/install.sh | sh

2 · 配置 — 指向国内站网关

网关 base URL https://api.shinloo.com/v1；Key 在控制台创建。

下方为工具侧的通用配置说明（含国际站写法），其中 https://quantoport.com 为国际站地址；国内站当前不具备直连条件。

配置

国际站 https://quantoport.com（原生支持 /v1/responses）：
1) 编辑 ~/.codex/config.toml：
   model = "gpt-5.6-sol"
   model_provider = "quantoport"

   [model_providers.quantoport]
   name = "QuantoPort"
   base_url = "https://quantoport.com/v1"
   env_key = "QUANTOPORT_API_KEY"
   wire_api = "responses"
2) 导出密钥：export QUANTOPORT_API_KEY=<你的网关密钥>
3) 运行 codex。
注意：Codex 0.153+ 只接受 wire_api = "responses"（旧写法 "chat" 会直接报错）；国内站 https://api.shinloo.com 当前只提供 /v1/chat/completions，未提供 /v1/responses，因此 Codex 请使用国际站。

3 · 验证

发一次请求，能返回就说明走的是国内站网关。

验证

codex exec "say hi"
# 或直接运行 codex 后输入一句 prompt；能正常返回即接入成功。

4 · 常见坑

wire_api 必须写成 "responses"：Codex 0.153+ 已不再支持 "chat"，只认 /v1/responses。国际站 https://quantoport.com 提供 /v1/responses；国内站当前只提供 /v1/chat/completions，Codex 请接国际站。
env_key 只是环境变量名，可自定义，Codex 只从该变量读取密钥。
自定义 provider 不能复用保留 id：openai、ollama、lmstudio。
项目级 .codex/config.toml 只有在信任该目录时才加载；模型名以你站实际开通的为准。

工具侧步骤的官方来源： github.com/openai/codex developers.openai.com/codex/config-advanced developers.openai.com/codex/config-reference