跳到主要内容

使用 Claude Code

本文说明如何让 Claude Code 通过 ClawdRouter 的 Anthropic 兼容接口调用模型，适用于 Windows、macOS、Linux 和 WSL。

准备工作​

  • API Key。
  • 可调用的 Claude 兼容模型 ID。
  • 已安装 Claude Code。

1. 安装 Claude Code​

Windows PowerShell：

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

macOS、Linux 或 WSL：

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

安装完成后，重新打开终端并执行：

claude --version

2. 设置连接信息​

Claude Code 使用 Anthropic 兼容协议。设置后，请在同一个终端中启动 Claude Code。

Windows PowerShell​

$env:ANTHROPIC_BASE_URL = "__DOCS_API_ORIGIN__"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_API_KEY = ""
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "YOUR_MODEL_ID"

macOS、Linux 或 WSL​

export ANTHROPIC_BASE_URL="__DOCS_API_ORIGIN__"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_SONNET_MODEL="YOUR_MODEL_ID"

请将 YOUR_API_KEY 和 YOUR_MODEL_ID 替换为真实值。ANTHROPIC_API_KEY 必须保留为空，以避免与其他登录方式冲突。


3. 清理已有登录（如需要）​

如果此前已使用 Anthropic 账号登录 Claude Code，请启动 Claude Code 后执行：

/logout

然后退出 Claude Code，关闭终端并重新设置第 2 步的环境变量。

4. 启动并验证​

进入代码项目目录后执行：

claude

在 Claude Code 内执行：

/status

确认认证来源为 ANTHROPIC_AUTH_TOKEN，并确认已使用配置的 Base URL。


模型配置​

如需为不同任务指定模型，可额外设置以下环境变量：

ANTHROPIC_DEFAULT_OPUS_MODEL="YOUR_MODEL_ID"
ANTHROPIC_DEFAULT_SONNET_MODEL="YOUR_MODEL_ID"
ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_MODEL_ID"
CLAUDE_CODE_SUBAGENT_MODEL="YOUR_MODEL_ID"

只需配置实际需要的变量；所有模型均应是当前 API Key 可调用的模型。

常见问题​

出现认证冲突或模型找不到​

执行 /logout 清除旧登录，并确认 ANTHROPIC_API_KEY 显式为空，然后重新启动终端和 Claude Code。

401 Unauthorized 或 403 Forbidden​

请检查 ANTHROPIC_AUTH_TOKEN 中的 API Key。401 表示 Key 无效，403 通常表示 Key 没有模型权限。

模型调用失败​

确认 YOUR_MODEL_ID 与服务端模型名称一致，并使用兼容 Anthropic Messages 协议的模型。

配置了环境变量但没有生效​

环境变量必须在启动 claude 前设置。关闭当前终端后重新打开，重新设置变量再启动。

连接超时或无法访问服务​

检查网络、代理、防火墙，以及 ANTHROPIC_BASE_URL 是否被误改。

相关链接​