Claude Code安装教程：DeepSeek V3/R1无缝接入 + VS Code YOLO插件配置指南 (2026最新)

2026/1/27 Claude Code安装DeepSeek API配置VS Code插件推荐Claude Code YOLOAI编程助手DeepSeek R1Node.js环境配置

摘要/导读： 本文详细介绍了2026最新版 Claude Code 的安装步骤。通过使用 Claude Code YOLO VS Code 插件，你可以绕过官方限制，轻松切换至 DeepSeek V3/R1 等高性价比第三方模型。教程涵盖 Node.js 环境配置、Config 文件修改及 API Key 对接全流程。

# 1. 环境准备：安装 Node.js

Claude Code 依赖于 Node.js 环境，因此第一步是确保你的系统已正确安装 Node.js。

# 1.1 下载与安装

前往 Node.js 官方网站下载对应你操作系统的版本（推荐下载 LTS 长期支持版）： node.js 官网

# 1.2 验证安装

安装完成后，我们需要验证环境是否生效。

  1. 打开命令提示符 (CMD) 或终端 (Terminal)。
  2. 输入以下命令查看版本号：
node -v
npm -v

如果出现版本号（如下图所示），说明 Node.js 和 npm 已成功安装。 cmd

# 2. 核心步骤：安装与配置 Claude Code

# 2.1 全局安装 Claude Code

在 PowerShell (Windows) 或 Terminal (macOS/Linux) 中输入以下 npm 命令进行全局安装： 安装

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

# 2.2 配置认证文件 (绕过官方登录)

为了让 Claude Code 正常运行并支持自定义模型，我们需要手动创建配置文件。

文件路径说明：

  • Windows: C:\Users\你的用户名\.claude\config.json
  • macOS / Linux: ~/.claude/config.json

请在对应的文件夹中新建 config.json，并填入以下内容（目的是跳过官方 Key 校验）： config.json

{
  "primaryApiKey": "any-string-is-ok-here"
}

⚡️ 极速安装脚本 (推荐):

如果你不想手动创建文件，可以直接复制以下命令在终端运行：

  • Windows (PowerShell):
$path = "$HOME\.claude"; if (!(Test-Path $path)) { New-Item -ItemType Directory -Path $path -Force }; Set-Content -Path "$path\config.json" -Value '{"primaryApiKey": "any-string-is-ok-here"}'
  • macOS / Linux:
mkdir -p ~/.claude && echo '{"primaryApiKey": "any-string-is-ok-here"}' > ~/.claude/config.json

# 2.3 跳过新手引导 (Onboarding)

为了防止每次启动都弹出欢迎界面，我们需要修改或创建 .claude.json 文件。

  • Windows: 位于当前用户主目录。
  • macOS/Linux: 位于 ~/.claude/ 目录下。

.claude.json

在 .claude.json 中添加如下配置：

{
  "hasCompletedOnboarding": true
}

⚡️ Windows 一键配置脚本:

node --eval "
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    const fs = require('fs'); // 补充缺失的require
    const path = require('path');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }), 'utf-8');
    }"

# 3. 进阶玩法：为 Claude 配置第三方模型 (DeepSeek)

为了降低成本并使用国产高性能模型，我们将使用 VS Code 插件来接管 Claude Code 的模型调用。

# 3.1 安装 Claude Code YOLO 插件

claude code YOLO

  1. 下载并安装 Visual Studio Code (VS Code): https://code.visualstudio.com/ (opens new window)
  2. 打开 VS Code，点击左侧“扩展”图标（Extensions）。
  3. 搜索关键词 Claude Code YOLO。
  4. 点击安装。这是一个魔改版插件，允许用户自定义 API Endpoint 和模型。

# 3.2 启动与模式设置

102.jpeg

安装完成后，VS Code 右上角会出现 Claude 图标。

  1. 点击图标启动 Claude Code。
  2. 重要： 将任务模式 (Task Mode) 切换为 Ask before edits (编辑前询问)，这样能防止 AI 随意修改你的代码，增加安全性。 模式切换

# 3.3 配置 DeepSeek API

这是最关键的一步，我们将把默认模型替换为 DeepSeek（或者 OpenAI、Groq 等）。

  1. 在 Claude Code 输入框输入 /，选择 API configuration (API 配置)。 API 配置
  2. 打开 DeepSeek 开放平台 (opens new window) 注册并申请 API Key。 申请 API key
  3. 填写配置参数：
  • API Provider: 选择 Compatible / Custom (兼容模式)
  • Base URL: https://api.deepseek.com (根据 DeepSeek 官方文档填写)
  • API Key (Token): 填入你刚才申请的 sk-xxxx 开头的密钥。
  • Model ID: 输入 deepseek-chat 或 deepseek-coder。 参数填写API 配置

# 3.4 最终测试

配置完成后，在输入框中输入任意指令（例如：“用 Python 写一个 Hello World”），或者在 PowerShell 中运行命令行的 claude。如果 AI 能够正常回复，恭喜你！你已经成功实现了低成本运行 Claude Code 开发环境。

# 常见问题 (FAQ)

Q: 为什么要使用 Claude Code YOLO 插件？ A: 官方 Claude Code 绑定了 Anthropic 的昂贵计费，而 YOLO 魔改版插件允许开发者接入 DeepSeek 等第三方高性价比模型，大幅降低 Token 消耗成本。

Q: 配置后提示 API Error 怎么办？ A: 请检查你的 Base URL 是否正确（不要带多余的空格），并确认 DeepSeek 账户余额充足。