Claude Code 安装与配置完整指南（Windows)

目录

[第一章 准备工作](#第一章 准备工作)

[1.1 必备工具](#1.1 必备工具)

[第二章 具体步骤](#第二章 具体步骤)

[2.1 git 安装](#2.1 git 安装)

[2.2 node 安装](#2.2 node 安装)

[2.3 Claude Code 安装](#2.3 Claude Code 安装)

[2.4 完成初始化](#2.4 完成初始化)

[2.5 配置 API 密钥](#2.5 配置 API 密钥)

[2.6 测试配置是否成功](#2.6 测试配置是否成功)

[2.7 编辑器添加claude code](#2.7 编辑器添加claude code)

[2.8 一些常用命令](#2.8 一些常用命令)

---

第一章 准备工作

1.1 必备工具

Claude Code 的安装需要依赖两个核心工具，需提前下载安装：

• Git for Windows：提供 Claude Code 所需的 Git Bash 运行环境，同时包含多种 Unix 命令，是 Windows 系统运行 Claude Code 的关键依赖；
• Node.js：用于安装 Claude Code 本体，建议选择 LTS 版本（长期支持版），自带 npm 包管理工具，无需额外安装

第二章 具体步骤

2.1 git 安装

Git基本使用（很详细）

2.2 node 安装

• 用nvm管理node，可切换node版本：

nvm安装并配置环境变量使用nvm安装、切换nodejs

• 只安装某个node版本

node详细安装教程

检查安装成功：

2.3 Claude Code 安装

• 在终端(CMD 或 PowerShell)中输入该命令，安装 Claude Code:

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

• 检查安装成功

claude -v

2.4 完成初始化

• 输入命令：

cluade

• 可能会遇到这个问题：

• 注意：如果出现类似上图的连接错误提示,需要手动完成初始化配置，使用下面这个命令，核心作用是 修改 Claude Code 的配置文件（.claude.json），强制添加 / 更新 "hasCompletedOnboarding" 配置项并设为 true，用于跳过 Claude Code 首次启动时的引导流程（如主题选择、配置确认等）：

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

• 重新再执行claude命令，选择yes即可：

• 到这里基本上就初始化完成了，但是还不能对话，会提示请先登录，需要做下面的配置之后才可以！！！

2.5 配置 API 密钥

找到文件夹：

或者用命令：

window + R -> 输入：%userprofile%\.claude

• 创建配置文件

  初始目录中没有settings.json文件,需要手动创建，然后把下面给的这段复制进去：

{
  "autoUpdatesChannel": "latest",
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的令牌",
    "ANTHROPIC_BASE_URL": "你的地址",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_MODEL": "glm-5"
  },
  "includeCoAuthoredBy": false
}

• 也可以配置一些相应的权限进去：

"permissions": {
    "mode": "plan",
    "initialPermissionMode": "acceptEdits",
    "allow": [
      "Read",
      "Write",
      "Edit",
      "Bash",
      "Git",
      "Npm",
      "Pip"
    ],
    "deny": [
      "Delete",
      "GitPush",
      "NetworkRequest"
    ]
  }

• 获取api令牌：令牌创建页面

2.6 测试配置是否成功

• 启动 Claude Code，如果能正常收到回复,说明配置成功！！

2.7 编辑器添加claude code

• 以vs code为例，添加扩展Claude Code for VS Code：

• 会展示下面这个页面，分别是个人、企业：

• 效果：

2.8 一些常用命令

claude . // AI 自动读取整个项目结构
claude edit src/App.vue // 让 AI 帮你改某个文件 
claude explain src/utils/request.js // 解释代码
claude review src/views/Login.vue // 检查文件/bug
claude refactor src/api/user.js // 重构代码
claude "给这个文件加上清晰注释" src/utils/tools.js // 给项目加注释
......