🎁 新用戶 免費註冊,送 10 次呼叫,最高 $1,免綁卡。

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_URLOPENAI_API_KEY.

推薦模型

參數類型說明
gpt-5.3-codexcoding針對程式碼生成最佳化。Codex CLI 的預設選擇。
gpt-5.4reasoning旗艦級推理能力。適用於架構級別的重構。
gpt-5.4-minifast快速、便宜,但仍然很強大。適合短任務的預設選擇。
gpt-5.4-nanocheapest最便宜的 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 中查看這四個等級的價格比較。