Claude Code 接入 DeepSeek V4 教程（Windows / Linux）

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，底层默认使用 Claude 系列模型（Opus / Sonnet / Haiku）。但你可能不知道——Claude Code 支持接入第三方模型，包括 DeepSeek V4。

本文将详细介绍如何在 Windows 和 Linux 系统下配置 Claude Code 使用 DeepSeek V4 模型，涵盖三种接入方案。

为什么要在 Claude Code 中使用 DeepSeek V4？

⚠️ 注意：DeepSeek V4 与 Claude 原生模型在能力上各有侧重。建议按任务需求灵活切换，而非完全替代。

前置准备

无论哪种方案，你都需要：

• Claude Code CLI（已安装并可运行）
• DeepSeek V4 API Key（从官方或第三方服务商获取）
• API 端点地址（取决于你的接入方式）

安装 Claude Code

# Linux (推荐使用 npm 全局安装)
npm install -g @anthropic-ai/claude-code

# macOS / Linux (也可以使用 Homebrew)
brew install claude-code

# Windows (npm)
npm install -g @anthropic-ai/claude-code

验证安装：

claude --version
# 或
claude-code --version

方案一：OpenRouter 代理（推荐，最简单）

OpenRouter 是统一的 AI 模型 API 网关，提供 DeepSeek V4 的代理访问，也是兼容性最好的方式。

工作原理

Claude Code → OpenRouter API → DeepSeek V4 模型

Linux 配置

创建/编辑 Claude Code 的配置文件 ~/.claude/settings.json：

{
  "model": "openrouter/deepseek/deepseek-v4",
  "modelBaseUrl": "https://openrouter.ai/api/v1",
  "apiKey": "sk-or-v1-你的OpenRouterKey",
  "modelHints": ["openrouter/deepseek/deepseek-v4"]
}

或者通过环境变量配置：

export ANTHROPIC_BASE_URL="https://openrouter.ai/api/v1"
export ANTHROPIC_API_KEY="sk-or-v1-你的OpenRouterKey"
export CLAUDE_MODEL="openrouter/deepseek/deepseek-v4"

claude

Windows 配置（CMD）

set ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1
set ANTHROPIC_API_KEY=sk-or-v1-你的OpenRouterKey
set CLAUDE_MODEL=openrouter/deepseek/deepseek-v4

claude

Windows 配置（PowerShell）

$env:ANTHROPIC_BASE_URL = "https://openrouter.ai/api/v1"
$env:ANTHROPIC_API_KEY = "sk-or-v1-你的OpenRouterKey"
$env:CLAUDE_MODEL = "openrouter/deepseek/deepseek-v4"

claude

Windows 配置（永久生效）

通过系统环境变量设置，这样每次打开终端都自动生效：

1. 按 Win + R，输入 sysdm.cpl 回车
2. 进入 高级 → 环境变量
3. 在 系统变量 中点击 新建：
   • 变量名：ANTHROPIC_BASE_URL
   • 变量值：https://openrouter.ai/api/v1
4. 同理新建：
   • ANTHROPIC_API_KEY → sk-or-v1-你的OpenRouterKey
   • CLAUDE_MODEL → openrouter/deepseek/deepseek-v4
5. 确定保存，重新打开终端即可

方案二：直连 DeepSeek 官方 API

如果你拥有 DeepSeek 官方的 API Key，可以直接配置。

获取 API 端点

DeepSeek 官方 API 兼容 OpenAI 格式：

• API Base URL: https://api.deepseek.com/v1
• Model: deepseek-chat（V4 模型名）
• API Key: 在 DeepSeek 开放平台 获取

Linux 配置

# 使用环境变量
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_API_KEY="sk-你的DeepSeekKey"
export CLAUDE_MODEL="deepseek-chat"

# 注意：有些版本的 Claude Code 使用 OPENAI_API_KEY
export OPENAI_API_KEY="sk-你的DeepSeekKey"
export OPENAI_BASE_URL="https://api.deepseek.com/v1"

claude

或者写入 settings.json：

{
  "model": "deepseek-chat",
  "modelBaseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-你的DeepSeekKey"
}

Windows 配置

PowerShell（临时，当前会话）：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/v1"
$env:ANTHROPIC_API_KEY = "sk-你的DeepSeekKey"
$env:CLAUDE_MODEL = "deepseek-chat"

claude

CMD（临时）：

set ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
set ANTHROPIC_API_KEY=sk-你的DeepSeekKey
set CLAUDE_MODEL=deepseek-chat

claude

方案三：自定义 API 端点（私有化部署）

如果你自行部署了 DeepSeek V4（例如使用 vLLM、TGI 或 Ollama），可以使用本地端点。

本地部署示例（Linux）

使用 Ollama 运行 DeepSeek V4：

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取 DeepSeek V4 模型
ollama pull deepseek-v4

# 启动 Ollama 服务（默认监听 11434 端口）
ollama serve

配置 Claude Code 接入：

# 方式一：环境变量
export ANTHROPIC_BASE_URL="http://localhost:11434/v1"
export ANTHROPIC_API_KEY="ollama"  # Ollama 不需要真实 API Key
export CLAUDE_MODEL="deepseek-v4"

claude

// ~/.claude/settings.json
{
  "model": "deepseek-v4",
  "modelBaseUrl": "http://localhost:11434/v1",
  "apiKey": "ollama"
}

使用 vLLM 部署（Linux，推荐生产环境）

# 安装 vLLM
pip install vllm

# 启动推理服务
python -m vllm.entrypoints.openai.api_server \
    --model deepseek-ai/DeepSeek-V4 \
    --api-key sk-local \
    --port 8000

# 验证
curl http://localhost:8000/v1/models

Claude Code 配置：

export ANTHROPIC_BASE_URL="http://localhost:8000/v1"
export ANTHROPIC_API_KEY="sk-local"
export CLAUDE_MODEL="deepseek-ai/DeepSeek-V4"

claude

针对各系统的完整配置脚本

Linux 一键切换脚本

创建 /usr/local/bin/claude-deepseek：

#!/bin/bash
# Claude Code → DeepSeek V4 启动脚本

# 配置项（按需修改）
DEEPSEEK_API_KEY="${DEEPSEEK_API_KEY:-sk-你的Key}"
API_BASE="${API_BASE:-https://api.deepseek.com/v1}"
MODEL="${MODEL:-deepseek-chat}"

export ANTHROPIC_BASE_URL="$API_BASE"
export ANTHROPIC_API_KEY="$DEEPSEEK_API_KEY"
export CLAUDE_MODEL="$MODEL"

echo "🚀 Claude Code → $MODEL"
echo "   API: $API_BASE"
echo ""
claude "$@"

chmod +x /usr/local/bin/claude-deepseek
# 使用
claude-deepseek

Windows 一键启动脚本（批处理）

创建 claude-deepseek.bat：

@echo off
chcp 65001 >nul
title Claude Code - DeepSeek V4

set ANTHROPIC_BASE_URL=https://api.deepseek.com/v1
set ANTHROPIC_API_KEY=sk-你的DeepSeekKey
set CLAUDE_MODEL=deepseek-chat

echo ========================================
echo   🚀 Claude Code ^→ DeepSeek V4
echo   API: %ANTHROPIC_BASE_URL%
echo ========================================
echo.

claude %*

Windows PowerShell 启动脚本

创建 claude-deepseek.ps1：

param()

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/v1"
$env:ANTHROPIC_API_KEY = "sk-你的DeepSeekKey"
$env:CLAUDE_MODEL = "deepseek-chat"

Write-Host "🚀 Claude Code → DeepSeek V4" -ForegroundColor Cyan
Write-Host "   API: $($env:ANTHROPIC_BASE_URL)" -ForegroundColor Gray
Write-Host ""

& claude @args

验证配置是否生效

启动后，在 Claude Code 中输入以下命令确认模型：

/version

如果配置成功，你会看到使用的模型信息指向 DeepSeek V4。

也可以问一个测试问题：

你当前使用的是哪个模型？请简要说明你的身份。

常见问题

Q1: 提示 "API key 无效"

原因：API Key 不匹配或环境变量未正确加载。

排查步骤：

# Linux
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
echo $CLAUDE_MODEL

# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_API_KEY

确保输出值与你配置的一致。

Q2: 提示 "模型不存在" 或 "404"

原因：模型名称与端点不匹配。不同服务商的模型名可能不同：

Q3: Windows 下环境变量不生效

• 检查：是否在同一个终端窗口设置和运行
• 系统变量：设置后需重新打开终端
• PowerShell 限制：某些环境变量名含特殊字符需要用引号

Q4: 响应速度慢

• DeepSeek V4 是大型模型，首次加载可能较慢
• 使用 OpenRouter 代理可能引入额外延迟
• 私有化部署建议使用 vLLM + GPU 以获得最佳性能

Q5: 某些功能（工具调用）不可用

部分 Claude Code 原生功能（如文件编辑、终端命令执行）依赖特定的工具调用格式。如果 DeepSeek V4 的 API 格式不完全兼容，可按需切换回 Claude 模型：

# 切回 Claude 模型（临时）
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
export ANTHROPIC_API_KEY="sk-ant-你的ClaudeKey"
export CLAUDE_MODEL="claude-sonnet-4-6"

总结对比

无论哪种方案，核心都是通过 Claude Code 对 OpenAI 兼容 API 的支持，将底层模型替换为 DeepSeek V4。我们也可以准备多个启动脚本，在 Claude 和 DeepSeek 模型之间灵活切换，根据不同任务选择最合适的模型。

延伸阅读：

• Claude Code 官方文档
• OpenRouter 模型列表
• DeepSeek 开放平台
• vLLM 部署指南