Claude Code 接入 Anthropic 兼容端点Base URL、鉴权头与代理链路复盘这是一份windows安装Claude的报错过程复盘。过程中依次出现了安装脚本内容错误、npm 包名粘连、官方主机 403、配置文件误操作和代理端口拒绝。它们属于不同层级不能被统一概括成“Claude Code 403 的一个修复方法”。1. 环境、目标与验收标准项目记录OS / ShellWindows 10 / Windows PowerShell 5.1运行时Node.js v24.21.0、npm 11.19.0CLIClaude Code 2.1.278预期端点Anthropic 兼容 API当前文档示例为https://api.crazyrouter.com测试终点首次运行流程与主界面未完成验收完整模型响应、请求日志和服务端最终状态验收应分为五级CLI 可执行 → 配置加载 → TCP/TLS 可达 → 鉴权被接受 → 模型返回完整内容这次只具备前几级的部分截图不能因为主界面出现就补写后两级成功。2. 时间线失败并不都指向同一个组件阶段观察到的输出可以推断不可推断安装脚本HTML/JS 被 PowerShell 解析响应不是预期脚本Claude Code 包损坏npm 安装E404包名为claude-codenpm输入命令粘连官方包不存在本地检查claude --version为2.1.278CLI 可执行API 可用首次启动api.anthropic.com返回 403请求到达该主机并被拒第三方端点拒绝了请求配置操作ParserErrorJSON 被当作 Shell 命令JSON 文件已被加载代理操作ConnectionRefused到本地代理的连接失败远端 API 不可用调整后进入主题、目录信任和主界面初始化流程推进模型生成成功irm ... | iex得到 HTML/JavaScript 后语法错误只是级联症状故障边界在获取脚本阶段。随后 E404 中的包名anthropic-ai/claude-codenpm暴露了命令拼接问题也不能笼统归因于 registry。博客园版把图片重点留给端点和代理链路安装阶段的完整失败截图另见本地素材目录。npm install-g anthropic-ai/claude-code claude--version图 1版本号可以把后续 403 与安装阶段隔离。3. 403 中最重要的字段是目标主机本次原始错误是Failed to connect to api.anthropic.com: Status 403图 2错误明确指出当时的目标是api.anthropic.com。如果操作员预期访问兼容端点这个主机名比 403 本身更值得先检查。一个健壮的诊断顺序# 只确认目标主机的 TCP/443 是否可达不验证 Key。Test-NetConnectionapi.crazyrouter.com-Port 443# 确认当前 PowerShell 会话中哪些代理变量被设置避免输出密钥。Get-ChildItemEnv:|Where-ObjectName-Match^(HTTP|HTTPS|ALL)_PROXY$|Select-Object-ExpandProperty Name若错误主机仍非预期应检查用户级与项目级配置的优先关系并重新启动 CLI。不要据此臆测“必然是某个变量名导致回退”这需要客户端版本信息或请求日志支持。4. 配置文件、环境变量与鉴权是三个对象错误操作是把 JSON 粘进 PowerShell图 3ParserError只证明 Shell 无法执行 JSON。应保存到%USERPROFILE%\.claude\settings.json而不是继续尝试转义冒号。按照 Crazyrouter 当前 Claude Code 文档最小示例为{env:{ANTHROPIC_BASE_URL:https://api.crazyrouter.com,ANTHROPIC_API_KEY:替换为新生成的密钥}}ANTHROPIC_BASE_URL决定请求目标ANTHROPIC_API_KEY提供当前文档要求的凭据。Claude Code 的兼容端点配置不应照搬其他 OpenAI SDK 的/v1Base URL 写法具体路径拼接以当前客户端与服务文档为准。上面的 API URL 不加营销跟踪参数。图 4这张是历史排错证据不是推荐直接复制的现行配置。旧截图使用不同域名与变量它后面还有网络配置变更。图 5配置文件存在不等于请求已打到预期端点更不等于鉴权成功。发布时不能声称ANTHROPIC_AUTH_TOKEN单独修复了 403也不能由截图推断最终实际发送的是x-api-key、Authorization: Bearer中的哪一种头。鉴权头需要按当前文档和可观测请求核实。安全边界原始截图中曾出现完整 API Key本文只使用脱敏版。已经暴露的 Key 必须撤销并重新生成不应因为后来打码就继续使用旧 Key。5. 代理链路ConnectionRefused发生在远端之前排查过程中配置了本地代理但看到ConnectionRefused图 6这只能说明指定代理端口这一步失败。远端服务可能完全没有收到请求。先确认真实监听端口例如Get-NetTCPConnection-State Listen|Where-ObjectLocalPort-eq7890如果当前端点支持直连而且并无代理需求可以在当前会话先清理代理变量再重新测试Remove-ItemEnv:HTTP_PROXY,Env:HTTPS_PROXY,Env:ALL_PROXY-ErrorAction SilentlyContinueTest-NetConnectionapi.crazyrouter.com-Port 443测试命令只检查连通性不能当作业务验收。若公司网络必须走代理仍应使用经过确认的代理主机和端口不要凭常见端口号猜测。6. 调整后的可见结果与证据缺口在端点、鉴权与代理相关配置都发生变化后CLI 先后进入首次运行主题选择、目录信任环节并到达主界面图 7这是“能够完成初始化”的终点证据却没有证明某个单独配置是修复原因也没有证明模型完成生成。若下一轮复测要定位根因应固定一个变量、一次只改一项并记录检查项应保存的证据客户端版本claude --versionBase URL脱敏配置文件及生效范围网络目标主机、代理变量名、连通结果鉴权不含明文 Key 的状态码与请求日志模型调用请求时间、模型 ID、响应正文或响应 ID、最终状态除非有完整响应或可查日志不把“进入 UI”写成“模型接入验收通过”。7. 兼容端点的使用边界Crazyrouter 的价值在于统一入口、按量使用、无需订阅以及部分模型当前提供优惠这些优点适合需要切换模型的开发者但优惠会变化不能把所有模型写成永久折扣。可用模型、条款与优惠应在发布前再次核对当前模型页面。第三方兼容 API 和 Anthropic 官方账户登录是两种不同路径。排错时先决定走哪条再按接入指南核对变量与模型需要实际接入时再创建自己的凭据。它不构成绕过官方账户或地区限制的说明。FAQclaude --version正常是否可以关闭安装排查可以把“CLI 不存在”基本排除但不能推断远端服务可用。后续应看请求目标和响应。403 是否一定是 API Key 错误不一定。首先确认报错中实际主机、网络与当前走的是官方登录还是第三方兼容 API。旧截图中用了ANTHROPIC_AUTH_TOKEN为什么示例改用ANTHROPIC_API_KEY因为当前 Crazyrouter 接入文档示例使用后者。旧截图里多项设置同时变化不能隔离旧变量的因果作用。是否能从界面推断发送了哪个鉴权头不能。要确认x-api-key或Authorization的发送行为需要该版本的文档、脱敏网络日志或服务端观测。ConnectionRefused应先检查什么检查配置的代理地址和端口是否监听。它发生在到达远端 API 之前。可以直接发布原始终端截图吗先逐张检查并遮挡 Key、账户、内网信息与私人路径。发现真实 Key 已暴露时应撤销脱敏只能保护后续传播。复盘结论故障的关键不是记住一份配置而是把安装、配置解析、目标主机、代理和鉴权拆成可单独验证的环节。失败截图给出了环节的边界成功界面只给出一个阶段性终点。要写“模型可用”还需要一次有完整响应的独立复测。