Claude Code 配置 DeepSeek 教程

这篇文章记录一次比较完整的 Claude Code + DeepSeek 配置流程。

目标很明确：把 Claude Code 这个编码工具跑起来，然后通过 ccSwitch 接入 DeepSeek 的 V4 Pro / V4 Flash 模型。这样既能继续使用 Claude Code 的工程化能力，又可以尝试 DeepSeek API 在成本和上下文长度上的优势。

Claude Code 通过 ccSwitch 接入 DeepSeek 的整体链路

本文主线以 Windows 为例，尤其是 PowerShell；macOS、Linux、CMD 的命令会放在对应位置作为补充。

注意：模型价格、安装命令、模型名称都可能变化。本文的安装命令参考 Claude Code 官方文档，DeepSeek 模型与价格参考 DeepSeek API 文档。实际操作前建议再打开官方页面确认一次。

1. 先理解这套组合

Claude Code 本身是一个 agentic coding 工具，可以读取代码库、修改文件、运行命令，并和终端、IDE、桌面端等开发环境集成。官方文档里也明确提到，Terminal CLI 和 VS Code 可以支持第三方 provider。

DeepSeek 这边目前提供了面向 API 调用的 V4 系列模型：

deepseek-v4-pro
deepseek-v4-flash

这两个模型都可以通过 DeepSeek 的 Anthropic Format 接口调用：

1	https://api.deepseek.com/anthropic

ccSwitch 的作用，是把这些 provider 配置集中管理起来。它可以管理 Claude Code、Codex、OpenCode、Gemini CLI 等 AI 编程工具的模型配置，避免你手动去改一堆 JSON、TOML 或环境变量。

这篇教程最终要跑通的是：

1	Claude Code -> ccSwitch -> DeepSeek API -> deepseek-v4-pro / deepseek-v4-flash

2. 安装 Claude Code

2.1 Windows PowerShell 安装

打开 PowerShell，执行官方提供的安装命令：

1	irm https://claude.ai/install.ps1 \| iex

Claude Code 常用安装命令

安装完成后，重新打开一个终端，检查版本：

1	claude --version

如果能看到版本号，说明 Claude Code 已经安装成功。

2.2 Windows CMD 安装

如果你使用的是 CMD，不要直接复制 PowerShell 的 irm 命令。CMD 应该使用：

1	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果你看到类似 The token '&&' is not a valid statement separator 的报错，大概率是把 CMD 命令放到了 PowerShell 里执行。

2.3 macOS / Linux / WSL 安装

macOS、Linux、WSL 可以使用：

1	curl -fsSL https://claude.ai/install.sh \| bash

macOS 也可以用 Homebrew：

1	brew install --cask claude-code

Windows 也可以用 WinGet：

1	winget install Anthropic.ClaudeCode

不过 WinGet 安装通常不会自动更新，后续可以定期运行：

1	winget upgrade Anthropic.ClaudeCode

2.4 Windows 上建议安装 Git for Windows

Claude Code 官方文档建议 Windows 原生环境安装 Git for Windows。这样 Claude Code 可以使用 Bash 工具；如果没有 Git for Windows，它会退回使用 PowerShell 作为 shell 工具。

安装 Git for Windows 后，重新打开终端再运行：

1	claude --version

3. 启动并验证 Claude Code

Claude Code 是基于项目目录工作的。建议先进入一个你准备测试的项目文件夹：

1 2	cd D:\your-project claude

第一次进入某个目录时，它可能会询问是否信任当前文件夹。确认这个目录是你自己的项目后，选择 Yes 即可。

进入 Claude Code 后，常用验证命令有：

1 2	/context /model

/context：查看当前上下文使用情况。
/model：查看或切换当前模型。

如果此时提示不能连接官方服务，也不用急。本文后面会通过 ccSwitch 改成 DeepSeek provider。

4. 安装 ccSwitch

ccSwitch 是一个跨平台桌面工具，项目地址是：

1	https://github.com/farion1231/cc-switch

它主要解决几个问题：

集中管理 Claude Code、Codex、OpenCode、Gemini CLI 等工具的 provider。
支持一键切换模型配置。
提供 MCP、Prompts、Skills 等统一管理入口。
支持系统托盘快速切换。
可以查看部分 provider 的用量和成本信息。

4.1 Windows 安装

进入 ccSwitch 的 GitHub Releases 页面，下载 Windows 安装包。Windows 用户优先选择 .msi 安装包；如果不想安装，也可以下载 portable ZIP。

ccSwitch 添加 DeepSeek Provider 的配置示意

下载后直接安装并打开 ccSwitch。

4.2 macOS / Linux 安装

macOS 可以参考项目说明使用 Homebrew：

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

Linux 通常可以从 Releases 下载 .deb、.rpm、.AppImage 等安装包，按自己的发行版选择即可。

5. 创建 DeepSeek API Key

打开 DeepSeek 开放平台：

1	https://platform.deepseek.com

网页对话和 API 调用是两套逻辑。网页上和 DeepSeek 对话不等于 API 免费；要让 Claude Code 调用 DeepSeek 模型，需要在开放平台里充值并创建 API Key。

流程大致是：

登录 DeepSeek 开放平台。
进入充值页面，按自己的需求小额充值。
打开 API Keys 页面。
点击创建 API Key。
输入一个便于识别的名称，比如 claude-code.
复制生成的 API Key。

这里有一个很重要的提醒：

API Key 只在创建时完整显示一次。关闭页面后就看不到了。如果丢失，只能重新创建一个新的 Key。

不要把真实 API Key 写进博客、截图、仓库、聊天记录或公开笔记里。后面配置时也只使用类似下面这样的占位符：

1	sk-xxxxxxxxxxxxxxxxxxxxxxxx

6. 在 ccSwitch 中添加 DeepSeek Provider

打开 ccSwitch，进入 Claude Code 的 provider 配置页面，点击添加 provider。

如果 ccSwitch 内置了 DeepSeek 预设，就直接选择 DeepSeek；如果需要手动配置，可以按下面的核心信息填写：

配置项	值
Provider 名称	DeepSeek V4 Pro
API Key	你的 DeepSeek API Key
Base URL	`https://api.deepseek.com/anthropic`
主模型	`deepseek-v4-pro`
快速模型	`deepseek-v4-flash`

如果你希望同时配置 Claude Code 里常见的模型槽位，可以按这个思路映射：

Claude Code 槽位	建议模型
Opus	`deepseek-v4-pro`
Sonnet	`deepseek-v4-pro`
Haiku	`deepseek-v4-flash`

这样做的好处是：日常复杂任务用 V4 Pro，轻量任务或快速验证可以切到 V4 Flash。

配置完成后，先点击测试按钮确认 API 是否可用。测试成功后，再点击启用。

如果 ccSwitch 支持余额查询，也可以配置余额查询功能，这样能在工具里直接看到剩余金额。但这一步不是必须的，先把模型跑通更重要。

7. 在 Claude Code 中验证 DeepSeek 是否生效

配置启用后，回到终端，进入你的项目目录：

1 2	cd D:\your-project claude

进入 Claude Code 后，先查看上下文：

/context

如果 provider 已经切到 DeepSeek，界面里应该能看到类似 deepseek-v4-pro 的模型信息。

Claude Code 中验证 DeepSeek 模型是否生效

再查看模型切换：

/model

如果配置了多个模型槽位，你可以在这里切换到 V4 Pro 或 V4 Flash。

常见验证动作：

1
2
3

/context
/model
请简单说明当前项目是做什么的

如果它能正常读取项目上下文并回答，说明 Claude Code -> ccSwitch -> DeepSeek 这条链路已经跑通。

8. 成本与使用建议

DeepSeek 的价格会调整，所以这里不建议死记视频里的旧价格。以我写这篇文章时的官方文档为准，DeepSeek V4 系列按每 100 万 token 计价，并区分缓存命中、缓存未命中和输出 token。

当前官方文档中，两个模型的关键信息是：

模型	上下文	缓存命中输入	缓存未命中输入	输出
`deepseek-v4-flash`	1M	$0.0028 / 1M tokens	$0.14 / 1M tokens	$0.28 / 1M tokens
`deepseek-v4-pro`	1M	$0.003625 / 1M tokens	$0.435 / 1M tokens	$0.87 / 1M tokens

官方文档还标注：deepseek-v4-pro 当前有 75% 折扣，并延长到 2026/05/31 15:59 UTC。这个时间之后价格可能变化，所以长期使用前，一定要重新查看 DeepSeek 官方价格页。

我的建议是：

先小额充值测试，不要一开始充太多。
日常 coding 主力可以先用 V4 Pro。
简单问答、轻量修改、低风险任务可以切 V4 Flash。
长上下文任务要关注输入 token，尤其是大仓库、大日志、大文档。
ccSwitch 如果能展示用量仪表盘，建议打开，方便复盘成本。

9. 常见问题

Q1：`claude` 命令不存在

通常是安装目录没有加入 PATH，或者终端没有重启。

可以先重新打开 PowerShell，再运行：

1	claude --version

如果仍然不行，回看安装完成时的提示，通常会给出一条把安装目录加入环境变量的命令。

Q2：PowerShell 和 CMD 命令混用了

PowerShell 使用：

1	irm https://claude.ai/install.ps1 \| iex

CMD 使用：

1	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果 PowerShell 报 && 相关错误，说明你用了 CMD 命令；如果 CMD 报 irm 不存在，说明你用了 PowerShell 命令。

Q3：API Key 无效

优先检查：

是否复制完整。
是否多复制了空格或换行。
DeepSeek 账户是否有余额。
Base URL 是否填成了 https://api.deepseek.com/anthropic。
模型名是否写成了 deepseek-v4-pro 或 deepseek-v4-flash。

Q4：ccSwitch 启用后 Claude Code 还是旧模型

先确认 ccSwitch 当前启用的是 DeepSeek provider。然后关闭当前 Claude Code 会话，重新打开终端，再进入项目运行：

claude

有些工具切换 provider 后需要重启终端或重启 CLI 才能生效。ccSwitch 文档里也提到，大多数工具切换后仍然建议重启对应 CLI。

Q5：`/model` 看不到想要的模型

检查 ccSwitch 中 Claude Code 的模型槽位配置。建议至少确认：

Opus 是否填了 deepseek-v4-pro
Sonnet 是否填了 deepseek-v4-pro
Haiku 是否填了 deepseek-v4-flash

配置后保存并启用，再重启 Claude Code。

Q6：Claude Code 提示无法连接官方服务

如果你没有使用官方 Claude 模型，这个提示不一定代表 Claude Code 本身不能用。重点是确认第三方 provider 是否接管成功。

可以用下面两个命令确认：

1 2	/context /model

如果当前模型已经显示为 DeepSeek，并且可以正常回答项目问题，就说明第三方 provider 链路已经跑通。

10. 总结

这套流程的核心不是“让 DeepSeek 变成 Claude”，而是把 Claude Code 的工程工作流和 DeepSeek 的 API 模型组合起来：

Claude Code 负责终端里的工程交互。
ccSwitch 负责 provider 和模型配置。
DeepSeek API 提供实际模型能力。

配置成功后，你就可以在熟悉的 Claude Code 工作流里使用 DeepSeek V4 Pro / V4 Flash。后续真正值得关注的，是两件事：模型是否适合你的代码任务，以及长期使用成本是否可控。

建议先用一个小项目跑通 /context、/model 和一次简单修改，再把它放进日常开发流程里。