1. Windows 上跑 Claude Code到底卡在哪一步Claude Code 是 Anthropic 推出的命令行 AI 编程助手能读你的项目、改代码、跑命令、解释报错适合习惯在终端里干活的开发者。Kimi K2 是月之暗面推出的长上下文模型中文理解和代码生成都不错适合拿来当 Claude Code 背后的模型。问题在于Windows 用户想把这套东西跑起来通常会卡在三件事上一是 Claude Code 官方安装脚本对 Windows 的支持一直不算顺滑二是模型 API 的接入地址和 Key 管理分散三是切换模型要改一堆环境变量改完还得重启终端。我试过在 Windows 11 上从零配一遍踩的坑基本都集中在环境变量和配置文件格式上。这篇就按「装 Claude Code → 用 TaoToken 统一 Key/API 通道 → 接 Kimi K2 → 验证连通 → 排错」的顺序走一遍给你能直接复制的 settings.json 和 config.toml 骨架以及 CC Switch 的切换步骤。目标很简单让 Windows 开发者半小时内跑通 AI 编程工作流不用来回折腾代理和 Key。TaoToken 在这里的角色是统一通道你只需要一个 Key就能在 Claude Code、Kimi K2 以及其他模型之间切换不用为每个模型单独申请和配置。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不带 UTM 参数。2. 前置准备Node、Git 与 TaoToken Key2.1 Windows 环境要求先把基础环境确认一遍版本太低会在安装阶段直接报错组件最低版本检查命令Windows10 及以上winverNode.js18.0.0node --versionnpm8.0.0npm --versionGit2.20.0git --versionNode.js 建议直接装 LTS 最新版安装时勾选「Add to PATH」省得后面手动配。Git 安装一路默认即可。装完打开 PowerShell建议用管理员身份把上面三条命令跑一遍都能打印版本号就说明环境没问题。2.2 安装 Claude Code在 PowerShell 里执行npm install -g anthropic-ai/claude-code装完验证claude --version如果提示「claude 不是内部或外部命令」说明 npm 全局包路径没进 PATH。默认路径一般是C:\Users\你的用户名\AppData\Roaming\npm把它加到系统环境变量 PATH 里重启终端再试。这一步是 Windows 上最高频的坑先解决掉再往下走。2.3 拿 TaoToken Key打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制保存。这个 Key 后面会同时用于 Claude Code 和 Kimi K2不用分别申请。如果你还没账号先从官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进控制台注册。注意Key 只显示一次复制后存到密码管理器里。不要写进会提交到 Git 的文件。3. 可复制配置settings.json 与 config.toml 骨架3.1 Claude Code 的 settings.jsonClaude Code 在 Windows 上读取的配置文件位于用户目录下的.claude文件夹。路径是C:\Users\你的用户名\.claude\settings.json如果文件夹不存在就手动建一个。文件内容骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的_TaoToken_Key, ANTHROPIC_MODEL: kimi-k2-0711-preview, ANTHROPIC_SMALL_FAST_MODEL: claude-3-5-haiku-20241022 } }几个字段的作用ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你刚拿到的 KeyANTHROPIC_MODEL是主模型这里填 Kimi K2 的模型名ANTHROPIC_SMALL_FAST_MODEL用于轻量任务填一个响应快的模型即可。保存时注意编码用 UTF-8Windows 记事本默认可能是 GBK建议用 VS Code 编辑。3.2 Kimi K2 的 config.toml如果你用 CC Switch 这类工具管理多模型会用到 config.toml。骨架如下[[providers]] name taotoken base_url https://taotoken.net/api api_key 你的_TaoToken_Key [[providers.models]] name kimi-k2-0711-preview provider taotoken context_window 128000 [[providers.models]] name claude-3-5-haiku-20241022 provider taotoken context_window 200000context_window按模型实际能力填Kimi K2 的长上下文适合处理大文件。这个文件放在 CC Switch 的配置目录里具体路径在工具设置里能看到。3.3 CC Switch 切换步骤CC Switch 是用来在多个模型配置之间快速切换的小工具。操作顺序第一步打开 CC Switch进入配置管理把上面两个文件的内容分别导入或粘贴进去。第二步在模型列表里选中kimi-k2-0711-preview点「应用」或「切换」。第三步工具会把选中的配置写入 Claude Code 读取的 settings.json覆盖原来的内容。第四步重启终端让 Claude Code 重新加载配置。切换完成后你在终端里跑claude用的就是 Kimi K2。想换回其他模型重复第二步选另一个即可不用手动改文件。4. 验证请求确认 API 连通与模型响应4.1 先用 curl 测 API 连通性在配置 Claude Code 之前先确认 TaoToken 的 API 能通。PowerShell 里执行curl -X POST https://taotoken.net/api/v1/messages -H Content-Type: application/json -H x-api-key: 你的_TaoToken_Key -H anthropic-version: 2023-06-01 -d {\model\:\kimi-k2-0711-preview\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\用一句话说明什么是递归\}]}如果返回里带content字段和一段文本说明 Key 和地址都对。如果返回 401检查 Key 有没有复制错返回 404检查 base_url 是不是写成了带路径的地址。4.2 在 Claude Code 里跑一次真实请求连通性没问题后进入你的项目目录执行cd D:\projects\demo claude进入交互界面后输入一句测试指令比如「读一下当前目录的 README告诉我这个项目是做什么的」。Claude Code 会调用你配置的 Kimi K2 模型读取文件并返回结果。如果它能正确读出文件内容并总结说明整条链路通了。4.3 验证模型切换生效想确认当前用的是哪个模型可以在 Claude Code 里输入/model它会显示当前模型名。如果显示的是kimi-k2-0711-preview说明 CC Switch 的切换生效了。如果还是默认模型回到 CC Switch 重新应用一次并确认 settings.json 里的ANTHROPIC_MODEL字段被正确覆盖。5. 本篇常见错排查5.1 claude 命令找不到现象PowerShell 里输入claude提示不是内部或外部命令。原因npm 全局包路径没进 PATH。解决找到C:\Users\你的用户名\AppData\Roaming\npm加到系统环境变量 PATH重启终端。如果还是不行用npm config get prefix看实际全局路径把那个路径加进去。5.2 settings.json 解析失败现象Claude Code 启动时报 JSON 解析错误。原因文件编码是 GBK或者有多余逗号、注释。解决用 VS Code 打开右下角编码切成 UTF-8删掉所有注释和末尾逗号。JSON 不支持注释这点和 config.toml 不一样。5.3 API 返回 401 或 403现象curl 或 Claude Code 请求被拒。原因Key 错误、过期或者请求头字段名写错。解决确认用的是x-api-key而不是AuthorizationKey 前后没有空格。如果 Key 刚创建等几秒再试。还不行就去 https://taotoken.net/api-keys 重新生成一个。5.4 模型名不识别现象返回「model not found」。原因模型名拼写错误或者该模型不在当前 Key 的可用列表里。解决去 https://taotoken.net/doc 查可用模型名复制粘贴不要手打。Kimi K2 的模型名带日期后缀容易漏。5.5 切换模型后没生效现象CC Switch 里切了但 Claude Code 还是用旧模型。原因settings.json 没被覆盖或者终端没重启。解决手动打开 settings.json 确认ANTHROPIC_MODEL字段然后关掉所有终端窗口重新开。Claude Code 只在启动时读一次配置。6. 把通道固定下来后面就省事了配置跑通之后建议把 settings.json 和 config.toml 备份一份放到云盘或私有仓库。以后换机器直接复制这两个文件改一下 Key 就能用。CC Switch 的配置也可以导出避免重装后重新填。如果你主要做长期编码或 Agent 类任务可以考虑用 Coding Plan把常用模型和额度固定下来入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。日常验证模型响应用模型对话页面更快地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入过程中遇到报错先查接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 大部分字段和错误码都有说明。Key 管理统一在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要新增或吊销都在这里操作。Windows 上跑 Claude Code 配合 Kimi K2核心就是把环境变量和配置文件这两处弄对。环境变量解决「命令找得到」配置文件解决「模型连得上」。这两步过了剩下的就是日常用。