Claude Code 接 DeepSeek：成本降到 1/180 的完整配置指南

DeepSeek V4-Flash 缓存命中时输入 0.028/M，Claude Opus 4.7 输入 5/M——差 178 倍。

为什么要接 DeepSeek

Claude Code 很强，但账单也不低。

以当前主流的 Opus 4.7 为例：输入 5/百万 token，输出 25/百万 token。如果每天重度使用，一个月账单几十美元起步。

DeepSeek V4 给了另一个选择：

缓存命中时，DeepSeek V4-Flash 的输入价格是 Claude Opus 4.7 的 1/178，是 Sonnet 4.6 的 1/107。

更重要的是：DeepSeek 官方提供 Anthropic 兼容端点，Claude Code 改两行环境变量就能用。

两套方案对比

两套方案配置后都能正常工作。如果你只打算用 DeepSeek，选直连；如果你想随时切换 GLM、Qwen、Kimi 等多家模型，选 OpenRouter。

方案一：DeepSeek 直连

1. 获取 API Key

前往 platform.deepseek.com 注册，新账户送 500 万免费 token。

控制面板 → API Keys → Create new API key。

2. 配置环境变量

DeepSeek 提供 Anthropic 兼容端点：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

export ANTHROPIC_API_KEY="sk-your-deepseek-key"

export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"

export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"

3. 验证配置

claude

4. 模型选择建议

5. 兼容性说明

DeepSeek 的 Anthropic 端点兼容情况：

实测建议：先用一天，跑跑日常任务，看看有没有报错。大部分代码生成、重构、debug 场景都没问题。

方案二：OpenRouter 中转

OpenRouter 是一个模型聚合平台，统一 API 接入 DeepSeek、GLM、Qwen、Kimi 等多家模型。

1. 获取 API Key

前往 openrouter.ai 注册，新用户有免费额度。

2. 配置环境变量

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"

export ANTHROPIC_API_KEY="sk-or-your-openrouter-key"

export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek/deepseek-v4-pro"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4-flash"

3. OpenRouter 定价

OpenRouter 上的 DeepSeek 价格比官方略高，但换来多模型切换：

注意：免费版有限额，适合轻度试用。

4. 为什么选 OpenRouter

• 多模型切换：一行配置切到 GLM、Qwen、Kimi

• 统一账单：不用在多家平台充值

• 免费额度：新用户有免费额度，可以先试用

使用体验

官方性能宣称

根据 DeepSeek 官方信息：

DeepSeek V4-Pro： - Agent 编程能力：开源 SOTA - 世界知识：开源模型第一，仅次于 Gemini-3.1-Pro - 推理能力：数学/STEM/编程全面领先，对标顶级闭源模型 - 已集成 Claude Code、OpenClaw、OpenCode

DeepSeek V4-Flash： - 推理能力接近 V4-Pro - 简单 Agent 任务表现相当 - 更快响应、更经济定价

代码生成（预期表现）

长上下文

DeepSeek V4 支持 100 万 token 上下文，官方建议：

技巧：先提供文件树让模型理解项目布局，使用清晰分隔符（如 --- FILE: src/auth.py ---）。

响应速度

哪些场景可能还是 Claude 更好

• 超复杂推理：多步骤架构决策、跨系统设计

• 精细代码审查：需要 Claude 级别的细致

• Extended Thinking：DeepSeek 有自己的 thinking 模式，格式可能与 Claude 不同

• Tool Use 密集场景：需要实测验证 function calling 兼容性

建议：先用 DeepSeek 的 500 万免费 token 跑几天，记录哪些场景够用、哪些需要切回 Claude。

成本计算器

假设你每天用 Claude Code：

• 输入：10 万 token（70% 缓存命中）

• 输出：3 万 token

月成本对比：

结论：从 Claude Opus 4.7 切到 DeepSeek V4-Flash，月成本从 108 降到 1，节省 99%。

常见问题

Q: 配置后报错 "authentication_error" 或 "invalid_api_key"

原因：API Key 格式错误或未生效。

排查步骤：

echo $ANTHROPIC_API_KEY

echo $ANTHROPIC_BASE_URL

curl https://api.deepseek.com/models \

-H "Authorization: Bearer $ANTHROPIC_API_KEY"

常见错误： - API Key 复制时多了空格 - 环境变量只在当前 shell 生效，新开终端后失效 - 用了错误的环境变量名

注意：ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 都可以用于 Claude Code，推荐使用 ANTHROPIC_API_KEY。

Q: 报错 "model not found" 或 "invalid_model"

原因：模型名不匹配。

DeepSeek 直连正确的模型名：

deepseek-v4-pro

deepseek-v4-flash

deepseek-chat # V3，旧版

deepseek-reasoner # R1，推理模型

OpenRouter 正确的模型名：

deepseek/deepseek-v4-pro

deepseek/deepseek-v4-flash

deepseek/deepseek-v4-flash:free

常见错误：

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4-flash"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4-flash"

Q: 环境变量设置了，但 Claude Code 还是用原来的模型

原因：环境变量未持久化，或 Claude Code 缓存了旧配置。

解决方案：

echo 'export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"' >> ~/.zshrc

echo 'export ANTHROPIC_API_KEY="sk-your-key"' >> ~/.zshrc

echo 'export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"' >> ~/.zshrc

source ~/.zshrc

Q: 报错 "connection refused" 或 "timeout"

原因：网络问题或端点错误。

排查步骤：

ping api.deepseek.com

curl -v https://api.deepseek.com/anthropic

export HTTP_PROXY="http://your-proxy:port"

export HTTPS_PROXY="http://your-proxy:port"

端点地址核对： | 平台 | 正确端点 | |------|----------| | DeepSeek | https://api.deepseek.com/anthropic | | OpenRouter | https://openrouter.ai/api/v1 |

Q: Tool Use / Function Calling 报错

原因：第三方 Anthropic 兼容端点可能存在兼容性差异。

解决方案： 1. 测试你的工作流，记录哪些功能正常 2. 复杂 tool use 场景切回 Claude

临时切换回 Claude：

unset ANTHROPIC_BASE_URL

export ANTHROPIC_API_KEY="sk-ant-your-claude-key"

Q: OpenRouter 报错 "insufficient_quota" 或 "rate_limit"

原因：额度不足或请求过快。

解决方案：

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4-flash"

Q: 如何在 DeepSeek 和 Claude 之间快速切换？

方案一：使用脚本

#!/bin/bash

if [ "$1" = "deepseek" ]; then

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

export ANTHROPIC_API_KEY="sk-your-deepseek-key"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"

echo "Switched to DeepSeek"

elif [ "$1" = "claude" ]; then

unset ANTHROPIC_BASE_URL

export ANTHROPIC_API_KEY="sk-ant-your-claude-key"

unset ANTHROPIC_DEFAULT_SONNET_MODEL

echo "Switched to Claude"

fi

source ~/switch-model.sh deepseek

source ~/switch-model.sh claude

方案二：使用 .env 文件

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

ANTHROPIC_API_KEY=sk-your-deepseek-key

ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-flash

ANTHROPIC_API_KEY=sk-ant-your-claude-key

export $(cat .env.deepseek | xargs)

export $(cat .env.claude | xargs)

Q: 如何验证配置是否正确？

env | grep ANTHROPIC

curl https://api.deepseek.com/anthropic/v1/messages \

-H "Content-Type: application/json" \

-H "x-api-key: $ANTHROPIC_API_KEY" \

-H "anthropic-version: 2023-06-01" \

-d '{

"model": "deepseek-v4-flash",

"max_tokens": 100,

"messages": [{"role": "user", "content": "Hello"}]

}'

claude

Q: DeepSeek 的上下文缓存怎么生效？

自动生效。只要请求开头与之前请求的前缀匹配，就会命中缓存。

提高缓存命中率： - 系统提示放在消息数组最前面 - 多轮对话保持历史消息顺序不变 - 相同任务的请求连续发送

查看缓存命中情况：

response = client.chat.completions.create(...)

print(f"缓存命中: {response.usage.prompt_cache_hit_tokens}")

Q: 多个模型如何切换？

改环境变量后重启 Claude Code：

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"

export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"

或者用 OpenRouter，通过模型名切换，无需改环境变量。

Q: OpenRouter 和官方怎么选？

总结

Claude Code 接 DeepSeek 只需要两步：

1. 注册 DeepSeek，拿 API Key

2. 改环境变量，重启 Claude Code

从 Claude Opus 4.7 切到 DeepSeek V4-Flash，成本降到 1/180。

建议策略：DeepSeek 当主力，Claude 当备胎。先用 DeepSeek 跑日常任务，遇到搞不定的复杂场景再切回 Claude。

新用户可以先领 DeepSeek 的 500 万免费 token，跑一周看看效果。