開始之前
5 分鐘快速開始
從登入、API Key、線路選擇到一鍵配置,按最短路徑跑通一次。
Last updated 2026-05-12 | Maintained by TokenPool documentation team
這頁適合第一次使用 TokenPool 的使用者。目標不是解釋所有細節,而是讓你先把工具跑起來。
你需要準備
- 已安裝 Node.js 和 npm。
- 已登入 TokenPool。
- 已有一個可用的 TokenPool API Key。
- 本機能打開終端。
如果還沒有 API Key,先看「API Key」章節,或直接打開控制檯:
text
https://tokenpool.dev/console/api-keys
推薦方式:自動腳本配置 Codex
macOS / Linux:
bash
TOKENPOOL_API_KEY="<你的 TokenPool API Key>" \
TOKENPOOL_BASE_URL="https://api.clawto.link" \
bash -c "$(curl -fsSL 'https://cdn.tokenpool.dev/scripts/codex-install-config.sh')"
Windows PowerShell:
powershell
$env:TOKENPOOL_API_KEY='<你的 TokenPool API Key>'; $env:TOKENPOOL_BASE_URL='https://api.clawto.link'; irm 'https://cdn.tokenpool.dev/scripts/codex-install-config.ps1' | iex
腳本會做這些事:
- 檢查是否已經安裝 Codex CLI。
- 如果沒有安裝,會用 npm 安裝
@openai/codex。 - 寫入
~/.codex/config.toml。 - 寫入
~/.codex/auth.json。 - 備份已有配置文件。
使用 CC Switch
如果你不想手動改配置文件,推薦在控制檯 API Key 列表裡點擊「CC Switch」。它會生成 ccswitch:// 導入連結,把 TokenPool 的 API Key、服務地址和預設模型帶入 CC Switch。
截圖佔位:這裡後續補充「API Key 列表裡的 CC Switch 按鈕」截圖。
驗證是否可用
配置完成後,在任意項目目錄運行:
bash
codex "你好,請用一句話介紹你自己"
如果能正常返回回答,說明 Codex 已經可以通過 TokenPool API 服務工作。
下一步
- 想知道 API Key 從哪裡來:看「API Key」。
- 想手動配置 Codex App / CLI:看「Codex App」和「Codex CLI」。
- 想配置 OpenCode:看「OpenCode」。
- 遇到錯誤:看「常見問題排查」。