前言

最近很多人想用 Claude Code 做项目开发,但又不想登录 Claude / Anthropic 账号。其实现在有一个比较方便的方案:使用 DeepSeek API Key 接入 Claude Code

准确来说:

可以不登录 Claude / Anthropic 账号,用 DeepSeek API Key 接入 Claude Code;但你仍然需要 DeepSeek 平台账号和 API Key。

Claude Code 本身是一个运行在终端里的 AI 编程助手,可以读取项目、分析代码、修改文件、执行命令;DeepSeek 提供了 Anthropic-compatible API,因此可以通过配置 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 的方式接入 Claude Code。DeepSeek 官方文档中也给出了 Claude Code 接入方式,Base URL 为 https://api.deepseek.com/anthropic

本篇文章主要记录:

  1. 安装 Claude Code
  2. 安装 CC Switch
  3. 使用 CC Switch 管理 DeepSeek Provider
  4. 启动 Claude Code 并进入项目对话
  5. 常见问题排查

一、最终效果

配置完成后,我们可以在终端中直接运行:


claude

然后进入 Claude Code 对话界面。

示例:


你是什么模型?

返回效果类似:


我是 DeepSeek V4 Pro,由 Anthropic 的 Claude Code 平台托管和调用。

需要注意的是,模型自己回答“我是谁”并不是最严谨的判断方式,更可靠的是看:

  1. CC Switch 当前启用的 Provider
  2. DeepSeek 后台 API 用量
  3. Claude Code 顶部显示的模型 / billing 状态

二、准备条件

开始之前,需要准备这些东西:

项目 说明
Windows 电脑 本文以 Windows PowerShell 为例
Node.js 18+ 安装 Claude Code 需要
Git for Windows Windows 用户建议安装
DeepSeek 平台账号 用于创建 API Key
DeepSeek API Key 用于调用 DeepSeek 模型
Claude Code 终端 AI 编程工具
CC Switch 用于管理 Claude Code 的模型和 Provider

DeepSeek 官方文档中也说明,如果从零安装 Claude Code,需要 Node.js 18+,Windows 用户需要 Git for Windows,然后通过 npm 安装 Claude Code。


三、安装 Claude Code

打开 PowerShell,执行:


npm install -g @anthropic-ai/claude-code

安装完成后,检查版本:


claude --version

如果能正常显示版本号,说明 Claude Code 安装成功。

注意命令是:


claude --version

不是:


claude -- version

--version 中间不能加空格。


四、安装 CC Switch

CC Switch 是一个用于管理多个 AI CLI 工具 Provider 的桌面工具。它支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具,并支持 Provider 管理、一键切换、系统托盘切换等功能。

打开 CC Switch GitHub Releases 页面:


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

进入后选择最新版本下载。

Windows 用户一般下载:


CC-Switch-v版本号-Windows.msi

如果你不想安装,也可以下载便携版:


CC-Switch-v版本号-Windows-Portable.zip

建议普通用户直接下载 .msi 安装包。

不要下载:


Source code.zip
Source code.tar.gz

这两个是源码,不是安装包。

CC Switch 的 Release 页面会列出不同版本和更新内容,例如 v3.14.0、v3.13.0 等。


五、在 CC Switch 中配置 DeepSeek Provider

打开 CC Switch 后,进入 Provider 管理页面。

点击:


Add Provider / 添加供应商

如果 CC Switch 里有 DeepSeek 预设,可以直接选择 DeepSeek。

如果没有,就选择:


Custom / Anthropic Compatible

然后填写以下信息。

1. 供应商名称


DeepSeek

2. 官网链接


https://platform.deepseek.com

3. API Key

这里填写你的 DeepSeek API Key。

格式一般类似:


sk-xxxxxxxxxxxxxxxxxxxxxxxx

不要把 API Key 发给别人,也不要截图公开。

4. Base URL

如果界面需要填写 Base URL,填写:


https://api.deepseek.com/anthropic

DeepSeek Anthropic-compatible API 的官方 Base URL 就是这个。

5. 模型配置

推荐配置如下:


主模型 / Main Model:
deepseek-v4-pro[1m]

Opus Model:
deepseek-v4-pro[1m]

Sonnet Model:
deepseek-v4-pro[1m]

Haiku Model:
deepseek-v4-flash

Subagent Model:
deepseek-v4-flash

Effort:
max

DeepSeek 官方 Claude Code 配置示例中,也使用了这些环境变量和模型配置。


在 CC Switch 中添加 DeepSeek Provider,只需要填写供应商名称、官网链接和 API Key,下方配置会自动填充或手动设置。


六、启用 DeepSeek Provider

配置完成后,点击:


启用 / Enable

如果你开启了完整 URL 连接模式,可能会出现提示:


此供应商开启了完整 URL 连接模式,需要路由服务才能正常使用,请先启动路由

这个不是 API Key 错误,也不是 Claude Code 安装失败。

它的意思是:当前 Provider 需要 CC Switch 的本地路由服务来转发请求。

解决方法:


CC Switch
→ Settings / 设置
→ Routing Service / 路由服务
→ Start / 启动

然后再回到 Provider 页面,重新点击:


Enable / 启用

CC Switch 官方说明中也提到,它可以对 Claude Code 等工具进行 Provider 配置管理,并且 Claude Code 支持热切换 Provider 数据。


七、启动 Claude Code 并进入项目

现在打开 PowerShell,进入你的项目目录。

例如我的项目在:


D:\code\3DHome\20ave3D

那么执行:


cd D:\code\3DHome\20ave3D

然后启动 Claude Code:


claude

进入之后,就可以直接和 Claude Code 对话。

第一次进入项目,建议先让它读取项目结构,不要马上改文件:


请先读取这个项目,帮我总结项目结构,找出主要入口文件,并说明这个项目是如何运行的。现在不要修改任何文件。

或者英文:


Please read this project first. Summarize the folder structure, identify the main entry files, and explain how this project runs. Do not modify any files yet.

可以看到 Claude Code 已经在项目目录中启动,并且当前模型显示为 deepseek-v4-pro,说明 DeepSeek Provider 已经生效。


八、临时手动配置方式

如果不用 CC Switch,也可以直接在 PowerShell 里临时配置环境变量。


$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"

然后进入项目:


cd D:\code\ave
claude

但是这种方式每次重新打开终端都要重新配置,所以更推荐使用 CC Switch 管理。


九、常见问题排查

1. claude 命令无法识别

如果出现:


claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称

说明 Claude Code 没有安装成功,或者环境变量 PATH 没刷新。

可以尝试:


claude --version

如果仍然不行,重新打开 PowerShell,或者重新安装:


npm install -g @anthropic-ai/claude-code

2. Claude Code 还是要求登录 Claude 账号

这种情况通常说明 DeepSeek Provider 没有生效。

检查:


1. CC Switch 是否已打开
2. DeepSeek Provider 是否已经 Enable
3. Routing Service 是否 Running
4. Claude Code Routing 是否开启
5. PowerShell 是否重新打开

如果 Provider 没有成功启用,Claude Code 可能会回到默认的 Claude 官方登录流程。


3. 提示需要启动路由服务

如果看到:


此供应商开启了完整 URL 连接模式,需要路由服务才能正常使用,请先启动路由

解决方法:


CC Switch
→ Settings
→ Routing Service
→ Start

启动成功后,再启用 DeepSeek Provider。


4. 401 Unauthorized

一般是 API Key 错误。

检查:


ANTHROPIC_AUTH_TOKEN

必须填写 DeepSeek API Key,而不是 Claude API Key。


5. 模型不存在

如果提示模型不存在,检查模型名称。

推荐使用:


deepseek-v4-pro[1m]
deepseek-v4-flash

不要随便写成:


deepseek-chat
deepseek-reasoner

因为 Claude Code 这里走的是 DeepSeek 的 Anthropic-compatible API,不是普通 OpenAI-compatible API。


十、总结

最终流程可以总结为:


1. 安装 Node.js 18+
2. 安装 Git for Windows
3. 安装 Claude Code
4. 注册 DeepSeek 平台账号
5. 创建 DeepSeek API Key
6. 下载并安装 CC Switch
7. 在 CC Switch 中添加 DeepSeek Provider
8. 填写 API Key 和 Anthropic-compatible Base URL
9. 启用 DeepSeek Provider
10. 进入项目目录运行 claude

核心配置是:


Base URL:
https://api.deepseek.com/anthropic

API Key:
你的 DeepSeek API Key

Main Model:
deepseek-v4-pro[1m]

Small Model:
deepseek-v4-flash

这样就可以做到:

不登录 Claude / Anthropic 账号,通过 DeepSeek API Key 接入 Claude Code,并用 CC Switch 管理模型切换。

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐