Claude Code怎么接入国产模型deepseek-v4-pro

微信有朋友希望讲解一下claude code的安装教程，今天也做一下讲解共大家参考。

1. 准备工作

系统要求

组件	最低版本
操作系统	Windows 10/11、macOS 12+、Linux
Node.js	≥ 18.0（推荐 22 LTS）
npm	随 Node.js 自动安装
Git	任意版本（Windows 必需）
DeepSeek 账号	注册并充值（余额 ≥ ¥1 即可）

2. 第一步：安装 Node.js

Windows

官网安装（推荐新手）

打开浏览器访问 https://nodejs.org
点击左侧绿色 LTS 按钮下载 .msi 安装包
双击运行，一路点击「Next」，保持默认选项即可
安装完成后，关闭所有终端窗口并重新打开

验证安装——打开 PowerShell 或命令提示符，输入：

node --version   # 应输出 v22.x.x 或 v20.x.x
npm --version    # 应输出 10.x.x

macOS

方法一：官网安装

下载 .pkg 安装包 → 双击安装：

方法二：Homebrew 安装（推荐）

brew install node

验证安装：

node --version
npm --version

3. 第二步：安装 Git（Windows 必需）

Claude Code 在 Windows 上依赖 Git Bash 提供 Unix 命令支持。

Windows

访问 https://git-scm.com/
下载安装包，双击运行,「Next」到底
安装完成后重启终端

git --version   # 验证安装

macOS

# 已安装 Xcode Command Line Tools 则自带 Git
git --version

# 或手动安装
brew install git

4. 第三步：安装 Claude Code

全局安装

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

Windows 用户注意：如果 npm 安装报错或超时，可先切换国内镜像：
然后再执行安装命令。

验证安装

claude --version

如果提示 claude: command not found（命令找不到），说明 npm 全局路径未加入 PATH。

修复方法：找到系统属性-高级系统设置-环境变量

5. 第四步：获取 DeepSeek API Key

访问 DeepSeek 开放平台：https://platform.deepseek.com/
注册 / 登录账号，进入「API Keys」页面
创建后API Key复制保存一份（仅显示一次），后面需要用到。

6 第五步：安装cc-switch

下载地址：https://github.com/farion1231/cc-switch/releases
windows，运行 .msi直至Finish。
macos

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

打开cc-switch

"env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的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[1M]",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "API_TIMEOUT_MS": "600000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }

7. 第六步：开始使用

基本用法

# 进入你的项目目录
cd your-project

# 启动 Claude Code
claude

# 在交互界面中直接对话即可
# 常用命令：
#   /model         查看当前模型
#   /help          查看帮助
#   /clear         清空对话上下文
#   Ctrl+C         退出

8 常见问题排查

❌ `claude: command not found`

原因：npm 全局 bin 路径未加入系统 PATH。

解决：

# Windows 永久修复 — PowerShell 管理员运行
[Environment]::SetEnvironmentVariable(
    "PATH",
    [Environment]::GetEnvironmentVariable("PATH", "User") + ";$env:APPDATA\npm",
    "User"
)
# 重启终端

❌ `401 Unauthorized`

原因：认证字段使用错误或 API Key 无效。

解决方法（按顺序尝试）：

确认使用的是 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY
确认 API Key 前缀是否完整（以 sk- 开头）
检查 DeepSeek 平台余额是否充足（余额需 ≥ ¥1）

❌ `Login required` / 弹出浏览器要求登录

原因：Claude Code 未跳过首次 Onboarding。

解决：编辑 ~/.claude.json（C:\Users\你的用户名\.claude.json），确保包含：

{
  "hasCompletedOnboarding": true
}

如果文件不存在，创建该文件并写入以上内容。

❌ `npm install` 超时或速度极慢

原因：默认 npm 源在国内访问慢。

解决：切换至淘宝镜像：

npm config set registry https://registry.npmmirror.com

❌ Windows 提示 "需要 WSL"

原因：Claude Code 依赖部分 Unix 工具。

解决：

确保已安装 Git for Windows
Git 安装时勾选 "Git from the command line and also from 3rd-party software"
重启终端

❌ DeepSeek 返回空响应或极慢

可能原因：

模型名写错（旧模型 deepseek-chat 已弃用，必须用 deepseek-v4-pro）
未加 [1m] 后缀导致上下文受限
高峰期服务器过载

解决：在 ANTHROPIC_MODEL 中明确使用 deepseek-v4-pro[1m]，并适当增大超时时间。

9.注意事项与限制

功能	支持情况	说明
文本对话	完全支持	编码、问答、分析均正常
工具调用（读写文件、执行命令）	支持	基本可用，复杂多步推理偶尔不如原生 Claude
图片/截图分析	不支持	DeepSeek V4-Pro 是纯文本模型
Extended Thinking（扩展思考）	不支持	这是 Anthropic 专属功能
Prompt Caching（提示缓存）	不支持	可能导致成本略高
VS Code 插件	支持	使用 `settings.json` 配置即可
子代理（Subagent）	支持	建议设置 `CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash`

10.总结

核心要点：

DeepSeek V4-Pro 原生兼容 Anthropic API，无需代理，设置几个环境变量即可使用
成本低至 Claude Opus 的 1/17，支持 1M 上下文
关键配置：ANTHROPIC_BASE_URL 指向 DeepSeek、ANTHROPIC_AUTH_TOKEN 使用 DeepSeek Key、模型名设为 deepseek-v4-pro
不支持图片输入和 Extended Thinking，如有需要可切换回原生 Claude

Claude Code怎么接入国产模型deepseek-v4-pro