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-ExecutionPolicyRemoteSigned-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

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

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 将自动：

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

6.2 项目级编程测试

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

或：

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

七、模型选择建议

模型	环境变量值	适用场景	备注
DeepSeek-V3	`deepseek-chat`	通用编程、代码补全、重构、文档	速度快，成本低，推荐日常使用
DeepSeek-R1	`deepseek-reasoner`	复杂算法、数学推导、深度逻辑推理	思考链更长，适合高难度任务

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

八、常见问题排查

问题现象	原因	解决方案
`claude`命令不存在	未安装或 PATH 缺失	重新执行`npm install -g @anthropic-ai/claude-code`，并检查`%USERPROFILE%\.local\bin`是否在 PATH
启动时弹出官方登录窗口	未禁用非必要流量 / 未跳过 onboarding	确认`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`和`.claude.json`中`hasCompletedOnboarding: true`
提示`401 Unauthorized`	API Key 错误或余额不足	检查 Key 是否以`sk-`开头，前往 DeepSeek 控制台查看余额
提示`404 Not Found`	模型名称错误	确认使用`deepseek-chat`或`deepseek-reasoner`，不要写`deepseek-coder`
响应慢或超时	DeepSeek API 高峰期拥堵	属于正常现象，可稍后重试；或切换至`deepseek-chat`（比 R1 更快）
`SyntaxError: Unexpected token`	Node.js 版本过低	升级至 Node.js 18+
3060Ti 风扇狂转	与 Claude Code 无关	本方案不调用本地 GPU，检查是否有其他程序（如游戏、训练任务）占用显卡

九、进阶工具（可选）

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

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

npm install-g @47code/cc-switchccswitch

图形界面中选择 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 及以上无法运行。

十、安全与使用建议

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

十一、一键汇总脚本

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

# ========== Claude Code + DeepSeek API 一键部署脚本 ==========Set-ExecutionPolicyRemoteSigned-Scope CurrentUser-Force-ErrorAction SilentlyContinue# 安装 Node.js + Gitwinget 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 Codenpm 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 UTF8Write-Host"`n====================================="-ForegroundColor CyanWrite-Host"✅ Claude Code + DeepSeek 部署完成！"-ForegroundColor GreenWrite-Host"📌 请编辑配置文件替换 API Key："-ForegroundColor YellowWrite-Host"$env:USERPROFILE\.claude\settings.json"-ForegroundColor YellowWrite-Host"📌 测试命令：claude --version"-ForegroundColor YellowWrite-Host"📌 启动命令：cd 项目目录 && claude"-ForegroundColor YellowWrite-Host"=====================================`n"-ForegroundColor Cyan# ========== 脚本结束 ==========

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

企业官网建设流程全解析