国内用户需将 codex cli 的 base url 配置为 https://xxx.com/v1 格式（末尾 /v1 不可省略），并通过 config.toml 或环境变量设置，model 字段须填中转服务实际支持的模型名，否则请求失败。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
国内用户想让 Codex CLI 连接七牛云、AITokensFlux 或自建网关等第三方 AI 服务，必须正确配置 Base URL，否则请求会发往 OpenAI 官方地址并因密钥不匹配或网络不可达而失败。
确认 Base URL 格式是否合规
先打开你所用中转服务的 API 接入页，找到类似「OpenAI 兼容地址」的字段。它必须以 https://xxx.com/v1 形式结尾——注意末尾的 /v1 不可省略，Codex CLI 会自动拼接 /chat/completions 等路径，缺了 /v1 就会变成 https://xxx.com/chat/completions，导致 404。
如果页面只给 https://xxx.com，请手动补上 /v1；如果给了 https://xxx.com/v1/chat/completions，那是错误示例，删掉 /chat/completions 部分才对。
通过 config.toml 文件永久配置
第一步：确保配置目录存在，在终端执行：
mkdir -p ~/.codex
第二步：用编辑器打开配置文件：
nano ~/.codex/config.toml
第三步：写入以下内容（替换其中的 URL 和模型名）：
#:schema https://developers.openai.com/codex/config-schema.json
openai_base_url = "https://api.qnaigc.com/v1"
model = "deepseek-v4-pro"
sandbox_mode = "workspace-write"
web_search = "disabled"
⚠️ 注意：model 字段必须填你中转服务后台「模型广场」里实际列出的名称，比如 deepseek-v4-pro、qwen2.5-72b-instruct，不能写 gpt-4o 或 claude-3-haiku——这些在第三方服务端根本不存在，会导致 404 或 model_not_found 错误。
通过环境变量临时生效（适合调试）
方法一（macOS/Linux）：
export OPENAI_BASE_URL="https://your-transit-api.com/v1"
export OPENAI_API_KEY="sk-xxxxxx"
方法二（Windows PowerShell）：
$env:OPENAI_BASE_URL="https://your-transit-api.com/v1"
$env:OPENAI_API_KEY="sk-xxxxxx"
这一步操作起来很简单，直接在当前终端窗口里粘贴执行就行。但注意：关闭终端后变量失效，如需长期使用，应写入 ~/.zshrc 或 ~/.bashrc（macOS/Linux）或系统环境变量（Windows）。
验证配置是否生效
① 运行 codex doctor —— 它会检查 openai_base_url 是否被识别、认证状态、沙箱权限等，重点看 “API endpoint” 行输出的地址是否为你刚填的 URL。
② 执行 codex models list，如果返回的是你中转服务支持的模型列表（而非 OpenAI 官方模型），说明 Base URL 已成功接管请求。
③ 若报错 “Unauthorized” 或 “Invalid API key”，说明 OPENAI_API_KEY 没配对，或该 Key 在中转服务后台未启用；若报错 “connection refused” 或 “timeout”，说明 Base URL 域名无法解析或端口不通，需检查 DNS 或代理设置。
