Claude Code 接入 DeepSeek V4 API：本地 CLI 与远程服务器配置全流程

1. 为什么要在 Claude Code 里接 DeepSeek V4Claude Code 是 Anthropic 推出的命令行编程助手能读代码、改文件、跑命令、做重构很多人拿它当终端里的结对程序员。但它默认只认 Anthropic 官方账号订阅和支付对国内开发者不太友好额度也经常不够用。DeepSeek V4 API 提供了兼容 Anthropic 协议的接入点只要把 Claude Code 的请求地址和鉴权换成 DeepSeek 的就能用国内模型驱动同一套 CLI 工作流。这篇面向两类人一是在自己电脑上用命令行写代码的开发者二是通过 VS Code 连远程服务器做开发的人。两条路径的配置思路一样都是改环境变量或配置文件但落地位置不同踩的坑也不一样。我会把 settings.json、config.toml 骨架、环境变量和连通性验证命令都给全你照着复制就能跑通。需要提前说明的是Claude Code 本身是客户端工具它不生产模型能力只是把请求转发出去。所以接入的关键就三件事请求发到哪个地址、用什么 Key 鉴权、默认调用哪个模型名。把这三件事配对剩下的就是验证和排错。2. TaoToken 前置统一 Key 与 API 通道如果你只想接 DeepSeek 官方直接拿 DeepSeek 的 Key 填进去就行。但实际开发里经常要在多个模型之间切换比如日常用 DeepSeek V4 省钱遇到复杂推理再换别的模型这时候每个模型单独申请 Key、单独改配置就很烦。TaoToken 提供的是统一 Key 和统一 API 通道一个 Key 走同一个入口模型名在配置里换就行省去反复改鉴权信息的麻烦。它的 API 入口是https://taotoken.net/api兼容 Anthropic 协议所以 Claude Code 这类工具可以直接对接。你需要先去控制台创建一个 API Key然后把它填到下面配置里的ANTHROPIC_AUTH_TOKEN位置。模型名按你实际要用的填比如 DeepSeek V4 系列。注意Key 属于敏感凭证不要提交到 Git 仓库也不要在截图里暴露。建议放在本地配置文件或环境变量里远程服务器上用单独的配置文件管理。如果你还没创建 Key可以走这个入口API Keys 管理页https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。创建完复制出来后面配置会反复用到。3. 本地 CLI 配置settings.json 与环境变量3.1 安装 Claude Code CLI先确认本机有 Node.js 和 Git。然后在 PowerShell 里全局安装npm install -g anthropic-ai/claude-code装完检查版本能打印出版本号就说明安装成功claude --version第一次直接运行claude会引导你登录 Anthropic 账号。我们不用官方账号所以先退出登录界面改用环境变量方式注入配置。3.2 临时环境变量当前终端生效在 PowerShell 里逐条执行把地址、Key、模型名都设进去$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN你的 TaoToken API Key $env:ANTHROPIC_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] $env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash $env:CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash $env:CLAUDE_CODE_EFFORT_LEVELmax这样设置只对当前终端窗口有效关掉就失效。适合先验证能不能通确认没问题再写进配置文件。3.3 永久配置settings.jsonWindows 下的全局配置路径是C:\Users\你的用户名\.claude\settings.json。macOS 和 Linux 是~/.claude/settings.json。没有这个文件就新建一个内容如下{ syntaxHighlightingDisabled: false, theme: dark, env: { ANTHROPIC_AUTH_TOKEN: 你的 TaoToken API Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, 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 } }保存后重新打开终端直接输入claude就不会再弹官方登录界面而是用你配置的模型开始对话。这里几个模型变量的含义值得说清楚ANTHROPIC_MODEL是主模型OPUS、SONNET、HAIKU分别对应 Claude Code 内部按任务复杂度分级的调用SUBAGENT_MODEL是子代理用的模型。把重活给 pro轻活给 flash能明显压低 token 消耗。3.4 用 config.toml 管理多套配置如果你经常在多个模型或多个 Key 之间切换纯靠 settings.json 会改来改去。可以用一个config.toml做配置源再写个小脚本生成 settings.json。骨架如下[profiles.deepseek] base_url https://taotoken.net/api auth_token 你的 TaoToken API Key model deepseek-v4-pro[1m] opus_model deepseek-v4-pro[1m] sonnet_model deepseek-v4-pro[1m] haiku_model deepseek-v4-flash subagent_model deepseek-v4-flash effort_level max [profiles.backup] base_url https://taotoken.net/api auth_token 另一个 Key model deepseek-v4-flash切换时把对应 profile 的值写进 settings.json 的 env 段即可。这样配置和凭证分离改起来清楚也不容易漏字段。4. 远程服务器 VS Code 配置4.1 安装远程插件用 VS Code 连远程服务器开发时Claude Code 有对应的插件。注意插件要装在远程服务器那一侧不是本地。在扩展面板里搜索 Claude Code选择安装到远程主机。装好后侧边栏会出现 Claude 图标点开就是对话框。4.2 远程 settings.json 配置默认它也会引导登录官方账号。打开 VS Code 设置切到远程标签页找到 Claude Code 的配置项编辑远程的 settings.json{ claudeCode.environmentVariables: [ { name: ANTHROPIC_BASE_URL, value: https://taotoken.net/api }, { name: ANTHROPIC_AUTH_TOKEN, value: 你的 TaoToken API Key }, { name: ANTHROPIC_MODEL, value: deepseek-v4-pro[1m] }, { name: ANTHROPIC_DEFAULT_OPUS_MODEL, value: deepseek-v4-pro[1m] }, { name: ANTHROPIC_DEFAULT_SONNET_MODEL, value: deepseek-v4-pro[1m] }, { name: ANTHROPIC_DEFAULT_HAIKU_MODEL, value: deepseek-v4-flash }, { name: CLAUDE_CODE_SUBAGENT_MODEL, value: deepseek-v4-flash }, { name: CLAUDE_CODE_EFFORT_LEVEL, value: max } ] }保存后重启 VS Code重新连上远程主机再点 Claude 图标就能正常对话。远程场景最容易出问题的地方是配置写到了本地设置而不是远程设置结果插件读不到环境变量一直卡在登录页。确认你编辑的是 Remote 那一栏的 settings.json。4.3 远程终端里的 CLI 配置如果你在远程服务器上也想直接用命令行版 Claude Code逻辑和本地一样只是路径变成 Linux 的~/.claude/settings.json。用 SSH 登上去后mkdir -p ~/.claude cat ~/.claude/settings.json EOF { env: { ANTHROPIC_AUTH_TOKEN: 你的 TaoToken API Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, 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 } } EOF这样远程终端里跑claude也会走同一套配置。服务器上建议把 Key 放在只有自己能读的文件权限下chmod 600 ~/.claude/settings.json。5. 验证请求与成功结果配置写完别急着写业务代码先用一条最小请求确认通道是通的。Claude Code 本身没有独立的 ping 命令但你可以用 curl 直接打 API 入口验证 Key 和地址是否有效curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: 你的 TaoToken API Key \ -H anthropic-version: 2023-06-01 \ -d { model: deepseek-v4-pro[1m], max_tokens: 64, messages: [ {role: user, content: 只回复两个字通了} ] }如果返回 JSON 里带content字段且内容是「通了」说明地址、Key、模型名三者都对。如果返回 401是 Key 问题返回 404多半是地址或模型名写错返回 400检查请求体格式。通道验证通过后再回到 Claude Code 里做一次真实交互。在项目目录下运行claude然后输入一句让它读文件的话比如「看一下当前目录的 package.json告诉我项目名」。如果它能正常读取并回答说明 CLI 侧的配置也生效了。远程 VS Code 场景就在对话框里发同样的话能返回结果就说明远程配置没问题。6. 本篇常见报错排查报错一一直停在登录界面。说明环境变量没被读到。本地检查 settings.json 路径和 JSON 格式远程检查是不是写到了本地设置。JSON 里多一个逗号都会导致整个文件解析失败用编辑器格式化一下确认。报错二401 Unauthorized。Key 无效或过期。去控制台重新生成一个注意复制时不要带空格。远程服务器上如果用了环境变量注入确认变量名拼写是ANTHROPIC_AUTH_TOKEN不是ANTHROPIC_API_KEY。报错三404 或 model not found。模型名写错。DeepSeek V4 的模型名要和你账号里可用的完全一致[1m]这类后缀不能漏。不确定的话先在模型对话页里试一下模型名能不能正常返回。报错四连接超时。检查服务器出网是否正常curl -I https://taotoken.net/api看能不能拿到响应头。公司内网或云服务器安全组可能限制了出站需要放行。报错五远程插件读不到配置。VS Code 的远程设置和本地设置是分开的插件在远程运行就读远程的 settings.json。改完记得完全重启 VS Code不是只重连窗口。报错六token 消耗异常高。检查CLAUDE_CODE_EFFORT_LEVEL是不是设成了 max以及子代理模型是不是用了 pro。日常任务把 haiku 和 subagent 都设成 flash能省不少。排错时如果拿不准是 Key 还是地址的问题可以先用模型对话页发一条消息确认 Key 本身可用再回头查 Claude Code 的配置。模型对话入口https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite。7. 长期编码与 Agent 场景的配置建议如果你打算把 Claude Code 当日常主力而不是偶尔试试配置上有几个点值得提前定好。第一是 Key 的轮换长期用建议单独建一个 Key 专供 CLI方便出问题时快速吊销而不影响其他服务。第二是模型分级主模型用 pro 保证复杂任务质量haiku 和 subagent 用 flash 控制成本这个在 settings.json 里已经体现。第三是远程和本地的配置同步。如果你在多台机器上开发可以把 settings.json 的 env 段抽出来做成模板Key 用环境变量引用这样配置文件可以进版本库凭证留在本地。Claude Code 支持从环境变量读取所以 settings.json 里写ANTHROPIC_AUTH_TOKEN: ${TAOTOKEN_KEY}这类占位实际值在 shell 里 export。第四是 Agent 长任务场景。Claude Code 跑多步任务时会频繁调用子代理CLAUDE_CODE_SUBAGENT_MODEL设成 flash 能明显降低单次任务的消耗。如果任务对质量要求高再临时把 effort level 调上去。这套组合用下来日常编码和中等复杂度的 Agent 任务都能覆盖。配置骨架和验证命令都在上面了按本地或远程选一条路径走通剩下的就是把它用起来。遇到报错先按第 6 节对号入座多数问题出在路径、拼写和远程本地设置混淆这三处。