CC-005：首次启动即报 Unable to connect to Anthropic services​

问题现象​

Claude Code 安装完成后，第一次执行 claude 或登录时显示无法连接 Anthropic 服务：

Unable to connect to Anthropic services
Please check your internet connection and network settings.

安全边界​

旧版页面把 ~/.claude.json 中手写 hasCompletedOnboarding: true 描述为标准修复。这是内部状态字段，本次未在 Anthropic 官方安装文档↗ 或 LLM Gateway 文档↗ 中确认，因此已撤下。手动标记 onboarding 完成可能跳过必要的登录、地区、条款或连接检查，不应作为通用方案。

支持的排查顺序​

1. 运行 claude --version，确认安装完成且来自 Anthropic 官方渠道
2. 打开 Anthropic 支持地区页面↗，确认官方服务适用于你的所在地与账户
3. 检查系统时间、DNS、企业防火墙、证书代理和已获授权的系统代理设置
4. 使用官方 Anthropic 账户/API 时，按应用可见的登录流程完成认证
5. 使用受支持的 LLM Gateway 时，只配置官方文档列出的 ANTHROPIC_BASE_URL，并根据网关要求选择 ANTHROPIC_API_KEY（x-api-key）或 ANTHROPIC_AUTH_TOKEN（Bearer）
6. 查看 Anthropic 官方安装文档↗ 与 LLM Gateway 文档↗；仍失败时向 Anthropic 或你实际选择的网关支持渠道反馈完整错误，但不要提交真实 Key

资料来源：Anthropic 安装文档↗ · LLM Gateway 配置↗（2026-07-26 核对）