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 线路的客户端用这个地址；Codex 等只认 Responses 协议的工具用 https://api.shinloo.com/v1/responses（两者都已提供，GET /v1/models 可查你的 Key 可用模型）。

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

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

国内站已支持直连

Codex CLI 0.153+ 只接受 wire_api = "responses"（即 /v1/responses）。国内站 https://api.shinloo.com 现已提供 /v1/responses，可像国际站一样直连，无需绕道。

一键接入

curl -fsSL https://api.shinloo.com/agents/codex/setup | bash
# 自带 Key：   ... | bash -s -- --key <你的Key>
# 换回其它通道：... | bash -s -- --uninstall

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://api.shinloo.com/v1，国际站填 https://quantoport.com/v1——两站都已支持 Codex。下方为手工配置写法（国内站示例，国际站把域名、provider id 与 Key 变量名换掉即可）。

配置

国内站 https://api.shinloo.com（已提供 /v1/responses）：
1) 编辑 ~/.codex/config.toml：
   model = "gpt-5.6-sol"
   model_provider = "shinloo"

   [model_providers.shinloo]
   name = "玺芮算力"
   base_url = "https://api.shinloo.com/v1"
   env_key = "SHINLOO_API_KEY"
   wire_api = "responses"
2) 导出密钥：export SHINLOO_API_KEY=<你的网关密钥>
3) 运行 codex。
国际站写法相同：base_url 换 https://quantoport.com/v1，provider id 用 quantoport，Key 变量用 QUANTOPORT_API_KEY。
注意：Codex 0.153+ 只接受 wire_api = "responses"（旧写法 "chat" 会直接报错）；国内站 https://api.shinloo.com 已提供 /v1/responses，可直连。

3 · 验证

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

验证

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

4 · 常见坑

wire_api 必须写成 "responses"：Codex 0.153+ 已不再支持 "chat"，只认 /v1/responses。国内站 https://api.shinloo.com 与国际站 https://quantoport.com 均已提供。
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