国内使用指南

国内用户使用 Claude Code 的配置方法

背景

由于网络限制,国内用户直接使用 Claude Code 可能遇到连接问题。本文介绍如何通过配置绕过这些限制。

绕过登录验证

安装 Claude Code 后,运行 claude 命令会在用户目录创建 .claude 目录。

配置文件位置:

  • macOS/Linux: ~/.claude/settings.json
  • Windows: 用户主文件夹下的 .claude/settings.json

创建或编辑 settings.json,以 GLM 为例:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

配置 ANTHROPIC_BASE_URL 为国内大模型地址后,Claude Code 将连接国内服务而非 Anthropic。

保存后重新运行 claude 命令,将直接进入对话界面,无需登录。

解决连接错误

如果遇到以下错误:

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR BAD REQUEST

需要编辑 .claude.json 文件(与 .claude 目录同级),添加:

{
  "hasCompletedOnboarding": true
}

保存后重新运行 claude 命令即可正常使用。

On this page