排查
常見問題排查
連接失敗時優先檢查登入、API Key、base_url、模型列表和配置文件路徑。
Last updated 2026-05-12 | Maintained by TokenPool documentation team
提示未登入
文件頁和控制檯只有在登入後才能顯示你的個人 API Key。先點擊頁面上的「查看我的 API Key」,或直接打開:
text
https://tokenpool.dev/console/api-keys
如果彈出登入窗口,完成登入後再回到文件頁。
沒有 API Key
進入控制檯 API Key 頁面,點擊「建立 API Key」。建立後可以複製、查看、測試連接,也可以打開 CC Switch 導入。
base_url 填錯
推薦值:
text
https://api.clawto.link
標準值:
text
https://api.tokenpool.dev
不要填寫:
text
https://tokenpool.dev
https://tokenpool.dev/console
Codex 看不到 GPT-5.5
運行模型列表修復腳本。
macOS / Linux:
bash
TOKENPOOL_CODEX_MODEL='gpt-5.5' TOKENPOOL_CODEX_SET_DEFAULT_MODEL='1' bash -c "$(curl -fsSL 'https://cdn.tokenpool.dev/scripts/codex-fix-gpt55-catalog.sh')"
Windows PowerShell:
powershell
$env:TOKENPOOL_CODEX_MODEL='gpt-5.5'; $env:TOKENPOOL_CODEX_SET_DEFAULT_MODEL='1'; irm 'https://cdn.tokenpool.dev/scripts/codex-fix-gpt55-catalog.ps1' | iex
連接失敗
按這個順序檢查:
- API Key 是否完整複製。
auth.json是否是合法 JSON。config.toml是否寫在~/.codex/config.toml。base_url是否是https://api.clawto.link。- 當前帳號是否還有可用額度。
- 網絡是否能訪問 API 線路。
API Key 洩露
如果 API Key 發給了別人、出現在公開倉庫或截圖裡,請立刻刪除舊密鑰並建立新密鑰。不要等待異常帳單或調用記錄出現後再處理。