Claude Code 的 API 服务器在美国，中国大陆用户需要通过代理或 API 中转才能正常使用。本文覆盖 CLI、VS Code 扩展和桌面 App 三种场景下的代理配置方法，以及通过 Amazon Bedrock / Google Vertex AI 使用 Claude 模型的替代方案。

Claude Code 国内使用指南

Claude Code 调用 Anthropic API（api.anthropic.com），该服务器在美国，中国大陆需要通过代理才能访问。

⚠️ 注意：本文仅介绍技术配置方法，请确保你的访问方式符合所在地区的相关法律法规。

---

Claude Code CLI 代理配置

Claude Code CLI 遵循标准环境变量代理设置：

# 设置代理（临时，当前终端有效）
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

# 然后正常使用 Claude Code
claude "帮我修复这个 bug"

永久配置（加入 ~/.bashrc 或 ~/.zshrc）：

export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

验证代理是否生效：

curl -x http://127.0.0.1:7890 https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

---

API 中转配置

如果你使用国内 Anthropic API 中转服务，可以通过环境变量覆盖 API 端点：

export ANTHROPIC_BASE_URL="https://your-proxy.example.com"
export ANTHROPIC_API_KEY="your-api-key"

或在 ~/.claude/settings.json 中配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-proxy.example.com",
    "ANTHROPIC_API_KEY": "your-api-key"
  }
}

注意：中转服务的稳定性和安全性由提供商负责。推荐使用有效期短、限制 IP 的 API Key 以降低风险。建议在独立开发者社区（如 V2EX）寻找近期评价，不推荐具体服务商。

---

Amazon Bedrock 替代方案

通过 AWS Bedrock 使用 Claude 模型，无需代理，国内 AWS 区域也可使用：

# 安装 AWS CLI 并配置凭据
aws configure

# 在 Claude Code 中使用 Bedrock
export ANTHROPIC_BEDROCK_BASE_URL="https://bedrock-runtime.us-east-1.amazonaws.com"
claude --model claude-sonnet-4-5-20251101 "你好"

详见：Amazon Bedrock 集成

---

Google Vertex AI 替代方案

通过 Google Cloud Vertex AI 使用 Claude 模型：

export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"
export CLOUD_ML_REGION="us-east5"
claude --model claude-sonnet-4-5@20251101 "你好"

详见：Google Vertex AI 集成

---

VS Code 扩展代理配置

VS Code 扩展使用系统代理或 VS Code 的代理设置：

1. 打开 VS Code 设置 → 搜索 http.proxy
2. 填入代理地址：http://127.0.0.1:7890
3. 重启 VS Code

或者在系统层面设置代理后重启 VS Code 即可。

---

桌面 App 代理配置

Claude Code Desktop 使用系统代理：

macOS：系统设置 → 网络 → 代理 → 配置 HTTPS 代理

Windows：设置 → 网络和 Internet → 代理 → 手动代理设置

设置系统代理后重启 Desktop App 即可。

---

常见问题

Q：提示 connection timeout / Could not connect to API？

检查代理是否正在运行，端口号是否正确：

curl -x http://127.0.0.1:7890 https://api.anthropic.com

Q：有没有不需要代理的方案？

使用 Amazon Bedrock 或 Google Vertex AI 是最稳定的替代方案，不依赖代理，按 Token 计费，适合企业场景。

Q：codex 中转和 claude code 中转是同一回事吗？

不是。"Codex 中转"通常指 OpenAI Codex/ChatGPT API 中转；Claude Code 使用 Anthropic API，需要的是 api.anthropic.com 的代理或中转。两者 API Key 和端点完全不同。详见 Codex 国内使用指南。

---

相关文档

• Claude Code 安装
• Claude Code 快速开始
• Amazon Bedrock 集成
• Google Vertex AI 集成
• Codex 国内使用指南