前言
在本地开发环境中接入 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。 - 安装官方插件（选择安装量最高的版本）。
