跳轉到主要內容

​
概覽

OpenAI Codex 是一款開源的命令列工具 (CLI)，作為輕量級的程式碼代理 (coding agent)，能夠在終端機中讀取、修改及執行程式碼。它基於 GPT 模型構建，並針對程式碼生成進行了優化。

​
系統需求

  • 作業系統：macOS, Linux (官方支援), Windows 透過 WSL
  • Node.js：版本 18+
  • npm：版本 10.x.x 或更高

​
安裝

sudo npm install -g @openai/codex@latest
驗證安裝： 
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  # 或 source ~/.bashrc

​
步驟 2：配置 config.toml

編輯 ~/.codex/config.toml： 
model = "gpt-4o"
model_provider = "lemondata"

[model_providers.lemondata]
name = "LemonData"
base_url = "https://api.lemondata.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
如果配置檔案不存在，請執行一次 codex 以生成檔案，然後再進行編輯。

​
基本用法

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

​
可用模型

模型適用場景
gpt-4o複雜的編碼任務、架構設計
gpt-4o-mini快速修復、簡單任務
claude-sonnet-4-5程式碼審查、文件撰寫
deepseek-r1演算法設計、推理

​
互動指令

指令描述
/help顯示說明
/exit 或 Ctrl+C退出
/clear清除對話
/config查看配置
/model <name>切換模型
/tokens查看 token 使用量

​
驗證配置

# 檢查環境變數
echo $OPENAI_API_KEY

# 測試 API 連線
codex "Hello, Codex!"

# 查看配置
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"

​
故障排除

  • 驗證 config.toml 中的 base_url 是否準確為 https://api.lemondata.cc/v1
  • 檢查網路連線狀態
  • 確保無代理伺服器干擾
  • 驗證 OPENAI_API_KEY 環境變數已設定
  • 檢查金鑰是否以 sk- 開頭
  • 確保金鑰在 LemonData 控制面板中處於啟用狀態