前言
在本地开发环境中接入 AI 助手能显著提升编码效率。本教程将演示如何在 Windows 环境下,通过 VSCode 配合 DeepSeek API 和 Claude 命令行工具,搭建一套低成本的 AI 编程工作流。
前期准备
- 操作系统:Windows(本方案适配 Windows 环境)
- 基础软件:VSCode 编辑器、Node.js(建议版本 v24.14.0 或更高)
- 账号资源:DeepSeek 平台手机号注册账号
- 网络环境:稳定的网络连接,避免安装过程中断
步骤一:全局安装 Claude 命令行工具
首先确认 Node.js 是否已正确安装。打开 PowerShell,输入以下命令检查版本:
node -v
若显示版本号则说明环境就绪。接下来执行全局安装命令,注意包名拼写准确:
npm install -g @anthropic-ai/claude-code
安装成功后终端会提示 added 2 packages。同时建议安装 Git 以支持部分依赖项:
git --version
注意:如果报错找不到包,请仔细核对包名是否为
@anthropic-ai/claude-code,而非简写形式。
步骤二:解决连接问题与配置
直接运行 claude 命令时,可能会遇到无法连接官方服务的提示,这是由于国内网络限制导致的。我们可以通过修改配置文件来绕过此限制。
在文件管理器中搜索用户目录下的 .claude 文件夹(通常位于 C:\Users\你的用户名\.claude),找到 config.json 文件并用编辑器打开。添加或确认以下字段:
{
"hasCompletedOnboarding": true
}
确保 JSON 格式合法,逗号位置正确。这一步是为了跳过初始引导流程,直接进入可用状态。
步骤三:获取 DeepSeek API 密钥
为了降低成本并解决访问问题,我们将使用 DeepSeek 的算力作为后端服务。
- 访问 DeepSeek 官方控制台。
- 使用手机号注册并完成实名认证。
- 进入 API Keys 管理页面,点击新建密钥。
- 重要:复制生成的密钥(sk-开头),该密钥仅显示一次,丢失需重新创建。
- 充值账户,最低额度即可满足日常开发需求。
步骤四:配置请求转发工具
由于需要绕过网络限制,我们需要一个转发工具将请求指向 DeepSeek 接口。
- 下载并解压 CC-Switch 工具(Windows 便携版)。
- 运行 exe 文件,根据向导完成基础配置。
- 绑定对应的 API 接口地址,确保流量能正确路由。
步骤五:VSCode 插件安装与对接
最后一步是在 IDE 中完成集成。
- 打开 VSCode 扩展市场,搜索
Claude Code。 - 安装官方插件(选择安装量最高的版本)。
- 重启 VSCode 使插件生效。
- 进入设置页面,填入之前获取的 API 密钥、接口地址及模型名称(推荐
deepseek-chat)。 - 保存配置并再次重启 VSCode。
测试与使用
配置完成后,打开 VSCode 右侧的 Claude 面板,尝试输入指令:
'写一段简约科技风 HTML 网页代码'
系统应能快速生成相应内容。该工作流适用于编写代码、优化脚本、制作 UI 原型等场景。
注意事项
- 成本控制:主要费用来自 DeepSeek 按 Token 计费,VSCode 插件及命令行工具本身免费。
- 安全保密:API 密钥请勿泄露,避免余额被盗用。
- 网络要求:普通校园网或家用宽带即可,无需特殊代理环境。
- 模型选择:推荐使用
deepseek-chat模型,在代码生成与 UI 设计上性价比最高。

