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 安装失败」