1. Windows 下 Claude Code 报 Unable to connect to Anthropic services 到底卡在哪如果你在 Windows 上装好 Claude Code敲下第一条命令就撞上Unable to connect to Anthropic services紧接着还有一行Failed to connect to api.anthropic.com: ERR_BAD_REQUEST那你不是一个人。这个报错的核心含义其实很直白Claude Code 这个客户端在启动时尝试去连它默认写死的 Anthropic 服务地址api.anthropic.com但这次连接在请求层面就被判定为失败于是它干脆告诉你「连不上 Anthropic 服务」。很多人第一反应是网络问题于是反复重装、换终端、重启电脑结果报错一字不变。原因在于 Claude Code 的连接目标是由配置里的 Base URL 决定的只要这个地址还指向默认的api.anthropic.com而你的环境又没法正常访问它那ERR_BAD_REQUEST就会稳定复现。换句话说问题不在「你有没有网」而在「它连的那个地址对不对、Key 有没有配上」。这篇就按排障视角来写适合两类人一是刚在 Windows 上装完 Claude Code、被这个报错拦在门外的初学者二是已经按网上教程改过.claude.json、但依然时好时坏的老用户。我会把 Base URL 怎么填、Key 怎么来、.claude.json里那个hasCompletedOnboarding到底管什么一项一项拆开让你拿到 Key 之后能对着报错逐条核对而不是盲目复制命令。需要先明确一个概念Claude Code 是一个命令行里的编码助手它本身不产生模型能力能力来自它背后请求的 API 服务。所以「连不上」这件事本质是「客户端配置的请求地址 鉴权信息」这套组合没打通。把这两样配对报错自然消失。2. 先把 TaoToken 的 Key 和 Base URL 准备好排障的第一步不是改代码而是先确认你有一个可用的请求入口和一把对应的 Key。这里用 TaoToken 来做这件事它的作用就是给你一个统一的 API 入口Claude Code 把请求发过去由它来对接模型能力。你可以先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 了解整体情况注册登录之后进入控制台创建 Key。创建 Key 的入口在 API Keys 页面地址是 https://taotoken.net/api-keys 登录后点新建复制那串以sk-开头的字符串先存到记事本里后面配置要用。注意这串 Key 只在创建时完整显示一次关掉页面就看不全了所以务必当场复制。Base URL 这一项要记牢填的是https://taotoken.net/api注意结尾没有多余的斜杠也不要自己补/v1之类的东西。很多人ERR_BAD_REQUEST反复出现就是因为 Base URL 多写或少写了一段路径客户端拼出来的请求地址不对服务端直接返回请求错误。如果你后面打算长期在 Claude Code 里做编码、跑 Agent 任务可以顺带看一下 Coding Plan 页面 https://taotoken.net/coding-plan 它面向的就是这种持续编码场景。但排障阶段先不用管套餐把 Key 和 Base URL 这两样拿到手就够了。注意Key 属于敏感凭证不要贴到公开仓库、截图或聊天群里。配置时直接写进本地配置文件即可。3. Claude Code 里 Base URL 与 Key 的可复制配置拿到 Key 之后进入正题把 Claude Code 的请求地址从默认的api.anthropic.com改成 TaoToken 的入口。Claude Code 读取配置的方式和环境变量、配置文件都有关Windows 下最稳妥的做法是同时把环境变量和配置文件都设对避免它从某个角落读到旧值。先设环境变量。打开 PowerShell逐条执行下面两行把sk-你的Key换成你刚复制的那串setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_API_KEY sk-你的Keysetx会把变量写进用户级环境变量执行完当前窗口不会立刻生效需要关掉 PowerShell 重新开一个或者新开一个终端。这一步的作用是给 Claude Code 一个默认的请求地址和鉴权 Key它启动时会优先读这些变量。环境变量设完再处理配置文件。Claude Code 在 Windows 下的用户级配置通常在%USERPROFILE%\.claude.json也就是C:\Users\你的用户名\.claude.json。你可以先用记事本打开看看里面有没有hasCompletedOnboarding这个字段。如果没有或者值为falseClaude Code 可能会在启动引导流程里卡住表现之一就是连接异常。补写这个字段可以用原文那段 PowerShell 命令它做的事就是读取.claude.json、加上hasCompletedOnboarding: true、再写回去powershell -Command $f%USERPROFILE%\.claude.json;$jGet-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName hasCompletedOnboarding -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f执行前建议先备份一份命令是copy %USERPROFILE%\.claude.json %USERPROFILE%\.claude.json.bak万一写坏了还能还原。这条命令只负责补引导状态不负责改 Base URL所以它和前面的环境变量是两件事缺一不可。为了让你对照清楚把关键项列成表配置项应填内容常见错误Base URLhttps://taotoken.net/api多写/v1、结尾带斜杠API Keysk-开头的字符串复制不全、带了空格配置文件%USERPROFILE%\.claude.json路径写错、字段名拼错引导字段hasCompletedOnboarding: true值为 false 或缺失配置改完后把之前开着的终端全部关掉重新开一个 PowerShell让新的环境变量生效。这一步别偷懒很多「改了没用」的情况就是旧终端还在用旧变量。4. 发一条验证请求确认连接真的通了配置对不对不靠猜发一条请求就知道。重新打开 PowerShell 后先确认环境变量读到了echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY第一条应该输出https://taotoken.net/api第二条输出你的 Key。如果第一条是空的说明setx没生效或终端没重开回到上一步重来。确认无误后启动 Claude Code随便问一个简单问题比如让它解释一段代码或写个函数。如果之前那个Unable to connect to Anthropic services不再出现并且能正常返回内容说明 Base URL 和 Key 这套组合已经打通。你也可以用一条更直接的请求来验证入口是否可达。在 PowerShell 里执行curl.exe https://taotoken.net/api -H Authorization: Bearer sk-你的Key这条命令的作用是直接向 TaoToken 的 API 入口发一个带鉴权的请求。如果返回的是结构化的响应而不是连接错误说明地址和 Key 都没问题问题就只剩 Claude Code 客户端侧的配置了。反过来如果这里就报错那要回头检查 Key 是否复制完整、Base URL 是否写对。验证通过后你可以在模型对话页面 https://taotoken.net/models 里直观地试试不同模型的对话效果确认返回质量符合预期。这一步不是必须但能帮你建立「入口通了、模型也在正常工作」的信心。5. 本篇常见错排查ERR_BAD_REQUEST 反复出现怎么办排障最怕的是改了一处、报错还在。下面按我实际遇到过的顺序把ERR_BAD_REQUEST和连接失败的高频原因列一遍你对着逐条核对。第一类Base URL 写错。这是最常见的一种。https://taotoken.net/api后面不要加/v1不要加斜杠也不要写成http。客户端会把 Base URL 和具体路径拼起来多一段少一段都会让服务端返回请求错误。改完记得重开终端。第二类Key 没生效或复制不全。setx设的变量在新终端才生效旧终端读的还是空值或旧值。另外从网页复制 Key 时容易带上首尾空格配置里最好检查一遍。如果 Key 已经泄露或不确定是否完整直接去 API Keys 页面重新建一个更省事。第三类.claude.json状态不对。hasCompletedOnboarding缺失或为false时Claude Code 可能反复走引导流程表现为连接异常。用前面那段 PowerShell 命令补上true改之前先备份。如果文件本身是坏的 JSONConvertFrom-Json会报错这时把备份还原回去手动用编辑器补字段。第四类多个配置来源打架。环境变量、.claude.json、项目级配置可能同时存在Claude Code 读取有优先级。排障时先把环境变量设对再确认.claude.json里没有互相矛盾的旧地址。实在拿不准就把.claude.json里和地址、Key 相关的字段清掉只留环境变量这一条路。第五类终端缓存。改完配置不重开终端等于没改。养成习惯每次动完环境变量关掉所有 PowerShell 窗口再开新的。提示如果按上面全部核对完还是报错把echo $env:ANTHROPIC_BASE_URL的输出和报错原文一起看多数情况下能一眼看出是地址问题还是鉴权问题。6. 把配置固定下来下次直接开工排障做完建议把这次改对的东西固定成习惯省得下次换机器或重装又踩一遍。环境变量用setx设过就是持久的重装系统才需要重设.claude.json里的hasCompletedOnboarding补过一次也会保留。真正需要你记住的只有两件事Base URL 是https://taotoken.net/apiKey 从 API Keys 页面拿。如果你后面要在 Claude Code 里长期跑编码任务可以到 Coding Plan 页面 https://taotoken.net/coding-plan 看看适合的用法日常想快速验证模型效果模型对话页面 https://taotoken.net/models 更顺手接入细节和参数说明都在接入文档 https://taotoken.net/doc 里遇到新报错先翻文档比到处搜更快。最后留一个我自己的小习惯每次改完配置先跑一遍echo $env:ANTHROPIC_BASE_URL和那条curl.exe验证命令两个都对了再启动 Claude Code。这样能把「配置问题」和「客户端问题」提前分开排障时间能省一大半。
