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 中查看這四個等級的價格比較。