Claude Code 自定义 Base URL 配置教程

Claude Code 是 Anthropic 推出的 AI 编程助手，支持通过 ANTHROPIC_BASE_URL 环境变量连接自定义 API 端点。本文介绍完整配置流程。

为什么需要自定义 Base URL？

• 使用 API 中转服务，提高访问稳定性
• 企业统一管理 API 调用和成本
• 在网络受限环境中使用 Claude Code

CLI 配置方法

Linux / macOS

# 设置环境变量
export ANTHROPIC_AUTH_TOKEN="your-api-key"
export ANTHROPIC_BASE_URL="https://claude4u.com/antigravity"

# 启动 Claude Code
claude

Windows PowerShell

$env:ANTHROPIC_AUTH_TOKEN="your-api-key"
$env:ANTHROPIC_BASE_URL="https://claude4u.com/antigravity"
claude

Windows CMD

set ANTHROPIC_AUTH_TOKEN=your-api-key
set ANTHROPIC_BASE_URL=https://claude4u.com/antigravity
claude

VS Code 配置

在 VS Code 中使用 Claude Code 扩展时，创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://claude4u.com/antigravity"
  }
}

高级配置

通过额外的环境变量，你可以定制 Claude Code 的行为：

export ANTHROPIC_AUTH_TOKEN="your-api-key"
export ANTHROPIC_BASE_URL="https://claude4u.com/antigravity"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-opus-4-6-thinking"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-opus-4-6-thinking"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6-thinking"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="1000000"
export API_TIMEOUT_MS="300000"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

常见问题

ANTHROPIC_BASE_URL 不生效？

• 确保在启动 Claude Code 之前设置环境变量
• 检查 URL 末尾不要有多余的 /
• VS Code 扩展需要在 ~/.claude/settings.json 中配置

连接超时？

增加超时时间：export API_TIMEOUT_MS="300000"（5分钟）

Ollama 本地模型？

Claude Code 使用 Anthropic API 格式，不直接兼容 Ollama。建议使用支持 Anthropic 格式的中转服务。