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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 注意 API 地址不带 UTM 参数配置时直接写这个。第一步打开官网注册并登录。登录后进入控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。在控制台里你能看到账户余额、调用统计和 Key 管理入口。如果你只是想先验证模型能不能通可以先去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 试一句确认账号状态正常。第二步创建 API Key。进入 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 点「创建密钥」复制生成的 Key。这个 Key 通常以特定前缀开头只显示一次务必先存到记事本或密码管理器里。如果你打算长期做编码和 Agent 任务可以顺便看一下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有适合持续开发的套餐说明。第三步确认你要用的 DeepSeek 模型 ID。在 TaoToken 的文档页 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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 Codewinget search Anthropic.ClaudeCode winget install Anthropic.ClaudeCode安装过程中会弹出协议确认输入Y回车。等待下载完成后完全关闭所有终端窗口重新打开一个新终端执行claude --version输出版本号例如 2.1.114就代表安装成功。后续升级和卸载也用 wingetwinget 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 URLhttps://taotoken.net/apiTaoToken API 入口不带 UTMAPI Keysk-xxxx控制台创建仅显示一次Model IDdeepseek-v4-pro[1m]主模型须与文档一致轻量 Model IDdeepseek-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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有适合持续开发的额度方案。日常排查配置问题时API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 和接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 是最常用的两个入口。想快速验证模型状态直接去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发一句话就行。最后分享一个实用技巧把settings.json纳入你的 dotfiles 备份。Windows 下可以用 Git 管理C:\Users\你的用户名\.claude\目录换机器时直接 clone 回来改一下 Key 就能用。另外如果你同时用多个 AI 编程工具统一走 TaoToken 的 Key 能省去到处填密钥的麻烦换模型时只改 Model ID 一处。配置这件事一次做对后面就是纯享受了。