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-flash2026-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-prodeepseek-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 兼容指南

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐