1. WSL 里跑 Claude Code为什么卡在 settings.json 这一步如果你在 Windows 上想用 Claude Code又不想折腾双系统WSL2 基本是最省事的路子。装完 Ubuntu、装好 Node、npm install -g anthropic-ai/claude-code一路都挺顺结果一到配置环节就懵了~/.claude/settings.json里那几个环境变量到底填什么ANTHROPIC_AUTH_TOKEN是填官方 Key 还是别的ANTHROPIC_BASE_URL要不要改模型名写qwen3.5-plus还是别的我一开始也是照着老教程填了某家云厂商的地址能跑但问题很快来了一旦想换模型、换供应商就得回去改 Base URL、换 Key、重启终端项目多的时候每个目录还得记自己用的是哪套配置。后来我把这套接入统一收到 TaoToken 上settings.json里只留一把 Key 和一个兼容接口地址模型名继续用qwen3.5-plusWSL 终端里/status能直接看到走的是 TaoToken 通道。这篇就把这条链路从零讲清楚包括每一步的命令、配置内容、验证方式和容易踩的坑。适合谁看已经在 Windows 上用 WSL2、装过 Node 但还没跑通 Claude Code 的人或者已经跑通但被多家 Base URL 搞烦、想收敛成一把 Key 的人。全程在 WSL 的 Ubuntu 终端里操作不需要额外装别的东西。2. 先把 TaoToken 的 Key 和接口准备好这一步是整个配置的前置。Claude Code 本身不认识任何模型厂商它只认ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL这两个环境变量谁提供兼容 Anthropic 协议的接口它就连谁。TaoToken 在这里扮演的就是这个兼容层你拿一把它的 Key把 Base URL 指向它的兼容接口Claude Code 就以为自己在跟 Anthropic 说话实际请求被转发到 Qwen 上。先去官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录然后在控制台里创建一把专属 API Key。创建入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 的管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Key 生成后只显示一次复制下来先存到记事本里后面要粘进settings.json。这里有个细节值得说清楚TaoToken 的兼容接口地址是https://taotoken.net/api注意它不带任何路径后缀不要自己脑补加/v1或者/anthropic。Claude Code 会在这个 Base URL 后面自己拼它需要的路径你多写一段反而会 404。模型名这边我们继续用qwen3.5-plus这是 Qwen 系列里比较适合编码场景的一档长上下文和代码补全都够用。提示Key 不要直接写进会提交到 Git 的文件里。~/.claude/settings.json在用户主目录下一般不会被项目仓库跟踪相对安全但如果你有同步 dotfiles 的习惯记得把这一项排除掉。如果你后面打算长期在 WSL 里用 Claude Code 做编码或者跑 Agent 类任务可以顺手看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它针对的就是这种持续编码调用的场景额度模型和按次调用不太一样先了解清楚再决定用哪种。3. 改 settings.json把 Base URL 指向 TaoToken假设你 WSL 里已经装好了 Node 18 和 Claude Codeclaude --version能打印出版本号。接下来就是核心的配置文件。先确保目录存在mkdir -p ~/.claude然后编辑settings.json。如果你之前按老教程填过别的厂商地址直接覆盖掉如果是新文件用 nano 创建nano ~/.claude/settings.json粘贴下面这段内容把YOUR_TAOTOKEN_API_KEY换成你在上一步复制的那把 Key{ env: { ANTHROPIC_AUTH_TOKEN: YOUR_TAOTOKEN_API_KEY, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: qwen3.5-plus } }保存退出CtrlO回车再CtrlX。三个字段的含义分别是ANTHROPIC_AUTH_TOKEN是身份凭证Claude Code 每次请求都会带上它ANTHROPIC_BASE_URL是请求发往哪里这里指向 TaoToken 的兼容接口ANTHROPIC_MODEL是默认调用的模型名保留qwen3.5-plus即可。和原来那套填某家云厂商地址的写法相比变化只有两处ANTHROPIC_AUTH_TOKEN从厂商 Key 换成 TaoToken KeyANTHROPIC_BASE_URL从厂商的 anthropic 兼容路径换成https://taotoken.net/api。模型名不动。这就是「一把 Key 跑通」的关键——以后你想换别的模型只改ANTHROPIC_MODEL这一行Base URL 和 Key 都不用动。接着处理 onboarding 检查。Claude Code 首次启动会检查~/.claude.json里有没有完成引导的标记缺了会报Unable to connect to Anthropic services。编辑这个文件nano ~/.claude.json确认顶层有下面这个字段没有就加上{ hasCompletedOnboarding: true }注意它必须是顶层字段不能塞进别的对象里面。文件里如果已经有其他配置把这个键值对加在最外层即可别嵌套。4. 启动并验证/status 看到 TaoToken 通道配置写完回主目录启动cd ~ claude第一次启动可能会让你选主题、确认一些偏好按提示走完。进入对话界面后输入斜杠命令/status正常的话你会看到类似这样的输出字段内容Modelqwen3.5-plusAnthropic base URLhttps://taotoken.net/apiAuth tokenANTHROPIC_AUTH_TOKEN只要 base URL 显示的是https://taotoken.net/apiModel 是qwen3.5-plus就说明请求已经走 TaoToken 通道了。这时候随便问一句让它写个函数比如「用 Python 写一个读取 CSV 并统计每列空值数量的函数」能正常返回代码就说明链路完全通了。想再确认一下模型是不是真的在响应可以在对话里直接问「你现在是什么模型」或者用/model看看当前模型名。如果返回内容明显是 Qwen 的风格那就没跑偏。验证模型对话本身也可以直接在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 里试不占用终端适合先确认 Key 和模型可用再回来配 Claude Code。临时切换模型不用改文件会话里直接/model qwen3-coder-next想永久换默认模型就回去改settings.json里的ANTHROPIC_MODEL保存后重开终端再启动claude。启动时指定也行claude --model qwen3.5-plus。5. 本篇常见报错与排查报错一Unable to connect to Anthropic services九成是~/.claude.json里缺hasCompletedOnboarding或者这个字段被嵌套了。打开文件确认它在最外层值为true。改完保存重开终端再启动。报错二/status 里 Auth token 显示不对说明settings.json里的 Key 没填对或者你改了文件但没重启终端。Claude Code 启动时读取环境变量改完配置必须退出再进。重新nano ~/.claude/settings.json核对 Key注意别把引号或空格带进去。报错三请求返回 404 或路径错误大概率是ANTHROPIC_BASE_URL写多了。正确值是https://taotoken.net/api不要加/v1、/anthropic之类的后缀。Claude Code 会自己拼路径你多写一段就找不到。报错四模型名无效ANTHROPIC_MODEL填了不存在的名字。确认拼写是qwen3.5-plus别写成qwen-3.5-plus或者带版本号的其他形式。要换模型先去模型列表页确认准确名称。报错五WSL 里能 ping 通但请求超时先确认 WSL 的网络模式。较新的 WSL2 默认走 NAT一般没问题如果你手动改过网络配置检查一下 DNS 和出站规则。另外确认系统时间准确时间偏差过大会导致鉴权失败。报错六改了 settings.json 但 /status 没变化检查是不是有多个配置文件在打架。Claude Code 会读~/.claude/settings.json如果你在项目目录里还放了.claude/settings.json项目级的会覆盖用户级的。排查时先确认当前目录下有没有这个文件。6. 后续怎么用一把 Key 的长期姿势配好之后日常使用其实就三件事在项目目录里claude启动用/init生成CLAUDE.md让模型了解项目结构用/plan先讨论方案再动手。/compact在上下文快满的时候压缩历史/clear开新对话。这些命令跟用哪家模型无关配好一次就一直能用。真正省心的地方在于你不再需要为每个模型厂商维护一套 Base URL 和 Key。想从qwen3.5-plus换到别的模型只改ANTHROPIC_MODEL一行Key 始终是 TaoToken 那一把Base URL 始终是https://taotoken.net/api。WSL 终端里/status一眼就能确认当前走的是哪条通道、哪个模型。如果你在接入过程中卡在某个报错上或者想确认某个模型名是否可用接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有兼容接口的详细说明和字段解释。Claude Code 相关的配置细节也可以对照 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 看两边对一下基本不会出错。