¶ Claude Code 安装与第三方网关配置教程
本教程基于当前这台机器（macOS + Homebrew + Node.js）已经验证通过。
¶ 1. 安装 Claude Code
npm install -g @anthropic-ai/claude-code@latest
claude --version
预期输出类似：
2.1.72 (Claude Code)
¶ 2. 写入全局配置文件
配置文件路径：~/.claude/settings.json（windows的话是C:\Users\你的用户名\.claude`settings.json`）（这里的key如果对应的分组时GPT，opus自动映射成gpt-5.5、sonnet自动映射为gpt-5.4）
{
"model": "claude-opus-4-7",
"env": {
"ANTHROPIC_BASE_URL": "https://lemonzz.xyz",
"ANTHROPIC_API_KEY": "<你的 API Key>",
"ANTHROPIC_CUSTOM_HEADERS": "claude-opus-4-7",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"DISABLE_TELEMETRY": "1",
"DISABLE_ERROR_REPORTING": "1",
"CLAUDE_CODE_DISABLE_FAST_MODE": "1"
}
}
建议设置权限：
chmod 600 ~/.claude/settings.json
windows按照下图来就行：
¶ 3. 首次启动连通性报错的修复
如果启动 claude 时出现：
Unable to connect to Anthropic servicesFailed to connect to ``api.anthropic.com``: ERR_BAD_REQUEST
原因通常是首次向导里的 preflight 检测会直接探测 api.anthropic.com，而你当前走的是第三方网关。
解决方式：将全局状态标记为已完成 onboarding。
配置文件路径：~/.claude.json(windows只用配置这个文件即可，windows默认文件权限很高可以看下图）
确保至少包含：
{
"hasCompletedOnboarding": true,
"lastOnboardingVersion": "2.1.72",
"theme": "dark"
}
可执行命令：（windows可以不执行）
tmp=$(mktemp)
jq '.hasCompletedOnboarding = true | .lastOnboardingVersion = "2.1.72" | .theme = "dark"' ~/.claude.json > "$tmp" && mv "$tmp" ~/.claude.json
chmod 600 ~/.claude.json
¶ 4. 验证是否配置成功
在命令行输入claude,首先点击回车然后到如下界面：选择 yes
然后就配置好了。（如果之前使用过官方登录的话先/logout 再/login走一遍流程）
¶ 5. 当前机器已完成的实际配置
已安装：
claude命令路径：/opt/homebrew/bin/claude- 版本：
2.1.72
已配置文件：
~/.claude/settings.json~/.claude.json
¶ 6. 常见问题排查
¶ 6.1 仍提示连不上 Anthropic
先看是否还有旧状态或代理影响：
claude --debug-file /tmp/claude-debug.log -p "ping" --output-format text
rg -n "Unable to connect|api.anthropic.com|403|ERR_BAD_REQUEST" /tmp/claude-debug.log -S
¶ 6.2 命令能执行但对话异常
重点检查：
~/.claude/settings.json是否为合法 JSONANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_CUSTOM_HEADERS是否正确model是否是网关支持的模型 ID
¶ 6.3 之前配置过错误的API导致没法进入
可以删掉.claude文件夹重新创建并且配置。也可以卸载掉claude重新走一边流程