跳轉到主要內容

​
概覽

類型: Coding Tool主要路徑: OpenAI Responses（進階可選路徑）支援信心: 在模型/路徑限制下受到支援
OpenAI Codex 是一個開源的命令列工具（CLI），作為輕量的程式撰寫代理，能在終端機中閱讀、修改與執行程式碼。它建構於 GPT 模型之上，並針對程式碼生成進行最佳化。 對於 LemonData，Codex CLI 可以使用 /v1/responses，但您應將其視為進階相容路徑。某些僅限 Responses 的功能並不保證在每個模型與路由上都可用。

​
系統需求

  • OS: macOS、Linux（官方支援）、透過 WSL 的 Windows
  • Node.js: 版本 18+
  • npm: 版本 10.x.x 或更高

​
安裝

npm install -g @openai/codex
驗證安裝： 
codex --version

​
設定

​
第 1 步：設定 API Key

暫時（當前工作階段）: 
export OPENAI_API_KEY="sk-your-lemondata-key"
永久設定: 加入至 ~/.bashrc、~/.zshrc 或 ~/.bash_profile： 
export OPENAI_API_KEY="sk-your-lemondata-key"
然後重新載入： 
source ~/.zshrc  # or source ~/.bashrc

​
第 2 步：設定 config.toml

編輯 ~/.codex/config.toml： 
model_provider = "lemondata"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
fast_mode = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
sandbox_mode = "danger-full-access"
approval_policy = "never"

disable_response_storage = false
personality = "friendly"
service_tier = "fast"

[model_providers.lemondata]
env_key = "OPENAI_API_KEY"
name = "lemondata"
base_url = "https://api.lemondata.cc/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
responses_websockets = true
responses_websockets_v2 = true
如果配置檔不存在，請先執行一次 codex 以產生它，然後編輯該檔案。修改 config.toml 後請完全重新啟動 Codex，以便重新載入新的提供者設定。
Codex 正在逐步淘汰對自訂提供者的 chat/completions 支援。除非您刻意使用舊的相容路徑，否則對 LemonData 保持 wire_api = "responses"。
如果請求使用了在所選模型或路由上不支援的 Responses 專屬欄位，LemonData 會返回明確的錯誤，而不是悄悄降級該請求。

​
基本用法

啟動互動模式: 
codex
直接指令: 
codex "Fix the bug in main.py line 42"
指定模型: 
codex -m gpt-5.4 "Build a REST API server"

​
推薦模型

Model適用情境
gpt-5.4程式編寫與推理的最佳預設選擇
gpt-5-mini更快速、更便宜的程式工作流程備援
claude-sonnet-4-6程式碼審查、文件撰寫
deepseek-r1演算法設計、推理

​
互動指令

指令說明
/help顯示說明
/exit 或 Ctrl+C退出
/clear清除對話
/config檢視設定
/model <name>切換模型
/tokens檢視 token 使用情況

​
驗證設定

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

​
常見用例

程式碼審查: 
git diff | codex "Review these code changes"
產生 commit 訊息: 
git diff --staged | codex "Generate a commit message for these changes"
修復錯誤: 
codex "Fix the TypeScript errors in src/components/"
解釋程式碼: 
cat main.py | codex "Explain what this code does"

​
故障排除

  • 驗證 base_url 在 config.toml 中是否為 https://api.lemondata.cc/v1
  • 檢查網路連線
  • 確保沒有代理干擾
  • 驗證 env_key = "OPENAI_API_KEY" 是否存在於 ~/.codex/config.toml
  • 驗證 OPENAI_API_KEY 環境變數是否已設定
  • 檢查金鑰是否以 sk- 開頭
  • 確保該金鑰在 LemonData 儀表板中為啟用狀態
  • 某些欄位僅在 LemonData 能為所選模型與路由保證該行為時，才在 /v1/responses 上可用
  • 若您看到 unsupported_request_field，請移除該欄位或切換至不依賴該欄位的工作流程