1. Windows 上折腾 Claude Code 的真实痛点
如果你在 Windows 上想用 Claude Code 写代码，大概率会卡在三个地方：一是环境装不干净，node.js 和 git 版本对不上；二是 Claude Code 默认走 Anthropic 官方接口，国内网络环境下经常连不上；三是想换成 DeepSeek 这类国产模型省钱，却不知道配置文件该写在哪、字段叫什么。
我自己在 Windows 11 上从零搭过一遍，踩过的坑包括 PowerShell 执行策略拦截 npm 脚本、.claude目录下配置文件字段写错导致一直卡在 onboarding 界面、以及切换供应商后忘了填 token 结果请求全部 401。这篇就把完整路径拆开讲清楚：从 node.js、git 环境准备，到 Claude Code 安装，再到用 TaoToken 统一 Key 接入 DeepSeek，最后用一条命令验证模型是否真的连通。
适合谁看：在 Windows 上做开发、想用 Claude Code 的交互体验但希望后端跑国产模型的同学；已经装了 Claude Code 但一直连不上官方接口的；以及想把 AI 能力嵌进日常编码流程、又不想每个供应商单独管一套 Key 的开发者。
核心检索词先摆出来：Windows 部署 Claude、Claude Code 接入 DeepSeek、TaoToken 统一 Key、node.js 环境、git 安装、settings.json 配置、config.toml 配置。下面按可跟做的顺序来。
2. 前置准备：node.js、git 与 TaoToken 统一 Key
2.1 node.js 安装与环境变量
Claude Code 是 npm 包，所以 node.js 是硬前提。去 nodejs.org 下载 LTS 版本，Windows 选.msi安装包，一路下一步即可。安装时勾选 "Add to PATH"，这样环境变量会自动配好。
装完打开新的 PowerShell（一定要新开，否则 PATH 不生效），验证：
node -v npm -v正常会输出类似v20.11.0和10.2.4。如果提示node 不是内部或外部命令，说明 PATH 没配上，手动把 node.js 安装目录加进系统环境变量即可。
2.2 git 安装
Claude Code 部分功能依赖 git 做版本感知。去 git-scm.com 下载 Windows 版，安装时保持默认选项就行。装完验证：
git --version输出git version 2.43.0.windows.1这类信息就对了。如果 Claude Code 启动时报 "git not found"，基本都是这一步没装或没进 PATH。
2.3 TaoToken 统一 Key 的定位
这里要理解一个概念：Claude Code 本身是个客户端，它需要一个"后端"来真正跑模型。默认后端是 Anthropic 官方，但你可以把它指向兼容 Anthropic 接口的网关。TaoToken 的作用就是提供这样一个统一入口——你在这里拿一个 Key，就能同时调用 Claude、DeepSeek 等多个模型，不用每个供应商单独注册、单独管额度。
对开发者来说好处很直接：一套 Key、一个计费口径、切换模型只改配置不改代码。官网在 https://taotoken.net，API 入口是 https://taotoken.net/api。先去控制台创建一个 API Key，后面配置里要用。
3. 可复制配置：安装 Claude Code 并写入 settings.json
3.1 安装 Claude Code
以管理员身份启动 PowerShell，执行：
npm install -g @anthropic-ai/claude-code装完验证版本：
claude --version如果报错说"无法加载文件，因为在此系统上禁止运行脚本"，这是 PowerShell 执行策略拦截，执行下面这条放开（允许本地脚本运行）：
Set-ExecutionPolicy RemoteSigned输入Y确认，再跑一次claude --version就正常了。
3.2 跳过 onboarding 卡死
第一次直接输claude，很多人会卡在一个引导界面出不来。解决办法是改当前用户目录下的配置文件。路径是C:\Users\你的用户名\.claude\，找到里面的配置文件（没有就新建），在最后一行加上：
"hasCompletedOnboarding": true保存后重新输claude，就能直接进入 Claude Code 的交互界面了。
3.3 settings.json 骨架
Claude Code 读取的配置里，关键是把后端指向 TaoToken 的 API 地址，并带上你的 Key。在.claude目录下准备settings.json，骨架如下：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken_API_Key", "ANTHROPIC_MODEL": "deepseek-chat" }, "hasCompletedOnboarding": true }字段说明用表格对照更清楚：
| 字段 | 作用 | 取值示例 |
|---|---|---|
| ANTHROPIC_BASE_URL | 请求发往哪个网关 | https://taotoken.net/api |
| ANTHROPIC_AUTH_TOKEN | 身份凭证 | 控制台创建的 Key |
| ANTHROPIC_MODEL | 默认调用的模型 | deepseek-chat |
| hasCompletedOnboarding | 跳过首次引导 | true |
注意：
ANTHROPIC_AUTH_TOKEN填的是 TaoToken 控制台生成的 Key，不是 Anthropic 官方的。填错会直接 401。
3.4 config.toml 补充配置
如果你用的工具链还读取config.toml（比如某些 CLI 包装器），可以放一份等价配置，方便统一管理：
[api] base_url = "https://taotoken.net/api" auth_token = "你的TaoToken_API_Key" model = "deepseek-chat" [behavior] onboarding_completed = true两份配置的核心字段是一致的，改一处记得同步另一处，否则会出现"明明改了模型却没生效"的诡异现象。
4. 验证请求：一条命令确认模型连通
配置写完别急着写业务代码，先用一条命令确认链路是通的。在 PowerShell 里直接发一个请求：
curl https://taotoken.net/api/v1/messages ` -H "Content-Type: application/json" ` -H "x-api-key: 你的TaoToken_API_Key" ` -H "anthropic-version: 2023-06-01" ` -d '{\"model\":\"deepseek-chat\",\"max_tokens\":64,\"messages\":[{\"role\":\"user\",\"content\":\"你现在是什么模型？\"}]}'如果返回 JSON 里带content字段和模型回复，说明 Key、地址、模型名三者都对上了。返回 401 是 Key 问题，返回 404 多半是 base_url 写错，返回 400 通常是 model 名不对。
更省事的办法是直接在 Claude Code 里问一句"当前是什么模型"。能正常回答就说明整条链路通了。我实测下来，DeepSeek 在 TaoToken 上响应挺快，日常问答和代码补全完全够用。
验证通过后，就可以把 Claude Code 接进 VS Code 了。装好对应插件，在插件设置里指向同一个配置，编辑器里就能直接调用。这样写代码时选中一段让它解释、重构、补测试，整个流程不用切窗口。
5. 本篇常见错误排查
5.1 PowerShell 报"禁止运行脚本"
现象：npm install -g或claude命令报UnauthorizedAccess。原因是执行策略默认是 Restricted。执行Set-ExecutionPolicy RemoteSigned后重开终端即可。这是 Windows 上最高频的坑。
5.2 一直卡在 onboarding 界面
现象：输claude后停在引导页，按什么都没反应。原因是hasCompletedOnboarding没写或写错位置。确认它写在.claude目录配置文件的顶层，值为布尔true，不是字符串"true"。
5.3 请求返回 401
现象：模型不回复，日志显示 401 Unauthorized。三个检查点：Key 是否复制完整（前后别带空格）、ANTHROPIC_AUTH_TOKEN字段名是否写对、Key 是否已在 TaoToken 控制台启用。切换供应商后忘了填 token 也会导致这个错。
5.4 模型名不生效
现象：改了ANTHROPIC_MODEL但回复的还是旧模型。多半是settings.json和config.toml两份配置不一致，或者改完没重启 Claude Code。配置改动后一定要重开终端。
5.5 git 相关报错
现象：启动时报 git 缺失。确认git --version能正常输出，且 git 安装目录进了 PATH。装完 git 后同样要新开终端。
6. 把 AI 嵌进日常编码流程
环境搭好只是起点，真正提效在于把它用顺。我的习惯是：写新模块前先让 Claude Code 基于 TaoToken 上的 DeepSeek 生成接口草稿，自己再改；遇到不熟的库直接问用法；提交前让它扫一遍 diff 找潜在 bug。因为 Key 是统一的，哪天想换成 Claude 官方模型，只改ANTHROPIC_MODEL一个字段就行，不用重新配环境。
如果你还没拿 Key，先去 https://taotoken.net/api-keys 创建；接入细节和字段说明看 https://taotoken.net/doc；想先在网页里试试模型效果，用 https://taotoken.net/models 直接对话；长期跑编码和 Agent 任务的话，https://taotoken.net/coding-plan 更划算。配置过程中卡在哪一步，对照第 5 节的排查表基本都能定位。
