Claude Code 安装 + DeepSeek V4 接入指南

目录

1. 安装 Claude Code CLI
2. VS Code 扩展
3. 接入 DeepSeek V4
4. 常见问题

---

一、安装 Claude Code CLI

1.1 原生安装

不需要 Node.js，一行命令：

macOS / Linux / WSL：

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

Windows PowerShell：

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

Homebrew / WinGet：

brew install --cask claude-code          # macOS
winget install Anthropic.ClaudeCode      # Windows

1.2 npm 安装

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

Node.js ≥ 18 即可。

1.3 Windows PATH

若 claude 命令无法识别，将 %USERPROFILE%\.local\bin 添加到系统 PATH。

1.4 首次使用

cd your-project
claude

进入后运行 /init 生成 CLAUDE.md。

常用命令：

命令	功能
/init	生成项目上下文文件
/clear	清空对话
/compact	压缩上下文
/cost	查看 Token 用量

---

二、VS Code 扩展

扩展市场搜索 “Claude Code”，安装 Anthropic 官方扩展。

在 settings.json 中配置 DeepSeek V4（Ctrl+Shift+P → “Open User Settings (JSON)”）：

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.deepseek.com/anthropic" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" },
    { "name": "ANTHROPIC_MODEL", "value": "deepseek-v4-pro[1m]" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "deepseek-v4-pro[1m]" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "deepseek-v4-pro[1m]" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "deepseek-v4-flash" },
    { "name": "CLAUDE_CODE_SUBAGENT_MODEL", "value": "deepseek-v4-flash" },
    { "name": "CLAUDE_CODE_EFFORT_LEVEL", "value": "max" }
  ]
}

---

三、接入 DeepSeek V4

3.1 获取 API Key

platform.deepseek.com/api_keys → 创建 API Key。

3.2 模型规格

	V4-Pro	V4-Flash
参数	1.6T / 49B 激活	284B / 13B 激活
上下文	1M tokens	1M tokens
最大输出	384K tokens	384K tokens
输入价格	¥12/M（缓存命中 ¥1/M）	¥1/M（缓存命中 ¥0.2/M）
输出价格	¥24/M	¥2/M
思考模式	high / max	high / max

V4-Pro 当前 2.5 折优惠至 2026-05-31：输入 ¥3/M，输出 ¥6/M。

3.3 配置方式一：环境变量

macOS / Linux：

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的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：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的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"

永久生效：

• macOS/Linux：追加到 ~/.bashrc 或 ~/.zshrc，执行 source
• Windows：[Environment]::SetEnvironmentVariable("变量名", "值", "User")

3.4 配置方式二：settings.json（推荐）

写入 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "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_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  },
  "model": "opus"
}

3.5 模型映射

Claude 角色	映射模型
Opus	deepseek-v4-pro[1m]
Sonnet	deepseek-v4-pro[1m]
Haiku	deepseek-v4-flash
SubAgent	deepseek-v4-flash

[1m] 后缀启用 1M 上下文，去掉则使用默认上下文。

3.6 思考模式

V4 通过 CLAUDE_CODE_EFFORT_LEVEL 控制，不再用模型名区分：

• max — 极限推理，V4-Pro 响应较慢，建议 export API_TIMEOUT_MS=600000
• high — 高推理
• 不设 — 非思考模式

3.7 启动

claude

---

四、常见问题

Q1: deepseek-chat / deepseek-reasoner 还能用吗？

旧 ID 当前映射到 deepseek-v4-flash，2026-07-24 彻底停用，建议迁移到 deepseek-v4-pro / deepseek-v4-flash。

Q2: API 调用失败？

• 确认 API Key 有效
• 确认能访问 api.deepseek.com
• echo $ANTHROPIC_AUTH_TOKEN 检查环境变量

Q3: 上下文超限？

V4 支持 1M tokens，一般不会超。如超出用 /clear 或 /compact。确认模型名带 [1m] 后缀。

Q4: 工具调用不生效？

确认用的是 deepseek-v4-pro 或 deepseek-v4-flash，不要用旧模型名。

Q5: V4-Pro 太慢？

export API_TIMEOUT_MS=600000

或在 ~/.claude/settings.json 中加入 "API_TIMEOUT_MS": "600000"。或去掉 CLAUDE_CODE_EFFORT_LEVEL 切换到非思考模式。

Q6: 不支持图片

V4 是纯文本模型，截图会被替换为 [Image #1] 占位符。

---

参考：DeepSeek 官方 — 接入 Claude Code · Anthropic API 兼容指南