Claude Code

Claude Code 是 Anthropic 的终端编程 Agent。把它指向 ApiGo 的 Anthropic 兼容网关后，请求会走你的 ApiGo Key、路由与计费，而不是直连 Anthropic 官方账号。

前置条件

已安装 Claude Code（官方安装指南）
在工作空间 → API Keys 创建的 ApiGo API 密钥
记住 Anthropic 路径的 Base URL 是 https://api.apigo.ai（不要写成带 /v1 的 OpenAI 地址）

安装 Claude Code

macOS、Linux、WSL（推荐）：

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

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew：

brew install --cask claude-code

WinGet：

winget install Anthropic.ClaudeCode

或使用 npm（需要 Node.js 18+）：

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

连接到 ApiGo

先清除可能冲突的 Anthropic 环境变量，避免旧配置覆盖：

unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_API_KEY

方式 A：Shell 配置（个人机器推荐）

写入 ~/.zshrc 或 ~/.bashrc：

export APIGO_API_KEY="sk-apigo-..."
export ANTHROPIC_BASE_URL="https://api.apigo.ai"
export ANTHROPIC_AUTH_TOKEN="$APIGO_API_KEY"
export ANTHROPIC_API_KEY=""   # 必须显式置空，防止与 AUTH_TOKEN 冲突

保存后执行 source ~/.zshrc（或重启终端）。

方式 B：Claude 配置文件

编辑全局配置：

macOS / Linux：~/.claude/settings.json
Windows：%USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apigo.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-apigo-...",
    "ANTHROPIC_API_KEY": ""
  }
}

也可把同样的 env 写到项目级 .claude/settings.local.json，方便按仓库共享（不要把真实 Key 提交到 Git）。

不要写进项目根目录的 .env——Claude Code 原生安装器不会读取它。

若 Claude Code 持续要求 Anthropic 登录，在 ~/.claude.json 中标记已完成引导：

{
  "hasCompletedOnboarding": true
}

说明：环境变量优先级高于配置文件。

清除缓存的 Anthropic 登录

若曾用 Anthropic 账号登录过 Claude Code，需要先退出缓存会话，再启动，否则可能出现难排查的「模型找不到」类错误：

> /logout

然后完全退出 claude 并重新打开。

开始会话

cd /path/to/your/project
claude

首次进入目录时，按提示选择 信任此文件夹（Trust This Folder），允许 Claude Code 访问当前项目文件。

自检：

在会话中执行 /status，确认已连上自定义网关。
发一句简短提示（例如「用一句话介绍当前目录」）。
打开工作空间 → Call Logs，确认出现对应请求。

故障排除

现象	处理
启动时鉴权失败 / 模型找不到	执行 `/logout`，确保 `ANTHROPIC_API_KEY` 为空后重启
仍直连 Anthropic	检查 shell 导出，移除冲突的 `ANTHROPIC_*`；确认 `ANTHROPIC_BASE_URL` 为 `https://api.apigo.ai`
ApiGo 返回 401	在 API 密钥轮换或重建 Key
Call Logs 无记录	Base URL 写错，或终端未 `source` 最新环境变量