1. Windows 下 Claude Code 从零跑通，卡在哪一步
Claude Code 是 Anthropic 推出的命令行编程助手，能在终端里直接读写项目文件、执行命令、按自然语言改代码。它适合谁？适合已经习惯在 PowerShell 里敲命令、想让 AI 直接动工程目录而不是只聊天的开发者。但 Windows 用户第一次装它，通常会连续踩三个坑：Node.js 版本不对导致 npm 全局安装失败、PowerShell 默认禁止脚本执行、以及最关键的——原版模型服务在国内网络下根本连不上，配置写完claude一跑就报连接超时。
这篇就按“从零到首次跑通”的顺序走一遍：先用 Node.js 装 CLI，再在 PowerShell 里改settings.json，把请求统一指向 TaoToken 的 Key，模型落到 DeepSeek，最后用一条命令验证整条链路。全程可复制，不需要你理解每一层协议，照着填就行。
需要提前说清楚一点：Claude Code 本身只是个客户端壳子，它读的是settings.json里的ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。你把这两个值换成 TaoToken 的地址和 Key，模型名换成 DeepSeek 系列，它就跑在国内可直连的链路上。这也是为什么下面配置章节比安装章节更重要——装 CLI 十分钟，配错地址能卡你一晚上。
2. 前置准备：Node.js、PowerShell 与 TaoToken Key
2.1 装 Node.js 并确认版本
Claude Code 通过 npm 分发，所以第一步是 Node.js。去 Node.js 官网下 LTS 版（当前 20.x 或 22.x 都行），双击 msi 一路下一步。装完必须新开一个 PowerShell 窗口，否则 PATH 不生效。验证：
node -v npm -v两条都出版本号才算过。如果node -v报“不是内部或外部命令”，说明 PATH 没刷新，关掉窗口重开，或者重启一次资源管理器。
2.2 放开 PowerShell 脚本执行
Windows 默认策略会拦住 npm 生成的.ps1脚本，报无法加载文件，因为在此系统上禁止运行脚本。用当前用户级别放开，不需要管理员权限：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser执行后输入Y回车。这条只影响当前用户，比改全局策略安全。
2.3 拿一个 TaoToken 统一 Key
TaoToken 的作用是把多家模型的调用收敛到一个入口：你只维护一个 Key，换模型只改配置里的模型名，不用到处注册。注册和拿 Key 的入口在这里：
官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 控制台（建 Key）：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
进控制台后新建一个 API Key，复制保存。Key 一般只完整显示一次，丢了就重建一个。这个 Key 后面会填进settings.json的ANTHROPIC_AUTH_TOKEN字段。
3. 安装 Claude Code 并写 settings.json
3.1 全局安装 CLI
在 PowerShell 里执行。如果 npm 拉包慢，先换镜像源再装：
npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code装完验证：
claude --version出版本号即安装成功。如果报EACCES或权限错误，多半是没放开脚本执行，回到 2.2 重做一遍。
3.2 找到配置文件位置
Claude Code 读的是用户目录下的.claude\settings.json。Windows 路径是：
C:\Users\你的用户名\.claude\settings.json如果.claude文件夹或settings.json不存在，手动新建。注意别建成 txt：在资源管理器里开“文件扩展名”显示，确认文件名就是settings.json，不是settings.json.txt。这一步坑过很多人，配置明明写对了却不生效，就是后缀问题。
3.3 可复制的 settings.json 骨架
把下面内容整段贴进去，只改ANTHROPIC_AUTH_TOKEN为你自己的 TaoToken Key：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的 TaoToken API Key", "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", "CLAUDE_CODE_EFFORT_LEVEL": "max" } }几个字段的作用对照一下，方便你按需改：
| 字段 | 作用 | 建议值 |
|---|---|---|
| ANTHROPIC_BASE_URL | 请求发往哪个入口 | https://taotoken.net/api |
| ANTHROPIC_AUTH_TOKEN | 鉴权 Key | 你的 TaoToken Key |
| ANTHROPIC_MODEL | 默认主模型 | deepseek-v4-pro[1m] |
| ANTHROPIC_DEFAULT_HAIKU_MODEL | 轻量任务模型 | deepseek-v4-flash[1m] |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 关掉非必要遥测请求 | 1 |
注意：
ANTHROPIC_BASE_URL填的是https://taotoken.net/api，不要带多余路径，也不要加 UTM 参数，否则鉴权会失败。
3.4 环境变量方式（可选）
如果你不想写文件，也可以在 PowerShell 里临时设环境变量，适合快速试一次：
$env:ANTHROPIC_BASE_URL = "https://taotoken.net/api" $env:ANTHROPIC_AUTH_TOKEN = "你的 TaoToken API Key" $env:ANTHROPIC_MODEL = "deepseek-v4-pro[1m]"但这种只在当前窗口有效，关掉就没了。长期用还是推荐settings.json，一次配好到处生效。
4. 验证请求：一条命令确认链路通
4.1 建测试目录并启动
新开 PowerShell，执行：
mkdir test-claude cd test-claude claude第一次进会走几个引导：选文本风格（建议选 1 自动控制，方向键上下选，回车确认）、安全提示直接回车、问是否信任当前文件夹选 Yes。这些只出现一次。
4.2 用一句话验证模型身份
进去后直接问：
你是什么大模型？如果返回里明确是 DeepSeek 系列，说明settings.json的地址、Key、模型名三处都对上了，整条链路通了。如果它答得含糊，别急，换个更硬的验证方式——让它读文件：
在当前目录创建一个 hello.txt，内容写 "link ok"执行完在 PowerShell 里cat hello.txt，能看到link ok就证明它真的能操作本地文件，不只是聊天。
4.3 跑一个小工具确认可用性
再让它写个倒计时页面，验证生成代码能力：
写一个单文件 countdown.html，输入分钟数后倒计时，到点弹提示生成后用浏览器打开这个 html，输入 1 分钟试一下。能正常倒计时并弹窗，说明从安装到调用到产出这条完整路径没问题。到这里，Claude Code 在 Windows 上就算真正跑通了。
5. 本篇常见报错排查
报错一：claude不是内部或外部命令。npm 全局目录没进 PATH。执行npm config get prefix看路径，把它加到系统环境变量 Path 里，重开窗口。
报错二：连接超时 / fetch failed。九成是ANTHROPIC_BASE_URL写错，或者 Key 前后带了空格。检查是不是误填了别的地址，确认是https://taotoken.net/api。
报错三：401 / invalid api key。Key 复制不全或已失效。回控制台重新建一个，整段替换ANTHROPIC_AUTH_TOKEN。
报错四：配置改了不生效。检查文件名是不是settings.json.txt；另外 Claude Code 启动时读配置，改完要退出重进。
报错五：模型名报 not found。模型名拼写要和平台一致，注意[1m]后缀别漏。不确定就用deepseek-v4-pro[1m]这个默认值先跑通。
报错六：PowerShell 禁止运行脚本。回到 2.2 执行Set-ExecutionPolicy，Scope 用 CurrentUser。
排查顺序建议固定成：先claude --version确认装上了，再确认配置文件路径和后缀，最后才怀疑 Key 和地址。大部分问题出在前两步，不在网络。
6. 后续怎么用得更顺
跑通之后，日常最常用的两个入口建议收藏：需要看模型对话效果、快速试 prompt，用模型对话页；要长期在项目里用 Claude Code 写代码、跑 Agent 任务，用 Coding Plan 更划算。
模型对话：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= API Keys 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
一个实用习惯：把settings.json备份一份，换机器时直接拷过去改 Key 就行。另外主模型用 pro、轻量任务用 flash 的分工别乱，ANTHROPIC_DEFAULT_HAIKU_MODEL走 flash 能省不少额度，长任务响应也更快。真遇到诡异问题，先删掉settings.json重新写一遍，比逐行 debug 快得多。
