Claude Code + DeepSeek API 本地自动化编程部署指南

Claude Code + DeepSeek API 本地自动化编程部署指南

适用环境：Windows 10/11 + PowerShell
硬件配置：RTX 3060Ti 12GB（本方案零本地推理负载，GPU 仅用于日常开发）
核心目标：在本地终端实现 AI 自动化编程，调用 DeepSeek 云端模型替代官方 Claude 订阅

一、方案概述

Claude Code 是 Anthropic 推出的终端 AI 编程助手，原生需登录官方账号并调用 Claude 模型。通过环境变量劫持 + API 转发技术，可将其后端无缝替换为 DeepSeek API，实现：

• ✅ 零月费使用 DeepSeek 低价 API（约 Claude 的 1/10 成本）
• ✅ 不依赖本地 GPU 显存，3060Ti 12GB 完全胜任
• ✅ 强制免登录启动，跳过 Anthropic 官方鉴权
• ✅ 支持代码生成、重构、调试、测试等全链路自动化编程

二、准备工作

2.1 安装 Node.js（Claude Code 运行环境）

在 PowerShell 中检查版本：

node -v

要求 v18.x 或更高。若未安装，执行：

winget install OpenJS.NodeJS.LTS -e --accept-source-agreements --accept-package-agreements

安装后重新打开 PowerShell 使环境变量生效。

2.2 调整执行策略（如遇到权限报错）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

三、安装 Claude Code

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

如果命令找不到，手动添加路径：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.local\bin", "User")

验证安装：

claude --version

四、配置 DeepSeek API（核心步骤）

4.1 获取 DeepSeek API Key

1. 访问 https://platform.deepseek.com/api_keys
2. 注册/登录 → 左侧「API 密钥」→「创建密钥」
3. 复制密钥（格式如 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）
4. ⚠️ 密钥仅显示一次，务必保存

4.2 方案 A：PowerShell 配置文件方式（推荐，自动生效）

让配置在每次打开 PowerShell 时自动加载：

# 1. 确保配置文件存在
if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }

# 2. 编辑配置文件
notepad $PROFILE

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

# ==========================================
# Claude Code + DeepSeek API 配置
# ==========================================

# 核心：将 Anthropic 官方 API 地址重定向到 DeepSeek
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

# 你的 DeepSeek API 密钥
$env:ANTHROPIC_AUTH_TOKEN="sk-你的实际API_KEY填在这里"

# 模型映射（DeepSeek 目前提供 deepseek-chat 和 deepseek-reasoner）
$env:ANTHROPIC_MODEL="deepseek-chat"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-chat"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-chat"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat"

# 禁用非必要流量，避免触发官方登录检测
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

保存关闭后，执行：

. $PROFILE

4.3 方案 B：系统环境变量方式（永久生效，跨应用）

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.deepseek.com/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'sk-你的实际API_KEY', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'deepseek-chat', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_OPUS_MODEL', 'deepseek-chat', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_SONNET_MODEL', 'deepseek-chat', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_DEFAULT_HAIKU_MODEL', 'deepseek-chat', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

⚠️ 设置后需重新打开 PowerShell 窗口才能读取新环境变量。

4.4 方案 C：配置文件方式（settings.json）

# 创建配置目录
mkdir "$env:USERPROFILE\.claude" -Force | Out-Null

# 写入 settings.json
@"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的实际API_KEY",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
"@ | Out-File "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8

五、强制免登录启动（关键解决方案）

Claude Code 默认会强制要求 Anthropic 官方登录。使用第三方 API 时，必须通过以下方式彻底绕过登录流程：

5.1 创建跳过登录标记文件

@"
{
  "hasCompletedOnboarding": true
}
"@ | Out-File "$env:USERPROFILE\.claude.json" -Encoding UTF8

5.2 禁用非必要流量检测（防弹窗核心）

在上述 settings.json 或环境变量中，务必包含：

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

这行配置会阻止 Claude Code 向 Anthropic 发送地区检测、登录状态校验等非必要请求，从而避免弹出官方登录窗口。

5.3 启动验证

重新打开 PowerShell，进入项目目录：

cd D:\你的项目文件夹
claude

正常应直接进入 claude> 交互提示符，无任何浏览器弹窗或登录提示。

输入以下命令查看当前模型状态：

/status

预期看到：

• Model: deepseek-chat
• API: https://api.deepseek.com/anthropic

六、功能测试

6.1 Hello World 测试

在 claude> 提示符下输入：

请创建一个 hello_world.py 文件，打印 "Hello, World from Claude Code + DeepSeek!"，然后运行它。

Claude Code 将自动：

1. 创建 hello_world.py
2. 写入代码
3. 执行 python hello_world.py
4. 展示运行结果

6.2 项目级编程测试

请帮我分析当前项目结构，并列出最重要的三个文件。

或：

写一个 Python 函数，计算斐波那契数列的前 n 项，并加上类型注解和单元测试。

七、模型选择建议

切换模型只需修改环境变量中的 ANTHROPIC_MODEL 值，重启 Claude Code 即可生效。

八、常见问题排查

九、进阶工具（可选）

9.1 CC Switch（多模型可视化切换）

如果你需要在 DeepSeek / 硅基流动 / 官方 Claude 之间快速切换：

npm install -g @47code/cc-switch
ccswitch

图形界面中选择 DeepSeek → 填入 API Key → 启用，自动改写所有配置。

9.2 本地离线方案（备用）

如需完全离线运行（不调用任何 API），可用 Ollama 本地部署 DeepSeek 7B/8B 模型：

# 安装 Ollama 后执行
ollama pull deepseek-r1:7b
ollama run deepseek-r1:7b

3060Ti 12GB 可流畅运行 7B/8B 量化版，14B 量化版可运行但余量紧张，32B 及以上无法运行。

十、安全与使用建议

1. Git 保护：Claude Code 有权执行终端命令（如 npm install、git commit、删除文件）。在让 AI 执行批量修改前，确保代码已 git commit，以便随时回滚。
2. API 密钥安全：不要将 sk- 密钥上传到公开仓库。建议使用 PowerShell $PROFILE 或本地环境变量管理，避免硬编码在项目中。
3. 费用监控：DeepSeek API 虽便宜但仍按 token 计费，可在 DeepSeek 控制台 查看实时消费。
4. 网络要求：必须能稳定访问 https://api.deepseek.com。如遇连接问题，可尝试切换网络或开启全局代理。

十一、一键汇总脚本

如需在新电脑上快速部署，以管理员身份打开 PowerShell，执行以下完整脚本：

# ========== Claude Code + DeepSeek API 一键部署脚本 ==========
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force -ErrorAction SilentlyContinue

# 安装 Node.js + Git
winget install OpenJS.NodeJS.LTS -e --accept-source-agreements --accept-package-agreements
winget install Git.Git -e --accept-source-agreements --accept-package-agreements

# 刷新环境变量
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 创建配置目录
mkdir "$env:USERPROFILE\.claude" -Force | Out-Null

# 写入 settings.json（⚠️ 请手动替换 API Key）
@"
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-此处替换成你的DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}
"@ | Out-File "$env:USERPROFILE\.claude\settings.json" -Encoding UTF8

# 跳过官方登录
@"
{
  "hasCompletedOnboarding": true
}
"@ | Out-File "$env:USERPROFILE\.claude.json" -Encoding UTF8

Write-Host "`n=====================================" -ForegroundColor Cyan
Write-Host "✅ Claude Code + DeepSeek 部署完成！" -ForegroundColor Green
Write-Host "📌 请编辑配置文件替换 API Key：" -ForegroundColor Yellow
Write-Host "   $env:USERPROFILE\.claude\settings.json" -ForegroundColor Yellow
Write-Host "📌 测试命令：claude --version" -ForegroundColor Yellow
Write-Host "📌 启动命令：cd 项目目录 && claude" -ForegroundColor Yellow
Write-Host "=====================================`n" -ForegroundColor Cyan
# ========== 脚本结束 ==========

文档版本：v1.0
最后更新：2026-05-24
适用平台：Windows 10/11 + PowerShell 5.1/7.x