Claude-Code-DeepSeek部署指南

关注

原创最新推荐文章于 2026-10-21 12:32:33 发布 394 阅读 AI 写同款· GEO 优化 ›

Claude Code 安装、使用及 GLM/DeepSeek 配置本报告基于 2026 年 3 月的最新信息，详细阐述 Claude Code（Anthropic 的终端 AI 编程助手）在 Windows 系统上的安装和使用步骤，以及如何配置国内模型 GLM（智谱 AI）和 DeepSeek（深度求索）以替换官方 Anthropic API。Claude Code 支持无缝接入兼容 API 的模型，提供高效的编程辅助。配置 GLM 和 DeepSeek 可以显著降低成本、提升国内网络稳定性，并保持高编程能力。阅读详情

Claude Code + DeepSeek 本地部署指南

最后更新：2026-06-08

前置准备

1. 安装 Node.js 18+

前往 nodejs.org 下载 LTS 版本，安装完成后验证：

node --version
npm --version

2. 获取 DeepSeek API Key

前往 platform.deepseek.com 注册账号
创建 API Key（格式：sk-xxxxxxxx）
确保账户有余额（充值入口在平台「账单」页面）

⚠️ API Key 请妥善保管，不要提交到 Git 仓库

Windows 部署

安装 Claude Code

由于 Windows PowerShell 脚本执行策略限制，必须用 npm.cmd：

npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证安装：

claude --version

如果提示 `claude 不是内部或外部命令`

查找 npm 全局路径：

npm.cmd root -g
# 通常输出：C:\Users\你的用户名\AppData\Roaming\npm\node_modules
# 或自定义路径，如：D:\apps\nodejs

将该路径加入系统 PATH：

# 将路径换成你自己的 npm 全局目录
$npmPath = "D:\apps\nodejs"
$currentPath = [System.Environment]::GetEnvironmentVariable("PATH", "User")
if ($currentPath -notlike "*$npmPath*") {
    [System.Environment]::SetEnvironmentVariable("PATH", "$currentPath;$npmPath", "User")
    Write-Host "PATH 已更新，请关闭并重新打开 PowerShell"
}

完全关闭并重新打开 PowerShell 后再试。

配置环境变量（永久生效）

# 创建 PowerShell Profile 文件
New-Item -Path $PROFILE -ItemType File -Force
notepad $PROFILE

在记事本中粘贴以下内容（替换为你的真实 API Key）：

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

保存后执行：

. $PROFILE

Linux 部署

安装 Node.js

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -y nodejs

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

安装 Claude Code

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

配置环境变量（永久生效）

cat >> ~/.bashrc << 'EOF'

# Claude Code + DeepSeek 配置
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek密钥"
export ANTHROPIC_API_KEY="sk-你的DeepSeek密钥"
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"
EOF

source ~/.bashrc

跳过登录配置

Claude Code 默认需要 Anthropic 账号登录，通过创建本地配置文件可绕过此限制。

Windows

# 创建 .claude 目录
New-Item -Path "$env:USERPROFILE\.claude" -ItemType Directory -Force

# 创建 config.json（跳过登录校验）
$config = '{"primaryApiKey": "anything is ok"}'
Set-Content -Path "$env:USERPROFILE\.claude\config.json" -Value $config

# 创建 settings.json（写入 DeepSeek 配置）
$settings = @'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
    "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"
  }
}
'@
Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Value $settings

Linux

mkdir -p ~/.claude

# 跳过登录
echo '{"primaryApiKey": "anything is ok"}' > ~/.claude/config.json

# 配置 DeepSeek
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
    "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"
  }
}
EOF

配置文件目录结构

~/.claude/
├── config.json      ← 跳过登录
└── settings.json    ← DeepSeek API 配置

验证配置

进入项目目录并启动：

cd 你的项目目录
claude

在交互界面输入：

/status

看到以下输出即表示配置成功：

Base URL: https://api.deepseek.com/anthropic
Model: deepseek-v4-pro[1m]
Small fast model: deepseek-v4-flash

Claude Code 使用方法

快捷键

按键	作用
`Enter`	发送消息
`Shift+Enter`	换行（不发送）
`Ctrl+C`	中断当前操作
`Ctrl+D`	退出
`↑` / `↓`	翻历史消息

内置斜杠命令

命令	作用
`/status`	查看当前模型和配置
`/help`	查看所有命令
`/clear`	清空对话上下文
`/model`	切换模型
`/cost`	查看本次会话花费

常用对话示例

# 读懂项目
帮我梳理一下这个项目的整体结构

# 写代码
帮我写一个用户登录的接口，使用 JWT 认证

# 修 Bug（粘贴报错信息）
运行报错了：[报错信息]，帮我修复

# 代码审查
帮我检查 src/api 目录下有没有安全漏洞

# 写测试
给 UserService 写单元测试

使用技巧

先让它读项目，再下达任务，效果更好
任务拆细比宽泛指令效果更好
直接粘贴报错信息，比文字描述更精准
每次修改文件或执行命令，它都会先告知并等待确认

常见报错排查

报错信息	原因	解决方法
`claude 不是内部命令`	PATH 未配置	将 npm 全局目录加入系统 PATH，重开终端
`npm.ps1 被禁止运行`	PowerShell 执行策略限制	改用 `npm.cmd`，或执行 `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
强制要求登录	缺少 `~/.claude/config.json`	创建 config.json，内容填 `{"primaryApiKey": "anything is ok"}`
`401 Unauthorized`	API Key 错误	检查 Key 是否正确，有无多余空格
`402 Insufficient Balance`	DeepSeek 余额不足	前往 platform.deepseek.com 充值
`Model not found`	模型名称错误	确认填写 `deepseek-v4-pro[1m]` 或 `deepseek-v4-flash`
`Unable to connect to Anthropic`	未配置环境变量直接启动	先设置环境变量再启动 claude

模型选择建议

场景	推荐模型	特点
复杂架构设计、深度重构	`deepseek-v4-pro[1m]`	最强推理，1M 上下文窗口
日常功能开发、代码补全	`deepseek-v4-pro`	综合性能好
快速问答、简单修改、子任务	`deepseek-v4-flash`	响应快、成本低