OpenAI Codex CLI
OpenAI 官方的终端编码 agent。由于它使用标准 OpenAI API，相同的两个环境变量即可解锁 每一个 生态系统中与 OpenAI 兼容的工具 — 一旦 Codex 能用，Aider / Continue / LangChain / 原生 openai CLI 也都能用。
开始之前
在以下位置创建 API key Console → API Keys. 请立即复制 — 它只会显示一次。
第 1 步 — 设置环境变量
# ~/.zshrc (or equivalent)
export OPENAI_BASE_URL="https://synthorai.io/v1"
export OPENAI_API_KEY="sk-..." # your Synthorai key与 OpenAI 兼容的 base URL 必须以下面结尾 /v1. 与 Anthropic SDK 不同，OpenAI SDK 不会自动附加它。常见错误是粘贴 https://synthorai.io；这样请求会命中 /chat/completions （404），而不是 /v1/chat/completions.
第 2 步 — 发送你的第一个请求
# Open a new shell so env vars take effect, then:
codex exec -m gpt-5.4-mini "refactor this function for readability" < src/foo.py
# Or for long reasoning-heavy tasks:
codex exec -m gpt-5.3-codex "implement unit tests for bar()"相同的配置同样适用于 openai CLI、Python/Node SDK、Aider，以及任何其他与 OpenAI 兼容的工具 — 它们都会读取 OPENAI_BASE_URL 和 OPENAI_API_KEY.
推荐模型
| 参数 | 类型 | 说明 |
|---|---|---|
gpt-5.3-codex | coding | 针对代码生成调优。Codex CLI 的默认选择。 |
gpt-5.4 | reasoning | 旗舰级推理能力。适用于架构级别的重构。 |
gpt-5.4-mini | fast | 快速、便宜，但仍然很强大。适合短任务的默认选择。 |
gpt-5.4-nano | cheapest | 最便宜的 OpenAI 选项。适用于小幅编辑和分类。 |
故障排查
/chat/completions 上出现 "404 Not Found" — 你的 OPENAI_BASE_URL 缺少 /v1 后缀。修复方法： export OPENAI_BASE_URL="https://synthorai.io/v1".
"仍然命中 api.openai.com" — 新的环境变量只对新的 shell 生效。请打开一个全新终端，或 source 你的配置文件。
"Model not found" — curl $OPENAI_BASE_URL/models -H "Authorization: Bearer $OPENAI_API_KEY" 以查看你工作空间确切可用的列表。
按项目覆盖 — 如果你不想全局设置这些变量，可以把它们放进项目级的 .envrc （配合 direnv）或一个按 shell 设定的函数中。
在 model price comparison 中查看这四个档位的价格对比。