Claude Code Base URL 配置教程

Claude Code 使用 Anthropic 原生接口协议，需要通过 ANTHROPIC_BASE_URL 环境变量来指定 API 端点地址，这和 OpenAI SDK 的 Base URL 不是同一个配置。国内开发者在网络受限环境下无法直连 Anthropic 官方端点，可以将 ANTHROPIC_BASE_URL 设置为 https://api.quickrouter.ai，通过 QuickRouter 的中转服务在国内直连使用 Claude Code。注意：Claude Code 的 Base URL 不带 /v1 后缀。

立即免费体验查看 API 文档

配置前准备

1Node.js ≥ 18.0 已安装

2注册 QuickRouter 账号，进入 API令牌页面，点击添加令牌，选择分组 "Claude code专属" 或 "官转克劳德3及以上"，获取以 sk- 开头的 API Key

3确认 Claude Code CLI 已安装并可以正常运行

配置方法

macOS/Linux：设置环境变量并写入 Shell 配置文件

.bashrc

# ── macOS / Linux ──
# 添加到 ~/.bashrc 或 ~/.zshrc
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://api.quickrouter.ai"
export API_TIMEOUT_MS="300000"

# 保存后执行 source 使配置生效
source ~/.bashrc  # 或 source ~/.zshrc

# 验证环境变量是否设置成功
test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set"
test -n "$ANTHROPIC_BASE_URL" && echo "ANTHROPIC_BASE_URL is set"

Windows PowerShell：使用 setx 设置永久环境变量

powershell

# ── Windows PowerShell ──
# 使用 setx 设置永久环境变量（设置后需重启终端）
setx ANTHROPIC_AUTH_TOKEN "sk-your-api-key"
setx ANTHROPIC_BASE_URL "https://api.quickrouter.ai"
setx API_TIMEOUT_MS "300000"

# 验证（需重启终端后生效）
IF DEFINED ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set

Windows CMD：使用 set 命令设置当前会话环境变量

cmd

# ── Windows CMD ──
set ANTHROPIC_AUTH_TOKEN=sk-your-api-key
set ANTHROPIC_BASE_URL=https://api.quickrouter.ai
set API_TIMEOUT_MS=300000

# 验证
IF DEFINED ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set

在终端运行 claude 命令，验证连接是否正常

terminal

# 启动 Claude Code
claude

工具适配说明

✓

macOS / Linux在 ~/.bashrc 或 ~/.zshrc 中添加环境变量，然后 source ~/.bashrc 使其生效

✓

Windows PowerShell$env:ANTHROPIC_AUTH_TOKEN = "sk-..."; $env:ANTHROPIC_BASE_URL = "https://api.quickrouter.ai"; $env:API_TIMEOUT_MS = "300000"

✓

Windows CMD使用 set 命令设置环境变量（不需要引号），设置完成后运行 claude 启动

常见问题

Claude Code Base URL 应该怎么填？▾

Claude Code 使用 ANTHROPIC_BASE_URL 环境变量来指定 API 端点。如果使用 QuickRouter，应设置为 https://api.quickrouter.ai。注意不要添加 /v1 后缀，也不要在末尾加斜杠。Claude Code 使用 Anthropic 原生协议，路径规则和 OpenAI SDK 不同。

ANTHROPIC_BASE_URL 和 OpenAI Base URL 有什么区别？▾

ANTHROPIC_BASE_URL 是 Claude Code 专用的环境变量，指向 Anthropic 协议的端点，不需要 /v1 后缀。OpenAI Base URL 是 OpenAI SDK 的参数，通常需要包含 /v1 后缀（如 https://api.quickrouter.ai/v1）。两者协议不同，不能混用。

Claude Code 报 401 怎么办？▾

401 表示认证失败。请检查 ANTHROPIC_AUTH_TOKEN 是否正确填写（以 sk- 开头），确认 API Key 没有过期或被禁用。如果使用 QuickRouter，确保在控制台的 API 令牌页面选择了正确的令牌分组。

Claude Code 报 404 怎么办？▾

404 通常表示 API 端点路径不正确。请确认 ANTHROPIC_BASE_URL 设置为 https://api.quickrouter.ai（不带 /v1、不带末尾斜杠）。如果是在 OpenAI SDK 场景报 404，则 Base URL 需要带 /v1。两者不要混淆。

Claude Code 配置后怎么验证是否生效？▾

在终端运行 claude 命令启动 Claude Code，如果能看到正常的交互界面并能发送消息，说明配置已生效。也可以先用 test -n "$ANTHROPIC_AUTH_TOKEN" 检查环境变量是否存在。如果启动后报连接错误，检查环境变量和网络设置。

Claude Code Base URL 配置教程

配置前准备

配置方法

工具适配说明

常见问题

相关链接