Claude Code 接入

    若您已安裝 Claude Code（Anthropic 終端 / IDE 中的 AI 程式助手），請依下列步驟接入 Gate.AI。

    1. 建立 Gate.AI API 金鑰

    1. 進入 控制台 → 設定 → API 金鑰，建立金鑰。
    2. 複製以 sk-v1- 開頭的金鑰，並於後續步驟替換占位符。
    3. 若需 自動路由 ： 控制台 → 設定 → 路由 → 開啟「自動路由」。關閉時需在請求中明確指定模型 ID。

    2. 設定 Anthropic Base URL 與 API Key

    Claude Code 會讀取環境變數；建議與官方 LLM gateway 說明一致，設定：

    變數值
    ANTHROPIC_BASE_URLhttps://api.gate.ai/anthropic
    ANTHROPIC_API_KEY您的 Gate.AI API 金鑰（sk-v1-…）

    方式 A：目前終端機工作階段（暫時）

    bash
    1export ANTHROPIC_BASE_URL="https://api.gate.ai/anthropic"2export ANTHROPIC_API_KEY="sk-v1-xxxxxxxxxxxxxxxx"3claude

    方式 B：寫入 Shell 設定檔

    將下列內容附加到 ~/.zshrc 或 ~/.bashrc：

    bash
    1export ANTHROPIC_BASE_URL="https://api.gate.ai/anthropic"2export ANTHROPIC_API_KEY="sk-v1-xxxxxxxxxxxxxxxx"

    執行 source ~/.zshrc（或重新開啟終端機）後，再執行 claude。

    方式 C：Claude Code settings.json（建議）

    在使用者層級或專案層級設定中寫入 env（路徑見 Claude Code settings），例如 專案目錄下 .claude/settings.json：

    json
    1{2  "env": {3    "ANTHROPIC_BASE_URL": "https://api.gate.ai/anthropic",4    "ANTHROPIC_API_KEY": "sk-v1-xxxxxxxxxxxxxxxx"5  }6}

    安全提示：請勿將真實金鑰提交至公開儲存庫；可使用各作業系統的密鑰管理或 CI 密鑰注入，本機僅以環境變數保存。

    恢復直連 Anthropic 官方

    若需暫時繞過閘道：

    bash
    1env -u ANTHROPIC_BASE_URL -u ANTHROPIC_API_KEY claude

    （需已設定 Anthropic 官方帳號或其它預設憑證。）

    3. 設定模型（Gate.AI 模型 ID）

    Gate.AI 文件中的模型 ID 形如 provider/model-name（如 anthropic/claude-sonnet-4.6），與 Claude Code 內建別名（如 sonnet）不完全相同。擇一即可：

    3.1 以環境變數指定預設模型

    bash
    1export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"

    或在 settings.json 的 env 中新增同名鍵。

    3.2 使用別名對應

    將別名對應到 Gate.AI 的模型 ID（以下為 Sonnet 範例）：

    bash
    1export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"2export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.6"3export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"

    實際 ID 以 Gate.AI 文件－模型 清單為準。

    3.3 在 /model 中選自訂項目

    若需在介面中選擇閘道端模型，可使用 Claude Code 的自訂模型項目（見官方 Model configuration - ANTHROPIC_CUSTOM_MODEL_OPTION）：

    bash
    1export ANTHROPIC_CUSTOM_MODEL_OPTION="anthropic/claude-sonnet-4.6"2export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet（Gate.AI）"

    3.4 自動路由模型 auto

    若已在控制台開啟自動路由，可嘗試將 ANTHROPIC_MODEL 設為 auto（與 OpenAI 接入頁的 auto 語意一致）。若遇錯誤，請改回明確模型 ID（如 anthropic/claude-sonnet-4.6）。

    4. 驗證接入是否成功

    1. 在已設定環境的終端機執行：
    bash
    1claude
    1. 進入工作階段後輸入簡單指令，例如：請用一句話介紹你自己。
    2. 若回覆正常且無鑑權/路由錯誤，即表示請求已到達 Gate.AI 並由所選模型回應。

    5. 常見問題

    現象可能原因處理建議
    401 / 鑑權失敗API Key 錯誤或未匯出檢查 ANTHROPIC_API_KEY，與控制台金鑰一致
    404 on URLBase URL 誤用 OpenAI 路徑使用 https://api.gate.ai/anthropic
    模型不存在 / 路由錯誤模型 ID 格式錯誤或控制台未允許該模型對照文件「模型」表；檢查控制台路由與允許清單
    仍走官方 Anthropic環境變數未生效確認 settings.json 位置層級；或在新 shell 中 echo $ANTHROPIC_BASE_URL 驗證