1. Windows11 下 Claude Code 安装与 DeepSeek 接入的真实场景
如果你在 Windows11 上想用 Claude Code 做终端里的 AI 编程助手，大概率会先撞上两堵墙：一是官方安装脚本在国内网络下直接 403，二是默认模型通道对国内开发者不友好。我试过用irm https://claude.ai/install.ps1 | iex这条命令，终端转了几秒就返回「禁止访问」，换网络环境也一样，因为请求在 Cloudflare 那一层就被拦了。所以这篇教程的核心思路很明确：用 winget 这个 Windows 自带的包管理器把 Claude Code 装稳，再通过 TaoToken 的统一 Key 通道把模型请求接到 DeepSeek 上，最后写成永久配置，以后打开终端就能直接用。
Claude Code 是什么？简单说，它是一个跑在命令行里的 AI 编程代理，能读你当前项目的文件、执行命令、改代码、跑测试，交互方式像在终端里跟一个懂代码的同事对话。它适合谁？适合已经在用 VS Code、Windows Terminal、PowerShell 的开发者，尤其是想把手头的 DeepSeek 额度用起来、又不想被官方默认通道卡住的人。Windows11 自带的 winget 让安装这一步变得非常干净，不需要手动下载 exe、不需要配 PATH，一条命令搞定。
这篇教程会交付四样东西：可复制的 winget 安装命令、TaoToken 统一 Key 的获取与配置方式、settings.json永久配置文件片段、以及验证 DeepSeek 模型调用成功的具体操作。整个过程我会按「先装工具、再配通道、最后验证」的顺序走，每一步都给出完整命令和预期输出，你照着敲就行。需要提前说明的是，本文不涉及任何网络代理工具，所有配置都基于正常可访问的 API 地址完成。
在开始之前，你需要准备三样东西：一台 Windows11 电脑（Windows10 21H2 以上也可以）、一个能用的终端（推荐 Windows Terminal，系统自带）、以及一个 TaoToken 账号用来拿统一 Key。Git 是 Claude Code 的强制依赖，winget 会帮你装，但如果你机器上已经有 Git，可以跳过那一步。下面从环境准备开始。
2. TaoToken 统一 Key 与 DeepSeek 通道前置准备
TaoToken 在这里扮演的角色是「统一 Key 网关」：你不需要在 Claude Code 里分别填 DeepSeek 的地址和密钥，而是拿一个 TaoToken 的 Key，通过它的 API 通道去调用 DeepSeek 模型。这样做的好处是配置项集中、换模型时只改一个 Model ID、多个工具可以共用同一个 Key。官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api ，注意 API 地址不带 UTM 参数，配置时直接写这个。
第一步，打开官网注册并登录。登录后进入控制台，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。在控制台里你能看到账户余额、调用统计和 Key 管理入口。如果你只是想先验证模型能不能通，可以先去模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 试一句，确认账号状态正常。
第二步，创建 API Key。进入 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，点「创建密钥」，复制生成的 Key。这个 Key 通常以特定前缀开头，只显示一次，务必先存到记事本或密码管理器里。如果你打算长期做编码和 Agent 任务，可以顺便看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，里面有适合持续开发的套餐说明。
第三步，确认你要用的 DeepSeek 模型 ID。在 TaoToken 的文档页 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里能查到当前支持的模型列表。本文示例用deepseek-v4-pro[1m]作为主模型，deepseek-v4-flash作为轻量模型。注意模型 ID 必须和文档里写的完全一致，大小写、方括号都不能错，这是后面 404 和「模型不存在」报错的主要来源。
这里要强调一个配置原则：Claude Code 读取的是ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL这几个环境变量。我们要做的就是把它们指向 TaoToken 的 API 地址，并把 Key 填进去。TaoToken 的 API 地址是https://taotoken.net/api，在 Claude Code 的配置里，Base URL 需要写成能兼容 Anthropic 协议的形式，具体以文档页给出的接入说明为准。如果你之前配过 DeepSeek 官方地址，记得把旧的ANTHROPIC_BASE_URL覆盖掉，否则会走错通道。
还有一个容易被忽略的点：Windows 的环境变量分「用户级」和「系统级」。用户级只对当前登录账户生效，系统级对所有账户生效。我们推荐用用户级，因为不需要管理员权限，也不会影响其他账户。设置完成后必须完全关闭所有终端窗口再重新打开，PATH 和环境变量才会刷新。很多人配完发现不生效，就是因为只关了当前标签页，后台的终端进程还挂着旧环境。
3. winget 安装 Claude Code 与 settings.json 可复制配置
这一节是全文的操作核心，分两步：先用 winget 把 Claude Code 装好，再写配置文件把 TaoToken 通道和 DeepSeek 模型接进去。所有命令都可以直接复制，路径和原文保持一致。
3.1 winget 安装 Claude Code 完整命令
先打开管理员终端：按Win + X，选择「终端(管理员)」或「Windows PowerShell(管理员)」。然后安装 Git，这是 Claude Code 的强制依赖：
winget install Git.Git git --versiongit --version能输出版本号就说明 Git 正常。接下来检索并安装 Claude Code：
winget search Anthropic.ClaudeCode winget install Anthropic.ClaudeCode安装过程中会弹出协议确认，输入Y回车。等待下载完成后，完全关闭所有终端窗口，重新打开一个新终端，执行：
claude --version输出版本号（例如 2.1.114）就代表安装成功。后续升级和卸载也用 winget：
winget upgrade Anthropic.ClaudeCode winget uninstall Anthropic.ClaudeCode如果你机器上 winget 提示「命令不存在」，去微软商店更新「应用安装程序」即可。如果 Git 缺失报错，回到上面先装 Git。
3.2 settings.json 永久配置片段
Claude Code 在 Windows 下的全局配置文件路径是：
C:\Users\你的用户名\.claude\settings.json如果.claude目录或settings.json不存在，手动新建。把下面的 JSON 完整粘贴进去，注意把sk-xxxx替换成你在 TaoToken 创建的真实 Key：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-xxxx", "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", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash", "CLAUDE_CODE_EFFORT_LEVEL": "max", "DISABLE_TELEMETRY": "1" } }这份配置里，ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口，ANTHROPIC_AUTH_TOKEN是你的统一 Key，三个ANTHROPIC_DEFAULT_*_MODEL分别对应 Claude Code 内部不同档位的模型请求，全部映射到 DeepSeek。CLAUDE_CODE_SUBAGENT_MODEL控制子代理用的轻量模型，CLAUDE_CODE_EFFORT_LEVEL设为max让推理更充分。DISABLE_TELEMETRY关掉遥测，减少无关请求。
如果你更习惯用环境变量而不是 JSON 文件，也可以在管理员终端执行下面这组命令，效果等价：
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://taotoken.net/api", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxx", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro[1m]", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "deepseek-v4-pro[1m]", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "deepseek-v4-pro[1m]", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "deepseek-v4-flash", "User") [Environment]::SetEnvironmentVariable("CLAUDE_CODE_SUBAGENT_MODEL", "deepseek-v4-flash", "User") [Environment]::SetEnvironmentVariable("CLAUDE_CODE_EFFORT_LEVEL", "max", "User")两种方式选一种即可，不要同时配，否则排查问题时容易混淆。配完同样要完全关闭终端再重开。
3.3 三件套对照表
无论你用哪种方式，Claude Code 接入任何兼容通道都离不开三件套：Base URL、Key、Model ID。对照如下：
| 配置项 | 值 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | TaoToken API 入口，不带 UTM |
| API Key | sk-xxxx | 控制台创建，仅显示一次 |
| Model ID | deepseek-v4-pro[1m] | 主模型，须与文档一致 |
| 轻量 Model ID | deepseek-v4-flash | 子代理/快速任务 |
注意：Model ID 里的方括号和数字是模型规格的一部分，少写或改写都会导致「模型不存在」。复制时建议直接从文档页粘贴。
4. 验证 Claude Code 调用 DeepSeek 成功结果
配置写完后，验证分两层：先确认 Claude Code 本身能跑，再确认它真的把请求发到了 DeepSeek 并拿到回复。
第一层，打开一个全新终端，执行：
claude --version有版本号输出，说明安装没问题。接着进入一个空目录，执行：
claude "用一句话说明你当前使用的模型"如果配置正确，Claude Code 会返回一段回复。但这一步只能证明「有响应」，不能证明走的是 DeepSeek。更可靠的验证是让它写一段有明确技术特征的代码，比如：
claude "写一段 Qt5 C++ 串口读取的完整代码，包含 QSerialPort 初始化和 readyRead 信号连接"正常返回完整代码，说明模型通道是通的。你可以观察返回内容里是否有QSerialPort、QSerialPortInfo、connect(serial, &QSerialPort::readyRead, ...)这些典型写法，这能侧面确认模型在认真干活。
第二层，去 TaoToken 控制台的调用记录页面看统计。地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，刷新后应该能看到刚才那几次请求的 token 消耗和模型名称。如果记录里显示的是deepseek-v4-pro[1m]，说明整条链路完全打通。这一步比终端输出更有说服力，因为它绕过了 Claude Code 的本地缓存，直接反映服务端收到的请求。
再补一个交互式验证：直接运行claude进入对话模式，输入/status或类似命令查看当前会话配置（不同版本命令略有差异，以实际提示为准）。在对话里问它「你现在运行在什么环境」，观察回复风格。DeepSeek 和默认模型在中文表达上有细微差别，多问几轮能感觉出来。
如果验证时返回的是空内容或者报错，先别急着改配置，按下一节的排查清单逐条对照。大部分问题集中在 Key 复制错误、Base URL 写错、Model ID 不匹配这三类。
5. 本篇常见报错排查：401、404、模型不存在与超时
这一节按真实报错逐条拆解，每条都给出原因和修复动作。你遇到问题时直接对号入座。
401 未授权。终端返回401 Unauthorized或invalid api key。原因通常是 Key 复制不完整、Key 已删除、或者ANTHROPIC_AUTH_TOKEN里混入了空格和换行。修复：回到 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 重新复制一次，粘贴到settings.json时确认没有多余字符。如果你用的是环境变量方式，执行echo $env:ANTHROPIC_AUTH_TOKEN检查实际值。
404 地址错误。返回404 Not Found，多半是ANTHROPIC_BASE_URL写错了。常见错误包括：写成https://taotoken.net（少了/api）、写成https://taotoken.net/api/（多了斜杠）、或者还留着旧的 DeepSeek 官方地址。修复：把 Base URL 严格改成https://taotoken.net/api，保存后完全重启终端。
模型不存在。返回model not found或类似提示。原因是 Model ID 和文档不一致。比如把deepseek-v4-pro[1m]写成deepseek-v4-pro（少了规格后缀），或者大小写写错。修复：打开文档页 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 复制准确的 Model ID，替换settings.json里所有相关字段。
local proxy failed / 连接超时。返回local proxy failed或请求长时间无响应。这类报错通常和本地网络环境有关，不是配置本身的问题。先确认你的网络能正常访问https://taotoken.net/api，可以在浏览器里打开文档页测试连通性。如果文档页能开但 API 请求超时，检查是否有本地防火墙或安全软件拦截了终端的出站请求。把终端加入白名单后重试。
OAuth 相关报错。如果终端提示需要登录 Anthropic 账号或出现 OAuth 流程，说明 Claude Code 没有读到你的ANTHROPIC_AUTH_TOKEN，走了默认的官方认证路径。修复：确认settings.json路径正确（C:\Users\你的用户名\.claude\settings.json），确认 JSON 格式合法（可以用在线 JSON 校验工具检查），确认环境变量没有和文件配置冲突。
claude 命令找不到。安装后必须完全关闭所有终端窗口再重新打开，PATH 才会刷新。只关标签页不够，要退出整个终端进程。如果重开后还找不到，执行winget list Anthropic.ClaudeCode确认包已安装，再检查 PATH 里是否包含 Claude Code 的安装目录。
winget 命令不存在。去微软商店搜索「应用安装程序」并更新，或者用Add-AppxPackage手动安装最新版 winget。
Git 缺失报错。Claude Code 启动时如果提示找不到 git，先执行winget install Git.Git，装完重开终端再试。
排查时有一个通用技巧：把settings.json临时改成一个最小配置，只保留 Base URL、Key、Model 三项，排除其他字段干扰。确认能通之后再逐项加回。这样能把问题范围缩到最小。
6. 长期使用建议与 TaoToken 接入入口
配置跑通之后，日常使用其实很简单：在项目目录下直接运行claude，它会自动读取当前目录的文件作为上下文。你可以让它读某个文件、改某个函数、跑测试、解释报错。因为模型走的是 DeepSeek，中文理解和代码生成都比较顺手，长上下文任务也能扛。
如果你打算长期做编码和 Agent 任务，建议关注 Coding Plan 页面 https://taotoken.net/coding-plan?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= 和接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 是最常用的两个入口。想快速验证模型状态，直接去模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 发一句话就行。
最后分享一个实用技巧：把settings.json纳入你的 dotfiles 备份。Windows 下可以用 Git 管理C:\Users\你的用户名\.claude\目录，换机器时直接 clone 回来，改一下 Key 就能用。另外，如果你同时用多个 AI 编程工具，统一走 TaoToken 的 Key 能省去到处填密钥的麻烦，换模型时只改 Model ID 一处。配置这件事，一次做对，后面就是纯享受了。
