Claude 国内使用完整指南：网络配置与访问方案

Claude Code 需要连接 Anthropic 的 API 服务器（api.anthropic.com），在中国大陆访问这个地址需要一些额外配置。这篇文章整理了几种可行的方案，根据你的实际情况选择。

检查是否能直接访问

先测试你当前的网络环境：

curl -I https://api.anthropic.com

如果返回 200 或 401，说明可以直接访问，不需要额外配置，跳过本文即可。

如果超时或连接被拒绝，需要按照以下方案配置。

方案一：配置 HTTP 代理（最常用）

如果你已经有可用的代理服务，最简单的方式是让 Claude Code 通过代理访问。

设置代理环境变量

# 设置代理（替换为你实际的代理地址和端口）
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

# 运行 Claude Code
claude

常见代理工具的默认端口：

Clash：7890
V2rayN：通常是 10809 或自定义
Surge：通常是 6152

永久配置代理

把代理设置加入 shell 配置文件，这样不需要每次手动设置：

# 加入 ~/.zshrc 或 ~/.bashrc
cat >> ~/.zshrc << 'EOF'
# Claude Code 代理配置
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
EOF

source ~/.zshrc

验证代理是否生效

# 通过代理测试连接
curl -I https://api.anthropic.com -x http://127.0.0.1:7890

方案二：使用 API 中转服务

如果没有代理，可以使用第三方 API 中转服务，这些服务会把你的请求转发到 Anthropic API。

配置 API 中转

Claude Code 支持通过环境变量配置自定义 API 地址：

# 设置 API Base URL（替换为你的中转服务地址）
export ANTHROPIC_BASE_URL="https://你的中转服务地址"
export ANTHROPIC_API_KEY="你的Key"

claude

使用第三方兼容服务

部分第三方服务提供与 Anthropic API 兼容的接口，可以直接替换 Base URL。在购买或使用时请注意：

选择有口碑、有实名认证的服务商
了解清楚费率计算方式
注意数据隐私：你的代码会经过第三方服务器
不要在非个人项目或含敏感数据的项目里使用

方案三：自建 API 代理（适合团队）

如果你有境外服务器，可以自建简单的代理来转发 API 请求，适合团队统一使用。

用 Nginx 做简单代理

在境外服务器上配置 Nginx：

server {
    listen 443 ssl;
    server_name your-proxy.example.com;

    # SSL 配置（需要证书）
    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass https://api.anthropic.com;
        proxy_set_header Host api.anthropic.com;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

团队成员配置：

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

安装时的网络问题

npm 安装速度慢

安装 Claude Code 时如果网络慢，切换到国内 npm 镜像：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

或者永久切换：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

设置 npm 代理

如果切换镜像还是慢，让 npm 也走代理：

npm config set proxy http://127.0.0.1:7890
npm config set https-proxy http://127.0.0.1:7890
npm install -g @anthropic-ai/claude-code

# 安装完后取消 npm 代理（避免影响其他包）
npm config delete proxy
npm config delete https-proxy

常见连接问题排查

问题：`ECONNREFUSED` 或 `ETIMEDOUT`

代理没有启动或端口不对：

# 检查代理是否在监听
curl -v http://127.0.0.1:7890

# 确认代理进程是否运行
lsof -i :7890    # macOS/Linux
netstat -ano | findstr 7890    # Windows

问题：`SSL certificate problem`

证书验证失败，通常是代理拦截了 HTTPS：

# 临时跳过 SSL 验证（不推荐长期使用）
export NODE_TLS_REJECT_UNAUTHORIZED=0
claude

更好的解决方式是配置代理工具信任 Claude Code 的目标域名，不拦截 api.anthropic.com。

问题：连接时断时续

API 请求偶尔超时，增加超时时间：

export ANTHROPIC_TIMEOUT=60000   # 60 秒（默认可能更短）
claude

网络配置最佳实践

个人使用：

配置好代理后通过 HTTPS_PROXY 环境变量使用
把代理配置写进 .zshrc/.bashrc 避免每次手动设置

团队使用：

建议自建代理，避免每个人都配置不同的代理
API Key 统一管理，不同用途的 Key 分开
考虑在海外服务器上跑 Claude Code，绕过网络限制

企业使用：

考虑 Anthropic 企业版（可以申请合规的访问方式）
通过 Amazon Bedrock 或 Google Vertex AI 访问 Claude 模型（有国内可用的云区域）

验证配置完成

所有配置就绪后，运行以下命令验证是否可以正常使用：

claude -p "你好，请用中文回复"

如果 Claude Code 正常回复，说明网络配置成功，可以开始正常使用了。