Agent 快速接入
在 Gemini CLI 中接入 Tokatlas
設定 Gemini CLI 使用的 Tokatlas 金鑰、端點與已開通模型。
接入前提
本指南為條件式設定說明。須先向 Tokatlas 確認帳戶可用的原生 Gemini generateContent 端點與模型；僅支援 Interactions 的路由無法直接用於 Gemini CLI。確認後再執行下方步驟。
開始之前
依官方安裝指南準備 Node.js，再執行 npm install -g @google/gemini-cli。
準備 Tokatlas API Key 與帳戶已開通模型。替換全部 YOUR_... 佔位值，合併設定前先備份既有內容。
連線設定
| 設定 | 內容 |
|---|---|
| 提供方名稱 | Tokatlas |
| 協定 | Gemini generateContent |
| 端點 | 請見下方相容性要求 |
| API Key | YOUR_TOKATLAS_API_KEY |
| Model ID | YOUR_TOKATLAS_MODEL_ID |
設定步驟
- 先確認 Tokatlas 路由提供原生 Gemini
generateContent與串流操作，只有 Interactions API 並不足夠。 - 取得已確認的 Gemini Base URL 後，設定下列變數，並在 Gemini CLI 選擇 API Key 驗證。
- 選擇已開通的 Gemini 模型，測試簡短請求，並在閘道記錄確認請求目的地。
設定範例
bash
export GEMINI_API_KEY="YOUR_TOKATLAS_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://YOUR_CONFIRMED_GEMINI_GATEWAY_BASE"
gemini相容性說明
目前文件庫尚未確認 Tokatlas 原生 Gemini CLI 相容性。不要將 /v1beta/interactions 填為 Base URL，也不要以 Chat Completions 代替。此覆寫適用 Gemini API Key 驗證，不適用 Google 帳號或 Vertex 驗證。PowerShell 使用 $env:NAME = "value"。
驗證與排錯
- 開啟新對話，傳送「只回覆 OK」，確認收到文字回覆。
- 到 Tokatlas 用量記錄確認同一時間有成功請求，且模型符合設定。
- 需要工具時，再請客戶端列出測試目錄中的檔案；確認工具結果有回到對話。
- 若第一步失敗，先依 API 使用入門直接測試金鑰與模型。直接呼叫成功後，再依下表排查客戶端設定。
| 問題 | 檢查項目 |
|---|---|
401／403 | 重新貼上 Tokatlas 金鑰，移除引號與空白，核對驗證模式及模型權限。 |
404 | 對照上表檢查完整 URL，移除重複的 /v1 或端點後綴。 |
| 未知模型 | 從可用列表複製完整 ID，儲存後在新對話中選取該模型。 |
| 工具失敗 | 模型能力與客戶端協定支援。 |
| 變更未生效 | 切換至 Tokatlas 提供方／profile，完全退出客戶端後重新開啟。 |