Claude Code安装记录

一、安装node.js

1、什么是node.js？

以前js脚本需要在浏览器中运行，脱离浏览器无法运行。node.js出现正是为了解决js脚本与浏览器的强依赖关系，提供运行js脚本的运行时环境。

2、node.js安装方式

当前安装node.js有两种方式，如下所示：

|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------|-----------------------------------------------------------|
| 方式 | 方式内容 | 优势 | 劣势 |
| 方式一 | 官网直接下载node.js（https://nodejs.cn/download/） | 不需要安装其他，直接安装node.js即可 | 一台机器上只能装一个版本的node.js，比如node 18, node 19, node 20, node 21 |
| 方式二、 （推荐） | 下载nvm(https://nvm.uihtm.com/doc/install.html)，然后通过nvm下载node.js | 通过nvm可以下载多个版本的node.js，并来回切换 | 安装node.js之前需要先安装nvm |

会有node.js, nvm, npm等名词，可能会混淆，区别如下：

|---------------------------|-------------------------------------------------------------------------|
| 名词 | 解释 |
| node.js | 基于 Chrome V8 引擎的 JavaScript 运行时，让 JS 可以脱离浏览器在服务器 / 终端运行。 |
| nvm（Node Version Manager） | 同时安装多个 Node 版本，一键切换；解决版本兼容、权限问题（避免 sudo/npm 全局权限混乱）。 |
| npm（Node Package Manager） | Node.js默认自带的包管理器，用于下载、安装、管理项目依赖包（如 express、react 等），并提供脚本执行、发布包等功能。 |

3、nvm常用命令：

javascript 复制代码

nvm list available # 列出当前nvm可以安装的node.js版本

nvm install 20.17.0 # 安装指定版本
nvm use 20.17.0     # 切换版本
nvm ls              # 列出已安装版本

二、安装git bash

如果没安装git bash，需要安装git，然后找到bin/bash.exe以CLAUDE_CODE_GIT_BASH_PATH=E:\软件\Git\bin\bash.exe的内容加入到环境变量中。

1、为什么Claude Code需要git bash？

根本原因：Claude Code 在 Windows 上运行有一个特殊要求，Claude Code 必须依赖 Git Bash 才能正常工作，因为它需要一个类 Unix 的环境来执行某些指令。

兼容性： 很多像 Claude Code 这样的开发者工具是基于 Node.js 开发的，它们内部的代码逻辑经常会调用一些 Linux 脚本 （.sh 文件）。
Bash 的作用： Git Bash 包含了一个微小的 Linux 环境（通过 MSYS2 实现），里面不仅有 Git，还有 bash.exe。Claude Code 需要这个 bash.exe 来翻译并执行它那些类 Linux 的内部指令。

三、安装Claude Code

安装命令：

复制代码

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

验证安装情况

javascript 复制代码

claude -v

运行claude

javascript 复制代码

claude

可能出现的问题：

（1）无法连接内容

解决方案：

在~目录找到.claude.json，修改如下,在最后添加 "hasCompletedOnboarding": true

复制代码

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "firstStartTime": "2025-07-14T06:11:03.877Z",
  "userID": "f5afdd05117c901a4a5a0761d08230bfcbb76f9fd380ff7bc144cc12c52e55aa",
  "projects": {
    "/home/nassi": {
      "allowedTools": [],
      "history": [],
      "mcpContextUris": [],
      "mcpServers": {},
      "enabledMcpjsonServers": [],
      "disabledMcpjsonServers": [],
      "hasTrustDialogAccepted": false,
      "projectOnboardingSeenCount": 0,
      "hasClaudeMdExternalIncludesApproved": false,
      "hasClaudeMdExternalIncludesWarningShown": false
    }
  },  //这里要加逗号，注意英文的
  "hasCompletedOnboarding": true  // 新增字段放在这里，注意位置
}