您的位置: 首页> AI模型

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

匿名上传

发布时间:2026-02-03 13:15:01

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

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

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

1.下载

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

2.验证安装

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

node -v
npm -v

二、安装Claude Code

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

claude install

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

# Mac用户
brew install claude-code

# Linux用户
curl -fsSL  | bash

# Windows PowerShell用户
irm  | iex

查看版本号

Claude --version

三、开启第三方端点配置

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

1.key类型配置

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

文件路径：

Windows:
```
C:Users你的用户名.claude
```
macOS/Linux:
```
~/.claude/
```

文件内容：

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

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

$path = "$HOME.claude"; if (!(Test-Path $path)) { New-Item -ItemType Directory -Path $path -Force }; Set-Content -Path "$pathconfig.json" -Value '{"primaryApiKey": "any-string-is-ok-here"}'

macOS/Linux 命令：

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

2.跳过官方引导流程

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

配置内容：

{
"hasCompletedOnboarding": true
}

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

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');
    }"