Claude Code 与 DeepSeek-V4 接入指南

Claude Code 与 DeepSeek-V4 标准化接入方案

Claude Code 工具与 DeepSeek-V4 模型支持 CLI、VSCode 编辑器及桌面版三种接入模式，提供 1M 上下文功能启用流程及典型问题解决方案。

一、前置条件

1. Node.js 18+ 环境部署

下载 Node.js LTS 版本（nodejs.org），安装时勾选「Automatically install the necessary tools」选项，自动配置 Python 等编译依赖。验证命令：node -v 和 git -v。

2. Claude Code 工具安装

执行 npm install -g @anthropic-ai/claude-code 完成安装，通过 claude --version 验证。

3. DeepSeek 账号配置

注册平台：platform.deepseek.com。登录后进入「API Keys」模块生成 SK 格式密钥（sk-xxxx）。DeepSeek-V4 按量计费，需提前充值。

二、方案 A：settings.json 配置

1) 配置文件路径

macOS/Linux：~/.claude/settings.json
Windows：C:\Users\<用户名>\.claude\settings.json（路径不存在需手动创建）

2) 配置内容

json {  "$schema": "https://json.schemastore.org/claude-code-settings.json",  "env": {   "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",   "ANTHROPIC_AUTH_TOKEN": "sk-DeepSeekAPIKey",   "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_DISABLE_NONESSENTIAL_TRAFFIC": "1"  } }

注：配置中的 URL 可能无法直接访问，按上述内容填写即可正常使用。

3) 配置验证

重启终端或 VSCode，进入项目目录执行 claude，输入 /status 验证是否返回 deepseek-v4-pro[1m]。

三、方案 B：环境变量配置

适用临时接入场景：

bash export ANTHROPIC_AUTH_TOKEN="sk-DeepSeekAPIKey" export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" export ANTHROPIC_MODEL="deepseek-v4-pro[1m]" claude

Windows PowerShell：

powershell $env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-DeepSeekAPIKey" claude

四、方案 C：桌面版 GUI 接入

1) 启用开发者模式

依次操作：Help → Troubleshooting → Enable Developer Mode，重启生效。

2) 配置第三方推理服务

Developer → Configure Third-Party Inference，选择 Gateway 方式：
Gatwey base URL："https://api.deepseek.com/anthropic"
Gateway API key：sk-xxxx 格式密钥
Model list 添加 deepseek-v4-pro 和 deepseek-v4-flash，勾选 Offer 1M-Context variant。

3) 使用模型

重启桌面版，新建对话时可选择 DeepSeek-V4 系列模型。

五、模型选择建议

主力模型：deepseek-v4-pro[1m]，支持 1M 上下文，适用于高复杂度任务。
轻量模型：deepseek-v4-flash，响应快、成本低。

六、常见问题及解决方案

1. 401 Unauthorized 错误

原因：API Key 输入错误、含多余空格或账号余额不足。解决方案：重新生成并完整粘贴密钥，完成充值。

2. 模型不存在错误

原因：模型名称不规范。需严格使用 deepseek-v4-pro[1m]（必须包含 [1m] 标识），禁用 Anthropic 官方模型名称。

3. VSCode 插件接入失效

需使用方案 A 的 settings.json 配置方式，完成后重启 VSCode。

4. Windows 安装失败

安装 Git for Windows，并勾选「Git from command line and 3rd-party software」选项。

七、操作流程总结

部署 Node 18+ → 安装 Claude Code 工具 → 获取 DeepSeek API Key → 完成 settings.json 配置 → 执行 claude 启动 → /status 验证接入，通过后即可使用。