1. Windows 上用 winget 装 Claude 命令行并接到 deepseek 的完整流程
Claude 命令行工具(Claude Code)是 Anthropic 推出的终端 AI 编程助手,能在 cmd 里直接对话、读写文件、跑命令。它默认走 Anthropic 官方接口,但很多人手里只有 deepseek 的 API key,于是就想把两者串起来用。这篇就聚焦 Windows 场景:用 winget 装好 Claude 相关命令行工具,在 cmd 里配好环境变量和 settings.json,再把请求接到 deepseek 上,最后做一次连通性验证。适合刚接触命令行 AI 工具、又不想折腾复杂配置的 Windows 用户。整个过程我实测下来大概十分钟能跑通,核心就三件事:装工具、配 key、验通路。
2. 前置准备:TaoToken 与 deepseek key 怎么拿
在动手之前,先把两样东西准备好,后面配置才不会卡壳。
第一样是 deepseek 的 API key。打开 deepseek 开放平台,注册登录后进控制台,找到 API Keys 页面,点创建,把生成的 key 复制下来存好。这个 key 一般以sk-开头,只显示一次,丢了就得重新生成。
第二样是接入地址。Claude Code 默认请求 Anthropic 官方域名,我们要把它指向兼容 Anthropic 协议的中转地址。这里用 TaoToken 的 API 地址https://taotoken.net/api,它同时兼容 Anthropic 和 OpenAI 两种协议格式,配置时按 Anthropic 那套写就行。如果你还没有 TaoToken 的 key,可以去官网看看:https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,注册后在控制台生成一个,和 deepseek 的 key 分开管理,别混用。
注意:deepseek 的 key 是给模型调用用的,TaoToken 的 key 是给接入层用的,两者角色不同。配置时环境变量里填的是接入层的 key,模型名和上游 key 在 settings.json 里指定。
3. 用 winget 安装 Claude Code 命令行工具
Windows 10 1809 以上和 Windows 11 都自带 winget。先确认一下版本,以管理员身份打开 cmd,输入:
winget --version能打印出版本号就说明可用。如果提示找不到命令,去 Microsoft Store 搜「应用安装程序」更新一下即可。
接着安装 Claude Code:
winget install Anthropic.ClaudeCode安装过程会拉取包并写入 PATH。装完后关闭当前 cmd,重新开一个,这一步很关键,否则 PATH 不刷新,输入claude会提示不是内部或外部命令。
重新打开 cmd 后输入:
claude第一次运行通常会报错,提示缺少 onboarding 配置或者找不到配置文件。这是正常的,因为 Claude Code 首次启动需要一份初始化配置。报错信息里一般会带上配置文件的路径,类似C:\Users\你的用户名\.claude.json。
用记事本打开它:
notepad.exe %USERPROFILE%\.claude.json如果文件不存在,先手动创建。在里面加上一行:
{"hasCompletedOnboarding": true}这里有个坑:hasCompletedOnboarding这个字段不要换行、不要从别处复制,直接在第一行手打进去。复制粘贴有时会带入不可见字符,导致 JSON 解析失败,Claude 启动时继续报错。改完保存,重新开 cmd 输入claude,之前的报错就消失了。
4. 配置 cmd 环境变量与 settings.json 骨架
工具装好了,接下来把请求接到 deepseek。Claude Code 读取两个地方:环境变量和 settings.json。环境变量管接入地址和接入 key,settings.json 管模型和上游参数。
在 cmd 里设置环境变量(当前会话生效):
set ANTHROPIC_BASE_URL=https://taotoken.net/api set ANTHROPIC_AUTH_TOKEN=你的TaoToken密钥如果想永久生效,用 setx:
setx ANTHROPIC_BASE_URL "https://taotoken.net/api" setx ANTHROPIC_AUTH_TOKEN "你的TaoToken密钥"setx 写入后要重开 cmd 才生效。注意ANTHROPIC_AUTH_TOKEN填的是 TaoToken 控制台生成的 key,不是 deepseek 的 key。
然后配置 settings.json。路径一般在%USERPROFILE%\.claude\settings.json,没有就新建:
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken密钥" }, "model": "deepseek-chat", "smallFastModel": "deepseek-chat" }参数对照如下:
| 字段 | 作用 | 填什么 |
|---|---|---|
| ANTHROPIC_BASE_URL | 请求接入地址 | https://taotoken.net/api |
| ANTHROPIC_AUTH_TOKEN | 接入层鉴权 | TaoToken 控制台 key |
| model | 主对话模型 | deepseek-chat |
| smallFastModel | 轻量任务模型 | deepseek-chat |
deepseek 的 key 在这里不直接出现,它由接入层根据模型名路由。如果你用的是 TaoToken 的模型对话功能,也可以在控制台里直接选 deepseek 系列模型,省去手写配置:https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
5. 验证请求:一次连通性测试
配置写完,重开一个 cmd,输入:
claude进入交互界面后,直接问一句:
你好,请用一句话介绍你自己如果返回的是 deepseek 风格的回复,说明链路通了。也可以非交互式验证:
claude -p "1+1等于几"正常会输出2或类似结果。如果卡住不动或者报 401、404,往下看排错部分。
想确认请求确实走了 deepseek,可以在 TaoToken 控制台的调用日志里看模型名和 token 消耗,能看到deepseek-chat的记录就对了。控制台入口:https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
6. 本篇常见报错排查
报错一:claude不是内部或外部命令。装完没重开 cmd,PATH 没刷新。关掉所有 cmd 窗口重新开一个。还不行就检查 winget 安装是否成功,用winget list Anthropic.ClaudeCode确认。
报错二:启动时 JSON 解析失败。多半是hasCompletedOnboarding那行带了换行或复制来的隐藏字符。用记事本打开.claude.json,删掉重打,确保整个文件是合法 JSON。
报错三:401 Unauthorized。环境变量里的ANTHROPIC_AUTH_TOKEN填错了,或者填成了 deepseek 的 key。确认填的是 TaoToken 控制台生成的 key,且没有多余空格。
报错四:404 或模型不存在。settings.json 里的model字段写错了。deepseek 常用模型名是deepseek-chat,别写成deepseek或带版本号的花名。改完保存,重开 cmd。
报错五:请求超时。检查网络能否正常访问https://taotoken.net/api,可以在 cmd 里curl https://taotoken.net/api看返回。如果公司网络有限制,换网络环境再试。
排错时优先看 cmd 里的完整报错信息,它通常会指出是配置问题还是网络问题。接入相关的文档可以对照看:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
7. 长期编码与 Agent 场景的接入建议
如果你只是偶尔在 cmd 里问几句,上面的配置够用了。但如果打算把 Claude Code 当成日常编码助手,频繁跑 Agent 任务、批量改文件、长时间对话,建议单独管理接入 key 和额度,避免和临时测试混在一起。TaoToken 的 Coding Plan 就是为这种长期编码场景准备的,可以按用量规划:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
另外,key 的管理建议走 API Keys 页面统一生成和吊销,别把 key 硬编码在脚本里:https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。如果你用的是 Claude Code 的 Anthropic 兼容模式,接入文档里有更细的协议说明:https://taotoken.net/doc/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。
最后提醒一句:环境变量和 settings.json 两处配置别冲突,优先以 settings.json 为准,改完记得重开 cmd。跑通一次之后,把配置备份一份,换机器时直接复制,省得重新踩坑。