本文将带各位读者一步步完成`Claude Code`的安装，并通过“魔改”配置解锁第三方端点支持，让你摆脱官方的限制，实现更灵活的 AI 编程体验。

# 一、环境准备：安装 Node.js

`Claude Code` 依赖 `Node.js` 环境，首先需要确保你的系统已正确安装 `Node.js`。

## 1.下载

访问 Node.js 官网 (https://nodejs.org/en/download)，下载适合你操作系统的版本。

![1.png](https://developer.qcloudimg.com/http-save/yehe-9985785/35050817ab6a94c4fd04289ec82602b5.png)

## 2.验证安装

安装完成后，打开`PowerShell (Windows)` 或终端 `(macOS/Linux)`，输入以下命令检查版本，出现版本号即表示成功。

```powershell
node -v
npm -v
```

![2.png](https://developer.qcloudimg.com/http-save/yehe-9985785/0c5b4401b709a9496b23f4b8325a7cad.png)

# 二、安装Claude Code

截止本文发布的时候，最新版本2.1.19已经放弃了`npm`安装方式，所以通过`npm`安装的后续也不再自动更新。如果你以前是通过`npm`安装的，可以通过官方的命令升级成最新的原生版本。

```powershell
claude install
```

![2-1.png](https://developer.qcloudimg.com/http-save/yehe-9985785/9ea6e4b365b5ef923e9eec19e52c434f.png)

最新的原生版本的安装方式大家根据自己的系统选择对应的命令即可（记得开启科学上网）。

```powershell
# Mac用户
brew install claude-code

# Linux用户
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell用户
irm https://claude.ai/install.ps1 | iex
```

![2-2.png](https://developer.qcloudimg.com/http-save/yehe-9985785/d5d67a3c7b8a9c960e4ef7f1a9d7463f.png)

查看版本号 

```powershell
Claude --version
```

# 三、开启第三方端点配置

这是最关键的一步。默认情况下，最新版的`Claude Code` 仅支持官方模型。我们需要手动创建配置文件来通过“验证门槛”并开启第三方模型支持。此步骤包含两个部分的配置：

## 1.key类型配置

我们需要在 `.claude`文件夹中创建一个` config.json`文件。

- **文件路径**：

  - **Windows**: 

    ```powershell
    C:\Users\你的用户名\.claude\
    ```

  - **macOS/Linux**: 

    ```powershell
    ~/.claude/
    ```

- **文件内容**：

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

**快速创建命令 (PowerShell)：** 你也可以直接复制以下命令在 PowerShell 中运行，一键创建该文件：

```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"}'
```

![4.png](https://developer.qcloudimg.com/http-save/yehe-9985785/4f527cea6ee9e9e8ae7c763527a14f88.png)

**macOS/Linux 命令：**

```powershell
mkdir -p ~/.claude && echo '{"primaryApiKey": "any-string-is-ok-here"}' > ~/.claude/config.json
```

## 2.跳过官方引导流程

旧版本不需要此步骤，但新版必须配置，否则启动时会强制要求登录官方账号，无法使用第三方模型。我们需要在**用户主目录**下修改或创建 `.claude.json` 文件（注意文件名前面有个点），添加`hasCompletedOnboarding`字段。

- **配置内容**：

```json
{
"hasCompletedOnboarding": true
}
```

**快速设置命令 (PowerShell)：** 使用 Node.js 脚本一键写入：

```powershell
node --eval "
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    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');
    }"
```

![5.png](https://developer.qcloudimg.com/http-save/yehe-9985785/1b5946a2a960869a8333ffc4302e05c1.png)

# 四、通过插件接入第三方模型

为了更方便地管理和切换配置，推荐使用 `VS Code` 配合特定插件进行操作。

## 1.安装 Claude Code Yolo 插件

打开 VS Code，在扩展市场搜索并安装 `Claude code yolo`（请搜索全称）。这个魔改版插件允许在 UI 界面中直接配置第三方模型参数。

![6.png](https://developer.qcloudimg.com/http-save/yehe-9985785/3965fa0af1e1ae288b6ae7db26ebf7e7.png)

安装完成后，VS Code 右上角会出现一个 `Claude` 图标。点击它即可启动 `Claude Code` 终端。

![7.png](https://developer.qcloudimg.com/http-save/yehe-9985785/a7faae700b07617297a1c50a5371ef2c.png)

## 2. 配置第三方模型

启动后，在 Claude Code 输入框中输入 `/`，选择 **`API configuration`** (或类似 Config 选项)，进入配置界面。

![9.png](https://developer.qcloudimg.com/http-save/yehe-9985785/6008bbeb285720559acbe62ed7484dce.png)

以 **DeepSeek** 为例：

1. 前往DeepSeek开放平台(https://platform.deepseek.com/api_keys)申请 API key。

![10.png](https://developer.qcloudimg.com/http-save/yehe-9985785/7593228b6a96c94c8f2dc44f4e64b658.png)

2.在配置界面填入参数：

- **BASE_URL**:API地址后面加上anthropic
- **Token**: 刚才申请的 API Key
- **Mode/Model**: deepseek-chat

![11.png](https://developer.qcloudimg.com/http-save/yehe-9985785/eb8159629876d3e3ce3c0230a3222ef0.png)

3.将任务模式 可以切换为 `Ask before edits` (编辑前询问)，以确保代码修改受控。

![12.png](https://developer.qcloudimg.com/http-save/yehe-9985785/7440f1444a29f95e4788e4e19e148f92.png)

4.输入任意对话，检查 AI 是否响应。

![13.png](https://developer.qcloudimg.com/http-save/yehe-9985785/804ed35dfaa48a610517e6b2258270bd.png)

你也可以在 PowerShell 中直接输入 `claude code`启动命令行版进行使用。

![14.png](https://developer.qcloudimg.com/http-save/yehe-9985785/69518803ec911bde1aea982564447e9a.png)

# 五、调用中转 API 

不仅是直连 DeepSeek，你也可以配置各种中转 API。这里以 **Poe** 为例：

1. **参考文档**：Poe 官方提供了对接 Claude Code 的教程 (https://creator.poe.com/docs/external-applications/claude-code)。 *(注：大家可以选择自己习惯的中转服务商，原理均通用)*

![15.png](https://developer.qcloudimg.com/http-save/yehe-9985785/9ca7b0a5153a6efceba42ba812b91a13.png)

2. **修改端点**： 重复上述配置步骤，将 API Endpoint (端点地址) 修改为 Poe 或中转商提供的地址，并填入对应的 Key。

![16.png](https://developer.qcloudimg.com/http-save/yehe-9985785/da4a73f7caca043c02f9347027b70d32.png)

3. **测试连接**： 保存后打个招呼，确认连接成功。

![17.png](https://developer.qcloudimg.com/http-save/yehe-9985785/b8610894e5b4eca2cf2fba652e3252b8.png)

除了上述配置方法，社区还有开源项目 **cc-switch** (https://github.com/farion1231/cc-switch)，可以更方便地管理和切换 `Claude Code` 的多种配置，也推荐大家尝试。

本文将带各位读者一步步完成Claude Code的安装，并通过“魔改”配置解锁第三方端点支持，让你摆脱官方的限制，实现更灵活的 AI 编程体验。

Claude Code 2026 最新保姆级安装指南

先锋会员

数据库

本文详细讲解ClaudeCode安装与配置教程，从Node.js环境准备到第三方端点解锁，包含Windows/macOS/Linux多平台安装命令、配置文件修改技巧，以及通过VSCode插件接入DeepSeek等第三方模型的完整流程，助你突破官方限制实现灵活AI编程。

Windows

Linux

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 2026 最新保姆级安装指南-腾讯云开发者社区-腾讯云

Claude Code 2026 最新保姆级安装指南

Claude Code 2026 最新保姆级安装指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐