DeepSeek V4 + Claude Code 开发实践指南

本文记录如何基于 DeepSeek V4 大模型，通过 Claude Code + CC-Switch 搭建高效的开发环境。

1. 为什么选这套方案？

在开始之前，我想先聊聊为什么推荐这套组合。

Claude Code 是我目前最推荐的 AI 编程工具之一。它的上手曲线略陡，但一旦完成安装、接入模型、定好规范，你会发现它远不止是一个对话窗口——它能直接帮你写代码、跑命令、跨文件重构，是一个真正能替你动手的代理工具。

DeepSeek V4 的发布，让这套工具链拥有了前所未有的性价比。

参考 DeepSeek 官方定价：

在这里插入图片描述

在这里插入图片描述

单看 API 定价也许不会立刻感到便宜，但 DeepSeek V4 真正的杀手锏是极高的缓存命中率——轻松达到 95%+。这意味着大量重复或相似请求几乎不产生新开销，10 块钱就能支撑长时间的轻度使用。你不再需要在“能力”和“成本”之间做任何妥协，百万上下文也不再是高端订阅才有的特权，而成了你本地终端的标准配置。

2. DeepSeek V4 介绍

DeepSeek V4 是 DeepSeek 于 2026 年 4 月正式发布并开源的新一代大语言模型系列：

版本 参数规模 激活参数 上下文长度 定位
V4-Pro 1.6T 49B 1M token 旗舰编程模型
V4-Flash 284B 13B 1M token 快速响应模型

核心亮点

  • Agent Coding 能力显著增强：内部评测体验优于 Claude Sonnet 4.5，交付质量接近 Opus 4.6 非思考模式
  • 百万上下文成标配：引入全新 DSA2 稀疏注意力机制（结合 CSA 和 HCA），在 1M 上下文场景下推理计算量仅为 V3.2 的 27%，KV 缓存降至 10%
  • 国产芯片适配：首次在华为昇腾（Ascend）NPU 上完成适配验证，打破英伟达 CUDA 生态垄断
  • 专为 Agent 优化：API 同时支持 OpenAI ChatCompletions 接口与 Anthropic 接口，专项适配 Claude Code、OpenClaw、OpenCode、CodeBuddy 等主流 Agent 产品

参考：DeepSeek V4 发布解读

3. Claude Code 介绍

Claude Code 是 Anthropic 推出的 AI 编程命令行工具（CLI Agent），核心能力包括：

  • 代码理解与生成：在终端内直接与 AI 对话，自动完成编程任务
  • 工具调用（Tool Use）：可自动执行读写文件、搜索代码、运行命令等操作
  • Agent 模式：能自主规划和执行复杂的多步骤任务
  • Skill 机制：支持通过 Skill 扩展领域知识，实现特定技术栈的深度辅助
  • 多供应商支持：通过环境变量可接入任何兼容 Anthropic API 的模型供应商（如 DeepSeek）

Claude Code 的设计哲学是 “AI 不再只是一个对话窗口，而是一个可以直接帮你写代码、改代码、跑命令的代理工具”，特别适合需要频繁上下文切换的开发场景。

官方文档：Claude Code

4. CC-Switch 介绍

CC-Switch 是一款开源的 Claude Code / Codex / Gemini CLI 图形化配置管理工具（GitHub 5900+ stars），用于一站式管理不同大语言模型供应商的 API 配置。

核心功能

功能 说明
供应商管理 内置 17+ 预设供应商模板（DeepSeek、智谱GLM、MiniMax、PackyAPI 等）
一键切换 图形化界面切换模型，Claude Code 热重载即时生效
配置可视化 无需手动编辑 JSON，降低配置出错风险
健康检查 配置完成后可验证 API 连通性
MCP 管理 支持 Model Context Protocol 服务器的增删改查
Skills 管理 图形化管理 Skills 的启用与禁用
云同步 通过坚果云 / OneDrive / Dropbox 实现多设备配置同步
系统提示词 支持自定义系统级 Prompt

项目地址：cc-switch | 使用教程

5. 安装与配置说明

5.1 安装 Node.js 环境

Claude Code 依赖 Node.js 运行，推荐使用 LTS 版本（>= 18.x）。

macOS / Linux：

node --version

brew install node

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
nvm use --lts

Windows：

  • 从 Node.js 官网 下载 LTS 版本安装包
  • 或使用 winget 安装：
winget install OpenJS.NodeJS.LTS

5.2 安装 Claude Code

macOS 安装
npm install -g @anthropic-ai/claude-code
claude --version
Windows 安装

Windows 必须先装 Git，因为 Claude Code 底层用 Git Bash 执行命令。

winget install Git.Git
npm install -g @anthropic-ai/claude-code

配置 PATH（非常重要）：
Claude Code 的可执行文件默认在 C:\Users\你的用户名\.local\bin。
把这个路径加到系统环境变量的 Path 里：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到「Path」→「编辑」→「新建」
  3. 粘贴路径 C:\Users\你的用户名\.local\bin
  4. 必须重启终端才能生效
claude --version

安装后首次运行 claude，会进入交互式编程环境。退出方式为 /exit。

5.3 安装 CC-Switch

macOS：

brew tap farion1231/ccswitch
brew install --cask cc-switch

首次打开 macOS 若提示"无法验证开发者"，前往「系统设置 → 隐私与安全性 → 仍要打开」即可。

Windows（推荐）：

  • 从 GitHub Releases 下载最新的 CC-Switch-v*-Windows.msi
  • 双击安装，按向导完成
  • 安装完成后自动创建桌面快捷方式

Linux：

# 下载 .deb 或 .AppImage 文件安装
# .deb 安装：sudo dpkg -i cc-switch_*.deb
# .AppImage：chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

5.4 获取 DeepSeek API Key

  1. 访问 DeepSeek API 开放平台
  2. 注册 / 登录账号（支持邮箱、手机号注册）
  3. 进入「API Keys」页面 → 点击「Create New API Key」
  4. 立即保存！Key 仅显示一次，格式为 sk-xxxxxxxx
  5. 确保账户有可用余额（通常充值 10 元即可满足长期使用）

安全提醒：API Key 是你的个人凭证，不要分享给他人，不要提交到代码仓库。

5.5 CC-Switch 配置 DeepSeek 模型

在这里插入图片描述

  1. 打开 CC-Switch 桌面应用
  2. 在顶部标签栏选择 「Claude Code」
  3. 点击右上角 「+」 按钮新建配置
    在这里插入图片描述
    在这里插入图片描述

注意：deepseek-v4-pro[1m]和deepseek-v4-flash模型可以按自己需求修改配置

  1. 选择 DeepSeek 预设模板，或手动填写以下参数：
配置项 推荐值 说明
Base URL https://api.deepseek.com/anthropic DeepSeek Anthropic 兼容端点
认证类型 ANTHROPIC_AUTH_TOKEN 固定值
API Key sk-xxxxxxxx 你的 DeepSeek API Key
主模型 deepseek-v4-pro[1m] 必须带 [1m] 才能激活百万 Token 上下文
默认 Opus 模型 deepseek-v4-pro[1m] 高端任务模型
默认 Sonnet 模型 deepseek-v4-pro[1m] 均衡任务模型
默认 Haiku 模型 deepseek-v4-flash 快速任务模型
子代理模型 deepseek-v4-flash 子任务模型
努力程度 max CLAUDE_CODE_EFFORT_LEVEL
API 超时 3000000（50 分钟） 防止复杂任务超时
  1. 点击 「健康检查」 验证配置连通性
  2. 启用该配置（点击启用开关）
  3. Claude Code 会自动热重载，无需重启终端

5.6 手动配置方式（settings.json）

如果你不使用 CC-Switch，也可以直接编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

macOS / Linux 等效环境变量（写入 ~/.bashrc 或 ~/.zshrc）：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Windows 等效环境变量（PowerShell，写入 $PROFILE）：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

注意：两种方式二选一即可，CC-Switch 本质也是写入 settings.json。混合使用时以文件配置为准。

5.7 验证配置

在这里插入图片描述

启动 Claude Code 后执行 /status 命令，若显示模型为 deepseek-v4-pro[1m] 则表示配置成功。

首次启动时会有初始化设置：

  • 选择颜色主题（以后可用 /theme 改）
  • 安全提示（仔细读，这是保护你代码的）
  • 确认当前目录是否可信（选「是」）

6. 最佳实践与避坑指南

6.1 配置避坑清单

接入 DeepSeek V4 时，以下配置细节最容易踩坑，请务必留意：

注意点 说明
模型名必须带 [1m] deepseek-v4-pro[1m] 才能激活百万 Token 上下文；不带后缀仅 128K。
超时设置要足够大 建议 API_TIMEOUT_MS=3000000（50分钟），防止复杂任务中途超时。
关闭非必要流量 设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1，减少非功能性 API 调用，降低额外开销。
不支持 Thinking 扩展 DeepSeek API 不兼容 Anthropic 的 thinking 扩展字段，复杂推理场景请直接依赖 V4-Pro 自身的推理链。
图像与文档类型暂不支持 DeepSeek 兼容端点暂不支持 image、document 类型输入。

6.2 CLAUDE CODE最佳实践

1. 编写 CLAUDE.md

CLAUDE.md 是 Claude Code 的“行为准则”，用于定义你的编码习惯、项目规则和安全红线。它决定了 AI 是按你的方式写代码，还是按它的猜测写代码。

文件位置：

  • 全局 CLAUDE.md（~/.claude/CLAUDE.md）：适用于所有会话，放置跨项目的通用规则。
  • 项目 CLAUDE.md（项目根目录 CLAUDE.md）：针对当前项目的特殊约定，优先级高于全局配置。

编写原则：

  • 这不是越长越好。经验表明，超过 100 行后 Claude 会开始遗漏内容。
  • 只放它容易迷糊的边界规则，比如：命名规范、测试框架要求、禁止使用的库、分支管理策略等。
  • 避免重复常识性内容（如“不要写 bug”）。
2. 善用权限控制

刚安装时，Claude Code 每次执行命令都需要手动确认，频繁操作下容易打断心流。你可以通过以下方式优化体验：

  • 精细化授权：使用 /permissions 命令，将信任的工具（如 npm run lint、git commit、mkdir）加入允许列表，此后不再重复询问。
  • 沙箱隔离：当需要处理高风险操作或陌生依赖时，使用 /sandbox 开启沙箱模式，将文件系统访问限制在当前项目范围内。
3. 针对具体项目启动

不要在根目录或包含大量无关文件夹的路径下直接启动 Claude Code。上下文越干净，AI 的输出越精准。

cd /你的项目路径
claude

如果你对当前目录有绝对信任，可以使用以下命令跳过权限提示，大幅提升操作效率：

claude --dangerously-skip-permissions

⚠️ 郑重提醒：此命令会跳过所有安全确认弹窗，请仅在你完全信任的目录下使用，切勿在敏感路径（如 ~/.ssh、系统根目录等）执行。

7. 总结

通过 DeepSeek V4 + Claude Code + CC-Switch 这套组合，我们获得的不仅是一个 AI 编程环境，更是一套完整的生产力方案：

极致性价比：得益于 DeepSeek V4 极高的缓存命中率，日常重度使用月费可轻松控制在百元以内。相比官方 Claude Opus，成本大大节省，却依然保持接近 Opus 4.6 的交付质量。

百万上下文成为标配：1M token 的超长上下文能轻松容纳整个项目代码库，跨文件重构、全库分析再也不用受上下文限制。

完全可控的工具链：CC-Switch 让模型切换、配置同步、健康检查全部可视化，模型不满意随时换，框架升级由你决定，所有数据留在本地，真正做到“生产资料在自己手里”。

这套方案的核心优势就两个字：自由——不再被昂贵的订阅费绑架，不再被封闭的生态锁定，用极低的成本，享受顶级的 AI 编程体验。

参考资源

Logo
北京朝阳AI社区

更多推荐

cover

2026年Gemini3.1Pro专家OfficeHour实战指南

avatar 北京朝阳AI社区
cover

LangGraph 多 Agent 架构与 Supervisor 模式

avatar 北京朝阳AI社区
cover

【Harness Agent】源码剖析（三）：沙箱安全与工具生态——从白名单到 MCP

avatar 北京朝阳AI社区