10.1 国内网络稳定使用方案

网络需求分析

Claude Code 需要访问 Anthropic 的 API 服务（api.anthropic.com）以及 Claude.ai 网页进行身份认证。国内直接访问存在以下问题：

API 请求被阻断或极不稳定
OAuth 登录无法完成浏览器跳转
订阅制用户的 Web 控制台无法访问

方案一：系统级代理

最通用方案，通过系统环境变量让 Claude Code 走代理：

# 在 ~/.bashrc 或 ~/.zshrc 中添加
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 替换为你实际的代理地址和端口

适用于：Clash、V2Ray、Shadowsocks 等代理工具。

验证代理是否生效

curl -x http://127.0.0.1:7890 https://api.anthropic.com/v1/models
# 如果返回 JSON 说明代理正常

方案二：API 中转（推荐国内开发者）

使用国内 API 中转服务（如硅基流动、火山引擎等），绕过直接访问 Anthropic API 的网络问题。详见下一节「3.2 API 中转配置」。

方案三：云厂商部署（企业用户）

通过 Amazon Bedrock、Google Vertex AI 或 Azure Foundry 部署 Claude，不需要访问 Anthropic 直连 API：

# Bedrock 配置示例
export CLAUDE_CODE_USE_BEDROCK=1
aws configure

# Vertex AI 配置示例
export CLAUDE_CODE_USE_VERTEX=1
gcloud auth application-default login

WSL2 / 容器环境特殊处理

在 WSL2 或 Docker 容器中使用 Claude Code 时，如果浏览器无法完成 OAuth 回调，可以使用「登录码粘贴」方式：

运行 claude login，浏览器打开登录页面
如果浏览器无法跳转回终端，页面会显示一串登录码
在终端输入字母 c 复制登录码，或直接复制页面显示的 URL
将登录码粘贴回终端完成认证

代理工具分流配置

如果使用 Clash 等工具，建议配置分流规则：

# Clash 分流规则示例
proxy-providers:
  myProxy:
    type: http
    url: "你的代理订阅地址"
    interval: 3600

rules:
  - DOMAIN-SUFFIX,anthropic.com,myProxy
  - DOMAIN-SUFFIX,claude.ai,myProxy
  - DOMAIN-SUFFIX,anthropic.com.cn,myProxy

常见问题

代理已开启但仍然连接失败：检查是否是 SOCKS5 代理，Claude Code 需要 HTTP/HTTPS 代理
登录时浏览器白屏：尝试禁用浏览器扩展，或换用无痕模式
API 请求超时：尝试换一个代理节点，或升级代理带宽

« 9.3 GitLab CI/CD 集成 10.2 API 中转配置 »