Claude Code接入DeepSeek V4的两种方法完整配置指南(2026最新)

# 成本对比（输出 Token，官方标价）
prices = {
    "Claude Opus 4.6":   25.00,   # $25/M 输出 token
    "DeepSeek V4-Pro":    3.48,   # $3.48/M 输出 token  ← ~7× 更便宜
    "DeepSeek V4-Flash":  0.28,   # $0.28/M 输出 token  ← ~89× 更便宜
}
# 一天重度 Agent 使用（实际案例）
# Claude Opus 4.6：频繁触发 rate limit，三位数费用
# DeepSeek V4-Pro：412 次工具调用，$6.84（来源：FindSkill.ai 用户测试）

# macOS
# 从 Claude 官网下载 Claude Desktop App
# 或者：
brew install --cask claude

# Windows
# 下载 .exe 或 MSIX 安装包
# 地址：claude.ai/download

# 安装后，打开 Claude Desktop App
# 点击左上角 Chat 图标旁边的切换，找到 Code Tab（代码标签）
# 首次在 Windows 上打开，需要先安装 Git for Windows，安装后重启 App

# macOS / Linux：在 ~/.zshrc 或 ~/.bashrc 里加上

# DeepSeek API 配置
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxx   # 你的 DeepSeek API Key

# 模型映射（Opus→Pro，Sonnet/Haiku→Flash）
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash

# 推理模式（对应 Claude 的 thinking）
export CLAUDE_CODE_EFFORT_LEVEL=max   # none / low / high / max

# 保存后刷新配置
source ~/.zshrc

# 然后启动桌面 App，Code Tab 里就会用 DeepSeek V4

# 在 PowerShell 里运行（永久添加到用户环境变量）
[System.Environment]::SetEnvironmentVariable(
    "ANTHROPIC_BASE_URL",
    "https://api.deepseek.com/anthropic",
    "User"
)
[System.Environment]::SetEnvironmentVariable(
    "ANTHROPIC_AUTH_TOKEN",
    "sk-你的DeepSeekKey",
    "User"
)
[System.Environment]::SetEnvironmentVariable(
    "ANTHROPIC_MODEL",
    "deepseek-v4-pro",
    "User"
)
[System.Environment]::SetEnvironmentVariable(
    "ANTHROPIC_DEFAULT_OPUS_MODEL",
    "deepseek-v4-pro",
    "User"
)
[System.Environment]::SetEnvironmentVariable(
    "ANTHROPIC_DEFAULT_HAIKU_MODEL",
    "deepseek-v4-flash",
    "User"
)
[System.Environment]::SetEnvironmentVariable(
    "CLAUDE_CODE_SUBAGENT_MODEL",
    "deepseek-v4-flash",
    "User"
)
# 设置完重启 Claude Desktop App

侧边栏 Session 管理：
  → 多个项目同时跑 Agent，一个视图里切换
  → 按状态/项目/环境筛选和分组

并排面板（拖拽布局）：
  → 聊天 + diff + 终端 + 文件编辑器 同时可见
  → 拖拽调整布局，适配你的工作方式

集成终端：
  → 直接在 App 里跑测试和构建命令
  → 不需要切换到外部终端窗口

Side Chat（Cmd+;）：
  → Agent 跑任务时，侧问一个问题
  → 知道主线程上下文，但不打断主任务
  → 对应的是之前讲的 /btw 命令

内置 diff 视图：
  → 在 App 里审查 Agent 的改动
  → 直接 approve / reject，不用开 git

# 在终端里的 Claude Code session 里输入：
/desktop

# 效果：
# → Claude 保存当前 session
# → 自动在桌面 App 里打开该 session
# → 终端里的 CLI 退出
# → 继续在 GUI 里工作，完整保留上下文

# Step 1：安装 Claude Code（如果还没装）
npm install -g @anthropic-ai/claude-code

# Step 2：获取 DeepSeek API Key
# 访问 platform.deepseek.com → API Keys → Create new

# Step 3：配置环境变量（Linux / macOS）
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-你的DeepSeekKey
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

# 启动
claude

# 加到 ~/.zshrc 或 ~/.bashrc

# ── DeepSeek V4（性价比首选）──
deepseek() {
    export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
    export ANTHROPIC_AUTH_TOKEN="${DEEPSEEK_API_KEY}"
    export ANTHROPIC_MODEL="deepseek-v4-pro"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
    export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
    export CLAUDE_CODE_EFFORT_LEVEL="max"
    echo "🟢 已切换到 DeepSeek V4（Pro + Flash 路由）"
    claude "$@"
}

# ── 回到 Anthropic 官方模型（精确任务用）──
anthropic_claude() {
    unset ANTHROPIC_BASE_URL
    export ANTHROPIC_AUTH_TOKEN="${ANTHROPIC_API_KEY}"
    unset ANTHROPIC_MODEL
    unset ANTHROPIC_DEFAULT_OPUS_MODEL
    unset ANTHROPIC_DEFAULT_SONNET_MODEL
    unset ANTHROPIC_DEFAULT_HAIKU_MODEL
    echo "🔵 已切换到 Anthropic Claude（官方 Opus）"
    claude "$@"
}

# ── 只用 Flash（最省钱，简单任务）──
deepseek_flash() {
    export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
    export ANTHROPIC_AUTH_TOKEN="${DEEPSEEK_API_KEY}"
    export ANTHROPIC_MODEL="deepseek-v4-flash"
    export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-flash"
    export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
    export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
    echo "⚡ 已切换到 DeepSeek V4-Flash（全Flash，最省）"
    claude "$@"
}

source ~/.zshrc

# 用法
deepseek              # 用 DeepSeek V4 启动 Claude Code
deepseek -p "帮我重构这个函数"   # 带 prompt 直接启动
anthropic_claude      # 切回 Anthropic 官方

# 1. ANTHROPIC_BASE_URL
#    → 把 API 请求发到哪里
#    → DeepSeek Anthropic 兼容端点：https://api.deepseek.com/anthropic
#    → 注意：末尾不加 /v1，DeepSeek 的兼容层路径不同

# 2. ANTHROPIC_AUTH_TOKEN
#    → API Key（不是 Anthropic 的 Key，是 DeepSeek 的）
#    → 格式：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 3. ANTHROPIC_MODEL
#    → Claude Code 主模型
#    → deepseek-v4-pro（旗舰，复杂任务）
#    → deepseek-v4-flash（快速，简单任务）

# 4. ANTHROPIC_DEFAULT_OPUS_MODEL / SONNET / HAIKU
#    → 分别对应 Claude 的三个档位
#    → Haiku 是 Claude Code 内部频繁调用的"轻量工具"
#    → 把 Haiku → Flash，让所有内部小调用走最便宜的模型
#    → 这里省的钱往往比 Opus 还多（调用次数多）

# 5. CLAUDE_CODE_SUBAGENT_MODEL
#    → Sub-agent 使用的模型
#    → 多 Agent 并发任务时生效
#    → 推荐 Flash（子 Agent 用便宜的）

# 6. CLAUDE_CODE_EFFORT_LEVEL
#    → 推理强度：none / low / high / max
#    → max = DeepSeek 的 Think Max 模式
#    → 复杂任务用 max，简单问答用 none

# 省钱最大化配置
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash     # 轻量调用→Flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash        # 子 Agent→Flash
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro        # 核心推理→Pro

# 结果：大量的文件读取、函数分析、工具调用走 Flash（超便宜）
#       只有核心决策和复杂推理才走 Pro（依然便宜）

# 简单任务（写注释、格式化、文档）
export CLAUDE_CODE_EFFORT_LEVEL=none    # 或 low，速度快，省 token

# 中等任务（功能实现、bug 修复）
export CLAUDE_CODE_EFFORT_LEVEL=high

# 复杂任务（架构设计、多文件重构、安全审查）
export CLAUDE_CODE_EFFORT_LEVEL=max     # 开启 Think Max

# 坑1：模型名写错，报 404
# 症状：claude 启动后立刻报 "model not found"
# 排查：
echo $ANTHROPIC_MODEL   # 检查是否设置正确
# 正确：deepseek-v4-pro 或 deepseek-v4-flash（注意没有 deepseek- 前缀的老名字已停用）

# 坑2：ANTHROPIC_BASE_URL 末尾多了 /v1
# ❌ 错误：https://api.deepseek.com/anthropic/v1
# ✅ 正确：https://api.deepseek.com/anthropic
# DeepSeek 的 Anthropic 兼容层路径不同于 OpenAI 兼容层

# 坑3：桌面端设置了环境变量但没生效
# 原因：macOS 的 GUI 应用不读取 Shell 的环境变量
# 解决方案A：在 /etc/launchd.conf 里设置（系统级）
# 解决方案B：通过 ~/.claude/settings.json 配置（推荐）
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  }
}
EOF
# 解决方案C：用 launchctl 设置（macOS）
launchctl setenv ANTHROPIC_BASE_URL "https://api.deepseek.com/anthropic"
launchctl setenv ANTHROPIC_AUTH_TOKEN "sk-你的Key"
# 然后重启 Claude Desktop App

# 坑4：Claude Code 报 "authentication error"
# 原因：ANTHROPIC_AUTH_TOKEN 里的 Key 是 Anthropic 的，不是 DeepSeek 的
# 两个是不同账户的 Key！
# Anthropic Key：从 console.anthropic.com 获取（sk-ant- 开头）
# DeepSeek Key：从 platform.deepseek.com 获取（sk- 开头）

# 坑5：Think 模式响应里有 <think>...</think> 标签
# 症状：V4 开了推理模式，回复里有大段思考过程
# Claude Code 通常会过滤，但有时会显示出来
# 不影响功能，只是视觉上有点乱

关键配置（两种方法通用）：
  ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
  ANTHROPIC_AUTH_TOKEN=你的DeepSeek API Key
  ANTHROPIC_MODEL=deepseek-v4-pro
  ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash  ← 省钱关键
  CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash