该md直接发给 Ai，让AI帮你装，有用的话点个赞吧

# Claude Code 接入 DeepSeek 完整教程（VS Code 方案）

> **一句话**：在 VS Code 中用 Claude Code 写代码，后端接 DeepSeek API，国内直连不翻墙，费用约为官方的 1/50。
>
> **三步搞定**：
> 1. 装 VS Code 插件（图形化对话面板）
> 2. 装 Claude Code CLI + 配 settings.json（指向 DeepSeek）
> 3. 开用
>
> 全程不走 Anthropic 官方服务器，无需海外支付方式，无需 VPN。
>
> ⚠️ API Key 以明文存在 settings.json 里，不要提交到 git，不要屏幕共享时暴露。

## 适用场景
国内开发者免翻墙在 **VS Code 中使用 Claude Code**，接入 DeepSeek API，费用约为官方的 1/50。

整体结构：
```
你写的代码 → VS Code（编辑器）
           → Claude Code 插件（对话面板 / 终端）
           → settings.json（配置路由和鉴权）
           → DeepSeek Anthropic 兼容 API
           → deepseek-v4-pro / deepseek-v4-flash
```

## 环境概览
本教程包含两个部分：
1. **Claude Code VS Code 插件** — 在 VS Code 扩展市场安装，提供对话面板、代码 diff、@-mention 等图形化功能
2. **Claude Code CLI**（命令行工具）— 由插件自动调用，也可独立在终端中运行

> 注意：VS Code 插件自带 CLI，但不会把它加到系统 PATH 中。
> 如果想在 VS Code 内置终端里直接敲 `claude` 命令，需要额外走 npm 全局安装（见第二章）。

---

## 〇、安装 VS Code 插件（图形界面）

在 VS Code 扩展市场安装 **Claude Code** 插件：

1. 打开 VS Code，按 `Ctrl+Shift+X` 打开扩展面板
2. 搜索 **Claude Code**
3. 点击 **Install**
4. 安装后在右侧活动栏会出现 Claude Code 的 Spark 图标 ✦

> 如果安装后不需要登录 Anthropic 账号，按下面的步骤配置好 settings.json 后，
> 在 VS Code 设置中搜索 `claudeCode.disableLoginPrompt` → 勾选，即可跳过登录。

---

## 一、前置检查

```powershell
# 1. 检查 Node.js（需 18+）
node -v

# 2. 检查 npm
npm -v

# 3. 确认有 DeepSeek API Key
# 注册地址：https://platform.deepseek.com
# 路径：API Keys → 创建 → 复制（Key 只显示一次）
```

---

## 二、安装 Claude Code CLI

```powershell
# 1. 安装指定版本（2.1.139 可跳过地区限制）
npm install -g @anthropic-ai/claude-code@2.1.139 --registry=https://registry.npmmirror.com

# 2. 验证安装
claude --version
# 期望输出：2.1.139 (Claude Code)
```

---

## 三、配置 settings.json

路径：`C:\Users\你的用户名\.claude\settings.json`

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SKIP_AUTH": "true",
    "DISABLE_AUTOUPDATER": "1"
  },
  "hasCompletedOnboarding": true
}
```

### 参数说明

| 环境变量 | 值 | 作用 |
|---------|-----|------|
| `ANTHROPIC_BASE_URL` | `https://api.deepseek.com/anthropic` | DeepSeek 的 Anthropic 兼容接口地址 |
| `ANTHROPIC_AUTH_TOKEN` | 你的 DeepSeek API Key | 鉴权令牌 |
| `ANTHROPIC_MODEL` | `deepseek-v4-pro[1m]` | 默认模型（带 `[1m]` 激活 100 万 token 上下文） |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `deepseek-v4-pro[1m]` | Opus 档映射 |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `deepseek-v4-pro[1m]` | Sonnet 档映射 |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `deepseek-v4-flash` | Haiku 档映射（轻量快速） |
| `CLAUDE_CODE_SUBAGENT_MODEL` | `deepseek-v4-flash` | 子 Agent 使用轻量模型 |
| `CLAUDE_CODE_SKIP_AUTH` | `true` | 跳过官方登录校验 |
| `DISABLE_AUTOUPDATER` | `1` | 禁止自动更新（避免覆盖旧版） |

---

## 四、安装 CC Switch（可选，推荐）

CC Switch 是一个可视化桌面工具，用于管理 Claude Code 的供应商和模型路由，切换模型只需点鼠标。

### 下载安装

```powershell
# 下载地址（最新版）
# https://github.com/farion1231/cc-switch/releases/latest
# Windows 选 CC-Switch-v版本号-Windows.msi

# 或直接用命令行下载（以 v3.16.3 为例）
curl.exe -L -o "$env:TEMP\CC-Switch.msi" "https://github.com/farion1231/cc-switch/releases/download/v3.16.3/CC-Switch-v3.16.3-Windows.msi"

# 安装
msiexec /i "$env:TEMP\CC-Switch.msi" /quiet /norestart
```

### CC Switch 配置步骤

1. 打开 CC Switch（开始菜单搜索）
2. 左上角确认选中 **Claude Code**
3. 点右上角 **「+」** → 搜索 **DeepSeek**
4. 填写参数：

| 字段 | 值 |
|------|-----|
| Base URL | `https://api.deepseek.com/anthropic` |
| API Key | 你的 DeepSeek API Key |
| Auth Type | `ANTHROPIC_AUTH_TOKEN` |
| API 格式 | `Anthropic Messages（原生）` |

5. 模型映射：

| 字段 | 值 |
|------|-----|
| `ANTHROPIC_MODEL` | `deepseek-v4-pro[1m]` |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `deepseek-v4-pro[1m]` |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `deepseek-v4-pro[1m]` |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `deepseek-v4-flash` |
| `CLAUDE_CODE_SUBAGENT_MODEL` | `deepseek-v4-flash` |

6. 点 **「启用」**

---

## 五、验证配置

### 方式 A：在 VS Code 中使用（推荐）
1. 打开 VS Code，点右侧活动栏的 Spark 图标 ✦
2. Claude Code 对话面板会自动加载配置，无需额外操作
3. 直接输入问题开始使用

### 方式 B：在终端中使用
```powershell
# 进入你的项目目录
cd 你的项目路径

# 启动 Claude Code（交互模式）
claude

# 进入后输入以下命令验证
/model       # 查看当前模型列表
```

或用管道模式快速测试：
```powershell
echo "Hello, what model are you?" | claude -p -
```

期望结果：
- 模型列表显示 `deepseek-v4-pro` / `deepseek-v4-flash`
- 对话能正常返回结果

---

## 六、常见问题

### Q: claude 命令找不到
- 检查 npm 全局安装路径是否在 PATH 中

### Q: 提示地区不支持
- 确保安装的是 `@anthropic-ai/claude-code@2.1.139`
- 确保 `settings.json` 中有 `"CLAUDE_CODE_SKIP_AUTH": "true"`

### Q: 401 Unauthorized
- API Key 复制错了，回 DeepSeek 控制台重新生成
- 注意前后不要有空格

### Q: 404 / model not found
- 模型名写错了，检查 `deepseek-v4-pro[1m]` 拼写
- 如果用 CC Switch 本地路由模式，去掉 `[1m]` 后缀

### Q: 网络超时
- DeepSeek 国内直连一般没问题
- 可尝试改 DNS 为阿里 `223.5.5.5` 或腾讯 `119.29.29.29`

---

## 七、费用参考

DeepSeek 价格（2026年6月）：
| 模型 | 输入 | 输出 |
|------|------|------|
| deepseek-v4-pro | ¥3/百万 tokens | ¥6/百万 tokens |
| deepseek-v4-flash | ¥0.5/百万 tokens | ¥1/百万 tokens |

对比 Claude 官方 API 约 **1/50** 的成本。

---

## 安全说明

### API Key 保护
- DeepSeek API Key 以明文形式存储在 `settings.json` 中，等同于密码
- **不要**将 `settings.json` 提交到 git 仓库（建议在 `.gitignore` 中添加 `.claude/`）
- **不要**在屏幕共享、录屏或截图中暴露 Key
- 如 Key 泄露，立即到 DeepSeek 控制台删除并重新生成

### 数据隐私
- Claude Code 会将你的代码发送到配置的 API 端点（本教程中为 DeepSeek）进行处理
- DeepSeek 的数据处理政策请查阅其官方文档：https://platform.deepseek.com
- 不要在对话中粘贴敏感信息（密码、Token、身份证号、银行卡号等）

### 跳过登录的注意事项
- `CLAUDE_CODE_SKIP_AUTH: true` 跳过了 Anthropic 官方登录校验
- 这意味着你**没有** Anthropic 官方订阅，而是通过第三方 API 使用
- 功能差异：部分 Claude 专属特性（如 Artifacts、Web Search）可能不可用

### CC Switch 安全
- 仅从官方 GitHub Releases 下载：https://github.com/farion1231/cc-switch/releases
- CC Switch 是**免费开源软件**，任何收费版本均为假冒
- 官方渠道不会向你索要登录凭据或要求充值

---

## 原理简述

```
你写的代码 → Claude Code（AI 编程 CLI）
           → 读取 settings.json（配置路由和鉴权）
           → DeepSeek Anthropic 兼容 API
           → deepseek-v4-pro / deepseek-v4-flash
```

关键点：Claude Code 支持通过环境变量 `ANTHROPIC_BASE_URL` 将 API 请求指向任意兼容 Anthropic Messages 协议的端点。DeepSeek 提供了这个兼容端点，所以只需要改配置就能接入，无需任何代理或 VPN。