Claude Code 安装教程——从零开始配置你的 AI 编程助手

2026-06-01 agent, ai, claude, install, tutorial, 入门, 教程

Claude Code 安装教程——从零开始配置你的 AI 编程助手

作者： CaoZH
版本： 2026-06-01
适用平台： macOS / Windows / Linux

Claude Code 是 Anthropic 推出的 AI 编程助手 CLI（命令行界面），它可以直接在你的终端中理解代码、修改文件、运行命令、管理 Git 仓库。本文将详细介绍在 macOS 和 Windows 上安装 Claude Code 的四种方式，以及如何通过 CC Switch 工具管理多套环境配置。

一、安装前准备

系统要求

平台	最低版本
macOS	macOS 12+ (Monterey)
Windows	Windows 10+ (Build 19041+)
Linux	任意现代发行版

通用前置依赖

无论哪种安装方式，Claude Code 都需要 **Node.js 18+**：

# macOS — 使用 Homebrew
brew install node

# macOS — 使用 nvm（推荐，方便版本管理）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
nvm install 22

# Windows — 使用 winget
winget install OpenJS.NodeJS.LTS

# Windows — 或下载安装包
# 访问 https://nodejs.org/ 下载 LTS 版本

验证安装：

1 2	node --version # 应输出 v18.x.x 或更高 npm --version

二、方法一：CLI 命令行安装

这是最核心的安装方式。CLI 安装后，其他 IDE 插件都以此为基础运行。

2.1 npm 全局安装（所有平台通用）

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

安装完成后验证：

1	claude --version

2.2 macOS 专用安装方式

方式 A：npm（推荐）

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

方式 B：Homebrew

brew install anthropic/claude-code/claude

# 或通过新式 tap
brew tap anthropic/claude-code
brew install claude-code

方式 C：从官网下载原生安装包
访问 code.claude.com 下载 macOS 的 .dmg 或 .pkg 安装包。

2.3 Windows 专用安装方式

方式 A：npm（推荐）

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

⚠️ Windows 注意事项：

建议以 管理员身份 运行 PowerShell 或 CMD

如遇到执行策略限制，先运行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

npm 全局包安装后，确保 npm 全局 node_modules 目录在 PATH 中

方式 B：winget（Windows 包管理器）

1	winget install Anthropic.ClaudeCode

方式 C：原生安装包
从 code.claude.com 下载 Windows 安装程序（.exe / .msi），双击安装即可。

2.4 验证安装

1	claude --version

2.5 更新与卸载

# 更新 Claude Code
claude update
# 或
claude upgrade

# 查看健康状态
claude doctor

# 卸载（npm 安装方式）
npm uninstall -g @anthropic-ai/claude-code

三、方法二：VSCode 插件安装

3.1 安装步骤

打开 Visual Studio Code
点击左侧活动栏的扩展图标（Ctrl+Shift+X / Cmd+Shift+X）
搜索 “Claude Code”
找到官方 Anthropic 发布的扩展（图标为紫色火花 ✨ 或 Anthropic 标志，已发布者验证）
点击 Install

也可以直接访问 VSCode Marketplace：
https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code

3.2 使用方式

安装后，侧边栏会出现一个 火花图标（Spark），点击即可打开 Claude Code 面板：

Prompt Box（提示框）— 直接在 VSCode 内输入你的需求
Terminal Mode（终端模式）— 切换到完整终端 REPL
参考文件 — 可以 @ 引用当前打开的文件

3.3 VSCode 插件 vs CLI 的切换

你可以在 VSCode 中使用 --code 参数在不同模式间切换：

# 从 CLI 切换到 VSCode 扩展模式
claude --code

# 在 VSCode 终端中打开 Claude Code
# 直接用 VSCode 内置终端运行 claude 即可

3.4 设置项

VSCode 扩展支持在 settings.json 中配置：

{
  "claude-code.theme": "dark",
  "claude-code.language": "zh-CN",
  "claude-code.autoOpenTerminal": true
}

3.5 前置条件

VSCode 插件需要系统已安装 Claude Code CLI。如果未安装，插件会提示你先运行 npm install -g @anthropic-ai/claude-code。

四、方法三：JetBrains IDEA 插件安装

Claude Code 官方提供了 JetBrains 系列 IDE 的插件，支持 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等所有 JetBrains IDE。

4.1 安装步骤

方式 A：从 IDE 内安装

打开 IntelliJ IDEA（或其他 JetBrains IDE）
进入 File → Settings → Plugins（Windows/Linux）或 IntelliJ IDEA → Settings → Plugins（macOS）
切换到 Marketplace 标签
搜索 “Claude Code”
找到官方插件「Claude Code [Beta]」，点击 Install
重启 IDE

方式 B：从 JetBrains Marketplace 安装
访问 plugins.jetbrains.com/plugin/27310-claude-code-beta- 在线安装。

4.2 前置条件

⚠️ 重要：JetBrains 插件 仅是一个集成界面，它要求 Claude Code CLI 已单独安装。请先完成第二章的 CLI 安装。

4.3 配置 Claude 命令路径

安装插件后，进入 Settings → Tools → Claude Code 配置 CLI 路径：

macOS：默认自动识别 /usr/local/bin/claude 或 ~/.npm-global/bin/claude
Windows：默认自动识别 %APPDATA%\npm\claude 或 %USERPROFILE%\AppData\Roaming\npm\claude
WSL 用户：需设置为 wsl -d Ubuntu -- bash -lic "claude"（将 Ubuntu 替换为你的 WSL 发行版名称）

4.4 使用方式

快捷键：Ctrl+Shift+C（Windows/Linux）或 Cmd+Shift+C（macOS）打开 Claude Code 面板
在 JetBrains 内置终端中直接输入 claude 使用
ESC 键问题：如果 ESC 无法中断 Claude Code 操作，请在插件设置中检查终端兼容性

4.5 自动更新

插件默认启用自动更新，设置路径：Settings → Tools → Claude Code → Enable automatic updates

五、方法四：Desktop 桌面版

Claude Code 也提供了独立的桌面应用程序，适合不想使用终端或 IDE 的用户。

下载方式

访问 code.claude.com：

macOS：下载 .dmg 安装包
Windows：下载 .exe 安装程序

桌面版内置了完整的 Claude Code 功能，并提供图形化界面。不过对于编程任务，CLI 和 IDE 插件仍然是更主流的选择。

六、CC Switch：一键切换环境变量

CC Switch 是一个开源的跨平台环境管理工具，专门用于 管理 Claude Code、Codex、Gemini CLI 等多个 AI 编程工具的环境配置。当你需要使用不同的 API 提供商（如官方 API、中转 API、企业代理等）时，不需要手动修改配置文件，一键即可切换。

CC Switch 有两个版本：

6.1 CC Switch Desktop（桌面版）

支持 Windows / macOS / Linux，提供图形化界面。

安装方式：

macOS：从 GitHub Releases 下载 .dmg，拖入 Applications
Windows：下载 .exe 或 .msi 安装包，双击安装
Linux：下载 .AppImage 或 .deb 包

核心功能：

功能	说明
一键切换提供商	50+ 内置预设，支持官方 API、AWS Bedrock、社区中转等
统一管理 MCP	一个面板管理多个 AI 工具的 MCP 服务器
用量统计	跟踪花费、请求数和 Token 消耗
系统托盘快速切换	从托盘菜单即时切换，无需打开完整应用
云同步	通过 Dropbox、OneDrive、iCloud 或 WebDAV 同步配置
会话管理	浏览、搜索和恢复历史对话

6.2 使用场景示例

场景：在官方 API 和中转 API 之间切换

打开 CC Switch 桌面版，在提供商管理界面中添加你的 API Key 和端点地址，然后一键切换即可。切换后 Claude Code 会自动生效，无需重启。

七、常见问题

Q1：安装后命令行找不到 `claude` 命令？

macOS：

1
2
3

# 检查 npm 全局安装路径是否在 PATH 中
export PATH="$PATH:$(npm config get prefix)/bin"
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc

Windows：

1
2
3

# 将 npm 全局路径添加到 PATH
$npmPath = "$(npm config get prefix)"
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$npmPath", "User")

Q2：Windows 上使用 WSL 如何安装？

如果你使用 WSL（Windows Subsystem for Linux），直接在 WSL 终端中按 Linux 方式安装：

# 在 WSL 中安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# JetBrains 用户需要在插件设置中指定 WSL 命令路径
# 设置为: wsl -d Ubuntu -- bash -lic "claude"

Q3：VSCode 插件安装后看不到火花图标？

确保已安装 Claude Code CLI（第二章）
重启 VSCode
检查 VSCode 版本是否 ≥ 1.85.0
在扩展管理器中确认 Claude Code 扩展已启用

Q4：JetBrains 插件提示找不到 `claude`？

确认 CLI 已安装：在终端运行 claude --version
检查插件设置中的 Claude 命令路径是否正确
WSL 用户按 4.3 节配置 wsl -d ... 格式

Q5：CC Switch 切换后没有生效？

切换后需要在新终端会话中启动 Claude Code
在 CC Switch 桌面版中确认当前激活的提供商
检查提供商 API Key 是否有效

Q6：如何同时使用多个 Claude Code 配置？

使用 CC Switch 在不同的提供商之间快速切换
直接设置环境变量 ANTHROPIC_API_KEY 手动切换
在 CI/CD 环境中，通过设置环境变量来指定不同的 API Key

总结

安装方式	难度	适用场景
CLI（npm）	⭐	所有用户，基础必备
macOS Homebrew	⭐	macOS 用户
Windows 原生安装包	⭐	Windows 用户
VSCode 插件	⭐	VSCode 用户
JetBrains 插件	⭐⭐	IntelliJ/PyCharm/WebStorm 用户
Desktop 桌面版	⭐	偏好 GUI 的用户
CC Switch	⭐⭐	需要管理多环境/多 API 提供商

推荐安装流程：

# 第 1 步：确保有 Node.js
node --version

# 第 2 步：安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 第 3 步：验证
claude --version

# 第 4 步（可选）：安装 IDE 插件
# VSCode: 扩展市场搜索 "Claude Code"
# JetBrains: Settings → Plugins → 搜索 "Claude Code"

# 第 5 步（可选）：安装 CC Switch 桌面版管理多环境
# 访问 https://ccswitch.io 下载桌面版

安装完成后，就可以开始体验 AI 编程助手的强大功能了！建议继续阅读《Claude Code Skills 使用教程——从入门到进阶》来进一步了解如何通过技能系统提升效率。

本文首发于 CaoZH 的笔记

本文链接： https://www.geniux.top/article/5121d5d2dfb3/

版权声明： 本博客所有文章除特别声明外，均采用 CC BY 4.0 CN协议许可协议。转载请注明出处！

CaoZHProgrammer

学习使我快乐。

Claude Code 安装教程——从零开始配置你的 AI 编程助手

Claude Code 安装教程——从零开始配置你的 AI 编程助手

目录

一、安装前准备

系统要求

通用前置依赖

二、方法一：CLI 命令行安装

2.1 npm 全局安装（所有平台通用）

2.2 macOS 专用安装方式

2.3 Windows 专用安装方式

2.4 验证安装

2.5 更新与卸载

三、方法二：VSCode 插件安装

3.1 安装步骤

3.2 使用方式

3.3 VSCode 插件 vs CLI 的切换

3.4 设置项

3.5 前置条件

四、方法三：JetBrains IDEA 插件安装

4.1 安装步骤

4.2 前置条件

4.3 配置 Claude 命令路径

4.4 使用方式

4.5 自动更新

五、方法四：Desktop 桌面版

下载方式

六、CC Switch：一键切换环境变量

6.1 CC Switch Desktop（桌面版）

6.2 使用场景示例

七、常见问题

Q1：安装后命令行找不到 claude 命令？

Q2：Windows 上使用 WSL 如何安装？

Q3：VSCode 插件安装后看不到火花图标？

Q4：JetBrains 插件提示找不到 claude？

Q5：CC Switch 切换后没有生效？

Q6：如何同时使用多个 Claude Code 配置？

总结

CaoZHProgrammer

Q1：安装后命令行找不到 `claude` 命令？

Q4：JetBrains 插件提示找不到 `claude`？