Claude Code CLI 接入

    建立 Gate.AI API 金鑰

    1. 打開 gate.ai → 控制台 → API 金鑰，建立並複製 sk-v1-… 開头的 Key
    2. 確認帳戶有餘額

    網路连通性驗證

    將 GATEAI_API_KEY 替換為您的金鑰：

    bash
    1export GATEAI_API_KEY="sk-v1-xxxxxxxxxxxxxxxx"

    Anthropic 相容端點（Claude Code）：

    bash
    1curl -s -o /dev/null -w "%{http_code}" \2  -H "x-api-key: $GATEAI_API_KEY" \3  -H "content-type: application/json" \4  -H "anthropic-version: 2023-06-01" \5  -d '{"model":"anthropic/claude-sonnet-4.6","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \6  https://api.gate.ai/anthropic/v1/messages
    • 回傳 200：閘道连通，可繼續安裝與設定
    • 回傳 401：金鑰無效或已過期，請檢查控制台
    • 連線逾時：檢查本地網路或 DNS；確認未誤用 https://api.gate.ai/v1

    安裝 Claude Code CLI

    macOS / Linux / WSL（推薦）：

    bash
    1curl -fsSL https://claude.ai/install.sh | bash

    或使用 npm：

    bash
    1npm install -g @anthropic-ai/claude-code

    若 npm 安裝失敗

    通常是因為訪問 registry.npmjs.org 逾時或不穩定，與 Gate.AI 閘道無關。可按需選用以下方式：

    方式 A：單次安裝臨時指定鏡像（推薦先試）

    bash
    1npm install -g @openai/codex --registry=https://registry.npmmirror.com2npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

    方式 B：全域永久切換鏡像

    bash
    1# 設為 npmmirror（原淘宝 npm 鏡像，國內常用）2npm config set registry https://registry.npmmirror.com34# 驗證當前鏡像5npm config get registry67# 然後重新安裝8npm install -g @openai/codex9npm install -g @anthropic-ai/claude-code

    方式 C：僅當前終端工作階段臨時生效

    bash
    1export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com2npm install -g @openai/codex
    現象處理
    ETIMEDOUT / ECONNRESET使用方式 A 或 B 切換鏡像後重试
    EACCES 權限錯誤設定 npm 全域目录：mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global，並將 export PATH=~/.npm-global/bin:$PATH 寫入 ~/.zshrc
    command not found: claude / codex安裝成功但 PATH 未生效：重新啟動終端，或檢查 npm config get prefix 下的 bin 是否在 PATH 中

    設定模型

    將下文所有 sk-v1-你的金鑰 替換為您的真實 Key。設定完成後無需重複執行，除非更換 Key 或模型。

    bash
    1mkdir -p ~/.claude23cat > ~/.claude/settings.json <<'EOF'4{5  "env": {6    "ANTHROPIC_BASE_URL": "https://api.gate.ai/anthropic",7    "ANTHROPIC_API_KEY": "sk-v1-你的金鑰",8    "ANTHROPIC_MODEL": "anthropic/claude-sonnet-4.6"9  },10  "includeCoAuthoredBy": false11}12EOF1314# 若曾登入 Anthropic / 本地代理，清除舊 session，避免認證衝突15claude /logout 2>/dev/null || true16unset ANTHROPIC_AUTH_TOKEN

    認證信息建議只寫在 settings.json 一處；若 ~/.zshrc 中仍有 ANTHROPIC_AUTH_TOKEN 或重複的 ANTHROPIC_API_KEY，請註解或刪除。

    驗證接入是否成功

    進入專案目录，啟動 CLI，即可在終端内進行 AI 輔助程式。

    使用 claude

    bash
    1claude

    首次驗證：輸入 /status，確認 Base URL 為 https://api.gate.ai/anthropic，Auth token 為 ANTHROPIC_API_KEY。

    進階設定

    認證衝突處理

    若出現 Auth conflict: Both a token (ANTHROPIC_AUTH_TOKEN) and an API key (ANTHROPIC_API_KEY) are set：

    場景處理
    曾用 Anthropic OAuth / 本地代理登入claude /logout，退出後重新 claude
    Shell 與 settings 同時設定了 Token 和 Key只保留 ANTHROPIC_API_KEY；註解 ~/.zshrc 中的 ANTHROPIC_AUTH_TOKEN

    備選設定方式

    Shell 環境變數（勿與 settings.json 重複設定）：

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

    專案级 settings（團隊共用結構，勿提交真實 Key）：

    路徑用途
    .claude/settings.json專案级，可提交（不含金鑰）
    .claude/settings.local.json專案本地 Key，加入 .gitignore

    模型環境變數

    可在 settings.json 的 env 块中追加：

    变量用途範例
    ANTHROPIC_DEFAULT_SONNET_MODELSonnet 級任務anthropic/claude-sonnet-4.6
    ANTHROPIC_DEFAULT_OPUS_MODELOpus 級任務anthropic/claude-opus-4.6
    ANTHROPIC_DEFAULT_HAIKU_MODELHaiku 級任務anthropic/claude-haiku-4.5
    CLAUDE_CODE_SUBAGENT_MODEL子 Agent 任務anthropic/claude-sonnet-4.6

    完整列表見 模型廣場。若 auto 報錯，請改回顯式模型 ID。

    恢復直連 Anthropic 官方（可選）

    bash
    1env -u ANTHROPIC_BASE_URL -u ANTHROPIC_API_KEY claude

    故障排除

    Base URL 常見錯誤

    bash
    1# ❌ 錯誤（缺 /anthropic 前綴，404）2https://api.gate.ai/v13https://api.gate.ai/v1/chat/completions45# ❌ 錯誤（Claude 設定項不要写完整 API 路徑）6https://api.gate.ai/anthropic/v1/messages7https://api.gate.ai/anthropic/messages89# ✅ 正確10https://api.gate.ai/anthropic/v111https://api.gate.ai/anthropic          # Claude Code CLI12https://api.gate.ai/anthropic/v1/messages  # curl 驗 Key（Anthropic）13https://api.gate.ai/openai/v1/responses    # curl 驗 Key（Codex）
    • /openai/v1/chat/completions 可用，但 Codex 必须走 Responses API；若报 404 on /responses，檢查 wire_api = "responses"，不是改 URL。
    • /openai/v1/models 不校驗 Key（無效 Key 也可能 200）；驗 Key 請用上面兩個 curl 地址。

    現象速查表

    現象錯誤類型處理建議
    Auth conflict 警告認證衝突執行 claude /logout；只保留 ANTHROPIC_API_KEY，刪除或註解 ANTHROPIC_AUTH_TOKEN
    401 / 鑑權失敗鑑權錯誤檢查 Key 是否正確、是否過期
    404 on URL路徑錯誤Claude → https://api.gate.ai/anthropic；Codex → https://api.gate.ai/openai/v1。勿用 https://api.gate.ai/v1/...
    模型不存在模型 ID 錯誤使用 provider/model-name 格式（如 anthropic/claude-sonnet-4.6、openai/gpt-5.2），對照模型廣場
    仍連官方網域設定未生效確認寫在用戶級設定：Claude → ~/.claude/settings.json；Codex → ~/.codex/config.toml（專案级 .codex/config.toml 無法覆寫閘道設定）
    顯示 offlineCLI 自身行為不影響主對話，屬 Claude Code 自身行為，可忽略
    402 / 429配額 / 限流充值或檢查 Key 預算與呼叫頻率
    npm 安裝失敗網路 / 權限見「若 npm 安裝失敗」