跳到主要内容

Claude Code

Claude Code 通过三个 Anthropic 环境变量连接 PopGo API。

配置前先确认​

  • 本页只写占位符；实际 Key 从 PopGo API 密钥页复制，模型从模型与价格页复制。
  • 一键配置适合已安装并注册协议的软件；浏览器提示打开外部应用时，需要允许一次。
  • 手动配置时先保存一个最小 Provider，首个请求成功后再启用流式、工具调用或多模型路由。

官方来源与核验​

本页于 2026-07-13 根据官方来源核验 Claude Code 2.1.207。 官方来源. 核验范围是官方环境变量接入方式。

一键配置​

登录 PopGo API 密钥页，在目标 Key 所在行打开操作菜单。公开文档不会生成或展示任何带 Key 的跳转链接。 依次选择 CC Switch 和 Claude。 导入 Claude 配置后，在本地终端确认变量已加载，再启动新会话。

手动配置​

在启动 Claude Code 的同一终端设置以下变量。

export ANTHROPIC_BASE_URL="https://api.popgo.site"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL"
$env:ANTHROPIC_BASE_URL = "https://api.popgo.site"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "YOUR_MODEL"
  • PowerShell 示例只影响当前窗口；如果写入用户环境变量，设置后也要重新打开终端。
  • 不要添加关闭 TLS 校验的变量。证书错误应优先检查本地代理、系统时间和网络拦截。

完整安装与配置流程​

Windows​

  1. 安装 Node.js 22 或更高版本。
  2. 打开新的 PowerShell，确认版本：
node -v
npm -v
  1. 使用 Claude 官方安装器安装，并确认命令可用：
irm https://claude.ai/install.ps1 | iex
claude --version
  1. 如果希望变量长期生效，使用用户环境变量。注意仍然只写占位符：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.popgo.site", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "YOUR_MODEL", "User")
  1. 关闭当前 PowerShell，重新打开新窗口，再检查变量：
echo $Env:ANTHROPIC_BASE_URL
echo $Env:ANTHROPIC_AUTH_TOKEN
  1. 进入项目目录启动：
cd C:\path\to\your\project
claude

macOS / Linux​

  1. 安装 Node.js 22 或更高版本，并确认 node -v 与 npm -v 能输出版本。
  2. 使用 Claude 官方安装器安装：
curl -fsSL https://claude.ai/install.sh | bash
claude --version
  1. 临时测试可以直接 export；长期使用建议写入自己的 shell 配置文件后重新加载：
export ANTHROPIC_BASE_URL="https://api.popgo.site"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL"
  1. 进入项目目录启动。如果异常，先运行诊断：
cd /path/to/your/project
claude
claude doctor

常见现象​

  • claude: command not found：重新打开终端，确认安装目录已经进入 PATH，再按官方安装器重装 Claude Code。
  • 启动后要求登录官方账号：变量没有被当前终端读取到，重新打开终端并检查 ANTHROPIC_BASE_URL。
  • 401：重新复制 Key，确认没有空格，且 Key 没有停用或过期。
  • SSL/证书错误：不要添加关闭 TLS 校验的变量，先检查代理、系统时间和网络环境。

成功判断​

关闭旧会话，在同一终端重新启动 Claude Code 并发送短请求。

常见错误和恢复​

  • 旧终端不会自动获得新变量；设置后必须从同一终端重新启动。
  • 出现 401 时，重新粘贴 YOUR_API_KEY 并检查是否带有首尾空格。
  • 出现 404 时，核对 Base URL 层级，避免客户端重复追加 /v1。