Documentation

Codex CLI

Codex CLI 使用 OpenAI API。請把它指向 OpenAI 相容網關。

快速開始

步驟 1:安裝 Codex CLI

按照 Codex CLI 安裝說明 安裝 CLI。

步驟 2:設定 Codex

建立或編輯 ~/.codex/config.toml:

model_provider = "llmpool"
model_reasoning_effort = "high"
model = "YOUR_MODEL"

[model_providers.llmpool]
name = "llmpool"
base_url = "https://api.aifarmer.vip/openai/v1"
env_key = "LLMPOOL_API_KEY"

步驟 3:設定密鑰

# 加到 ~/.zshrc、~/.bashrc 或 ~/.config/fish/config.fish
export LLMPOOL_API_KEY="YOUR_API_KEY"

步驟 4:開始編寫程式

cd /path/to/project
codex

執行 /status,確認模型供應商為 llmpool。

連線失敗時診斷

如果透過 CC Switch 匯入後 Codex 仍無法使用,請在「接入指南」頁面下載 check-codex-integration.sh,在下載資料夾開啟終端機並執行:

chmod +x check-codex-integration.sh && ./check-codex-integration.sh

指令碼會檢查 Codex CLI、CC Switch 目前的 Codex Provider 資料庫記錄、~/.codex/config.toml、認證來源和 /models 回應,然後預設發出一次最小 Responses API 請求和一次真實 codex exec 請求。它不會輸出 API 密鑰。codex exec 請求通過,代表目前 Codex 設定到該中轉閘道和所選模型的基本請求流程是通的;本檢測沒有涵蓋所有串流輸出、工具呼叫或 MCP 情境。

兩次請求都可能產生費用,需要時可分別跳過:

./check-codex-integration.sh --skip-responses
# 只跳過 Codex 端到端請求:
./check-codex-integration.sh --skip-codex-exec