国内使用指南
国内用户使用 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 命令即可正常使用。