Claude Code + Deepseek v4 模型安装部署配置：把 settings 改到 TaoToken

1. Claude Code 接入 Deepseek v4 的本地安装与配置全流程Claude Code 是 Anthropic 推出的命令行编程助手它本身不绑定模型而是一个可以对接不同大模型 API 的客户端外壳。Deepseek v4 是 DeepSeek 发布的新一代模型已经兼容 Anthropic API 协议所以 Claude Code 可以直接调用它。这套组合适合谁适合第一次在本地部署 Claude Code、想用 Deepseek v4 做代码补全和对话的开发者尤其是 Windows 用户。我试过在 Windows 上用 npm 方式安装比 winget 和 irm 一键脚本稳定得多因为部分系统会拦截这两个命令导致安装失败。整篇文章会给出可复制的 settings 配置片段、API 通道参数以及三步验证动作启动会话、发起一次对话、确认模型回显为 Deepseek v4。官网入口见 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 后面配置里用到的 Base URL 和 Key 都从这里获取。先说清楚一个概念Claude Code 和 openclaw、Hermes Agent 这类智能体一样本质是一个壳真正干活的是背后接入的大模型。所以安装 Claude Code 只是第一步关键是把它指向正确的 API 通道。DeepSeek 官方平台可以生成 Key但如果你想要一个统一的通道来管理多个模型TaoToken 提供了兼容 Anthropic 协议的 API 地址配置方式和 DeepSeek 官方一致只是 Base URL 和 Key 换成 TaoToken 的即可。下面从环境准备开始一步步走完安装、配置、验证、排障。环境准备这块你需要 Node.js 18 以上版本和 npm。如果你之前做过前端项目电脑上大概率已经有了。打开 CMD 或 PowerShell执行node -v和npm -v确认版本。Node.js 低于 18 的话Claude Code 启动会报错建议先去 Node.js 官网下载 LTS 版本覆盖安装。npm 版本低会有警告但可以忽略不影响安装。确认环境没问题后用管理员身份打开 CMD 或 PowerShell执行安装命令。这里不用 winget 或 irm直接用 npm 全局安装兼容性更好。npm install -g anthropic-ai/claude-code等待下载完毕可能会提示 npm 版本低直接忽略。然后验证安装claude -v如果能输出类似1.0.xx的版本号说明安装成功。如果提示claude 不是内部或外部命令说明 npm 全局路径没加到系统 PATH执行npm config get prefix找到路径手动加到环境变量里重启终端再试。2. TaoToken 前置准备获取 API Key 与 Base URL在改配置文件之前你需要先拿到 API Key 和 Base URL。这一步是整条链路的核心Key 错了后面全白搭。打开 https://taotoken.net/api 对应的控制台入口注册后进入 API Keys 页面创建一个新的 Key。创建时给它起个名字比如claude-code-deepseek方便后面区分。Key 生成后立即复制到记事本页面刷新后就看不到了。这个 Key 就是后面配置里的ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY的值。Base URL 这块要注意Claude Code 走的是 Anthropic 协议所以你要填的是兼容 Anthropic 的地址。TaoToken 的 API 地址是https://taotoken.net/api不要加 UTM 参数直接填这个。如果你用的是 DeepSeek 官方平台Base URL 是https://api.deepseek.com/anthropic两者格式类似只是域名不同。模型 ID 填deepseek-v4或deepseek-chat具体看平台文档DeepSeek 官方现在用deepseek-chat指向最新版TaoToken 这边填deepseek-v4即可。这里有个坑要提前说Claude Code 首次启动会提示地区限制错误这是它默认检查导致的不是你的配置问题。解决办法是在配置文件里加一行hasCompletedOnboarding: true跳过引导检查。这个文件在 Windows 下的路径是C:\Users\你的用户名\.claude.json比如C:\Users\Administrator\.claude.json。用记事本打开在 JSON 顶层加这个字段保存后重启 Claude Code错误提示就消失了。如果你不想手动改.claude.json也可以用 CC Switch 这个工具来管理配置。CC Switch 是专为 AI 编程 CLI 打造的跨平台配置管理工具支持一键切换不同模型供应商的 API 配置。下载地址在 GitHub 上搜cc-switch就能找到Windows 用户直接下载.msi安装包。安装后打开默认是 Claude Code 的配置页点右上角加号选择 DeepSeek 或自定义填入 Base URL、Key、Model ID 三项保存后点测试。如果账户不欠费会提示连接成功如果提示 402一般是额度不够需要充值。3. 可复制配置settings.json 与 CC Switch 参数Claude Code 的配置有两种方式一种是直接改.claude.json另一种是用settings.json做项目级或全局级配置。推荐用settings.json因为结构清晰方便版本管理。全局配置路径在C:\Users\你的用户名\.claude\settings.json项目级配置在项目根目录的.claude\settings.json。如果目录不存在手动创建。下面是一个完整的可复制片段把 Key 和 Base URL 换成你自己的即可。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoTokenKey, ANTHROPIC_MODEL: deepseek-v4, ANTHROPIC_SMALL_FAST_MODEL: deepseek-v4 }, hasCompletedOnboarding: true, permissions: { allow: [], deny: [] } }注意ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY的区别前者用于 Bearer 认证后者用于 x-api-key 认证。TaoToken 和 DeepSeek 的 Anthropic 兼容接口一般用ANTHROPIC_AUTH_TOKEN如果报 401换成ANTHROPIC_API_KEY再试。ANTHROPIC_MODEL填主模型 IDANTHROPIC_SMALL_FAST_MODEL填快速模型 IDDeepSeek v4 两者可以填同一个。如果你用 CC Switch配置界面里填这三项Base URL 填https://taotoken.net/apiAPI Key 填sk-开头的字符串Model ID 填deepseek-v4。CC Switch 会自动帮你写入对应的配置文件省去手动改 JSON 的麻烦。但要注意CC Switch 写入的路径可能和手动配置的路径不同建议先用 CC Switch 配好再打开settings.json确认字段是否正确。如果 CC Switch 里测试通过但 Claude Code 启动后仍报错检查一下是不是有两个配置文件冲突了删掉多余的即可。还有一个细节Claude Code 启动时会读取环境变量如果系统里已经设置了ANTHROPIC_BASE_URL或ANTHROPIC_API_KEY会覆盖settings.json里的值。所以配置前先检查系统环境变量执行echo %ANTHROPIC_BASE_URL%Windows或echo $ANTHROPIC_BASE_URLMac/Linux如果有输出先清掉再配。这个坑我踩过明明配置文件写对了但启动后还是走旧通道排查半天才发现是环境变量在作怪。4. 三步验证启动会话、发起对话、确认模型回显配置写好后不要急着写代码先做三步验证确保链路通了。第一步启动会话。打开 CMD 或 PowerShell不用管理员权限直接执行claude如果配置正确你会看到 Claude Code 的交互界面不再提示地区限制错误。如果仍然提示检查.claude.json里的hasCompletedOnboarding是否为true以及settings.json的 JSON 格式是否合法可以用在线 JSON 校验工具检查。启动成功后界面底部会显示当前模型名称如果显示deepseek-v4或类似字样说明模型 ID 配置正确。第二步发起一次对话。在 Claude Code 的输入框里输入一个简单问题比如用 Python 写一个快速排序回车。如果配置正确你会看到模型开始流式输出代码。如果卡住不动或者报local proxy failed说明 Base URL 不通检查网络和地址拼写。如果报401说明 Key 无效或认证方式不对换ANTHROPIC_API_KEY再试。如果报reading choices错误说明返回格式不是 Anthropic 协议检查 Base URL 是否填了 OpenAI 兼容地址Claude Code 需要 Anthropic 格式的响应。第三步确认模型回显。在对话中输入/model命令如果支持或者直接问你是什么模型看回复里是否提到 Deepseek v4。更可靠的方式是查看 Claude Code 的日志启动时加--debug参数会输出实际请求的模型 ID 和 API 地址。如果日志里显示model: deepseek-v4和base_url: https://taotoken.net/api说明整条链路通了。这时候你就可以正常使用 Claude Code 做代码补全、重构、调试了。验证通过后建议把配置备份一份尤其是settings.json和.claude.json。后面如果换模型或换 Key直接改这两个文件即可。如果你在 VS Code 里用 Claude Code 插件配置方式一样插件会读取同样的settings.json。命令行不习惯的话VS Code 里的对话界面效果相同适合边写代码边问问题。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth配置过程中最容易遇到四类报错下面逐个拆解。第一类401 Unauthorized。原因通常是 Key 无效、过期或认证方式不对。先确认 Key 是否复制完整有没有多余空格。然后检查settings.json里用的是ANTHROPIC_AUTH_TOKEN还是ANTHROPIC_API_KEYTaoToken 和 DeepSeek 的 Anthropic 接口一般用前者如果报 401 就换成后者。如果两个都试了还不行去控制台重新生成一个 Key确保账户有余额。DeepSeek 官方平台如果欠费会返回 402 而不是 401注意区分。第二类local proxy failed。这个错误说明 Claude Code 无法连接到 Base URL。先检查地址拼写https://taotoken.net/api不要写成https://taotoken.net/api/末尾斜杠有时会导致问题也不要加 UTM 参数。然后确认网络能访问该地址在浏览器里打开https://taotoken.net/api看是否有响应。如果公司网络有防火墙可能需要配置代理但注意不要用违规的代理工具直接用系统网络设置即可。如果地址正确、网络正常还是报这个错检查settings.json的 JSON 格式多余逗号或引号不匹配都会导致解析失败。第三类reading choices 错误。这个报错说明 API 返回的是 OpenAI 格式的响应而 Claude Code 期望 Anthropic 格式。原因是 Base URL 填成了 OpenAI 兼容地址比如https://api.deepseek.com/v1。解决办法是把 Base URL 改成 Anthropic 兼容地址DeepSeek 官方是https://api.deepseek.com/anthropicTaoToken 是https://taotoken.net/api。改完后重启 Claude Code再发起对话测试。如果仍然报错检查 Model ID 是否填错有些平台用deepseek-chat而不是deepseek-v4。第四类OAuth 相关错误。Claude Code 首次启动可能会尝试 OAuth 登录如果你不想登录 Anthropic 账号就在.claude.json里加hasCompletedOnboarding: true跳过引导。如果已经进入 OAuth 流程按 CtrlC 退出改完配置再启动。有些版本会提示OAuth token expired这是因为之前登录过 Anthropic 账号清掉.claude.json里的oauthAccount字段即可。如果报OAuth callback failed检查浏览器是否能正常打开回调地址或者直接用 API Key 方式认证不走 OAuth。排查完这些错误后如果还是有问题建议把--debug日志贴出来重点看base_url、model、auth三个字段。大部分问题都是配置拼写错误或认证方式不匹配导致的耐心对照本文的配置片段逐项检查基本都能解决。6. 长期编码与 Agent 场景的配置建议如果你只是偶尔用 Claude Code 问几个问题上面的配置足够了。但如果你打算长期用它做编码助手或者跑 Agent 任务有几个优化点值得注意。第一把settings.json放到项目根目录的.claude文件夹里这样每个项目可以有不同的模型配置比如前端项目用 Deepseek v4后端项目用另一个模型。全局配置放在用户目录下作为默认值项目配置覆盖全局配置。第二开启permissions白名单把常用的命令加进去避免每次执行都弹确认。比如allow: [Bash(npm run *), Bash(git *)]这样 npm 和 git 命令就不用反复确认了。第三如果你要跑 Agent 任务建议用 Coding Plan 这类长期套餐比按量计费更划算。TaoToken 的 Coding Plan 入口在 https://taotoken.net/api 对应的控制台里具体路径看文档。Agent 任务的特点是请求密集、上下文长按量计费容易超预算套餐模式更可控。配置方式不变只是 Key 换成套餐对应的 Key 即可。第四定期检查 API 用量在控制台里看每日消耗避免 Key 泄露导致被盗刷。如果发现异常用量立即在控制台禁用旧 Key生成新 Key 并更新settings.json。最后说一个实用技巧把settings.json和.claude.json加入.gitignore不要提交到仓库因为里面包含 Key。如果团队协作需要共享配置把 Key 抽成环境变量配置文件里只写ANTHROPIC_AUTH_TOKEN: ${TAOTOKEN_KEY}然后在系统环境变量里设置TAOTOKEN_KEY。这样配置文件可以安全提交每个人用自己的 Key。Claude Code 支持这种变量替换启动时会自动读取环境变量。配置完成后你就可以在终端里用claude命令开始编码了遇到问题先看--debug日志大部分错误都能从日志里找到线索。