纲要
Claude Code安装流程- 环境依赖准备
Node.js与npmGit版本管理工具
- 环境验证方法
Claude Code全局安装npm install -g @anthropic-ai/claude-code
- 安装验证
- 首次启动与登录
- 环境依赖准备
- 涉及技术栈
Node.js(JavaScript 运行时)npm(Node.js 包管理器)Git(分布式版本控制系统)Claude Code(Anthropic 官方命令行 AI 编程助手)
环境准备
在安装 Claude Code 之前,需要确保本地开发环境已配置必要的依赖项。Claude Code 基于命令行运行,其核心依赖包括 Node.js 运行时及其包管理器 npm,以及 Git 版本控制系统。
安装 Node.js 与 npm
Node.js 是 Claude Code 的运行基础环境,npm 则用于后续的全局安装操作。请根据操作系统访问 Node.js 官方网站 下载安装包。
| 操作系统 | 架构 | 推荐版本 | 安装方式 |
|---|---|---|---|
| macOS | Apple Silicon (ARM64) | LTS 最新版 | 下载 .pkg 安装包,图形化引导安装 |
| macOS | Intel (x64) | LTS 最新版 | 下载 .pkg 安装包,图形化引导安装 |
| Windows | 64-bit (x64) | LTS 最新版 | 下载 .msi 安装包,图形化引导安装 |
| Windows | ARM64 | LTS 最新版 | 下载 .msi 安装包,图形化引导安装 |
安装验证
安装完成后,打开终端 (macOS 为 Terminal.app,Windows 为 CMD 或 PowerShell),执行以下命令以验证 Node.js 和 npm 是否正确安装:
# 检查 Node.js 版本
node -v
# 检查 npm 版本
npm -v
若上述命令均成功输出版本号(例如 v20.11.0 与 10.2.4),则表明环境已就绪。若提示命令未找到,请检查安装路径是否已添加至系统环境变量 PATH。
安装 Git
Git 是分布式版本控制系统,在 Claude Code 的项目协作与版本管理中为可选但强烈建议安装的依赖。请访问 Git 官方网站 下载对应操作系统的安装包。
- macOS:可通过下载
.dmg安装包,或通过Homebrew安装 (brew install git)。 - Windows:下载
.exe安装程序,按向导完成安装。
安装验证
执行以下命令验证 Git 安装状态:
git --version
若输出版本信息(如 git version 2.43.0),则说明安装成功。
Claude Code 安装
完成上述环境准备后,通过 npm 执行 Claude Code 的全局安装。全局安装 (-g 参数,即 --global) 可将命令添加至系统路径,便于在任意目录下调用。
npm install -g @anthropic-ai/claude-code
该命令将从 npm 官方仓库下载 @anthropic-ai/claude-code 包,并全局安装其可执行文件。
安装验证与启动
验证安装
安装完毕后,使用以下命令验证 Claude Code 是否成功安装:
claude --version
若显示版本号(例如 0.1.0),则表示安装已成功。
首次启动与认证
执行以下命令启动 Claude Code:
claude
首次启动时,程序会引导用户进行身份认证,通常需要配置 API 密钥或通过浏览器登录 Anthropic 账户。认证通过后,即可进入交互式命令行界面,开始使用 Claude Code 进行代码相关任务。
安装后的命令结构示意(全局)
/usr/local/bin/
└── claude # Claude Code 可执行文件(由 npm 全局安装创建)
/usr/local/lib/node_modules/
└── @anthropic-ai/
└── claude-code/ # 源码与依赖
├── package.json
└── dist/
└── index.js
参考文档
官方文档
参考链接
总结
Claude Code 的安装过程本质上是一个标准的前端工具链配置流程,核心依赖于 Node.js 运行时与 npm 包管理器。
本文档详细梳理了从环境依赖安装到全局安装 Claude Code 的完整步骤,涵盖版本验证与启动流程。
后续的深度配置(如模型密钥绑定、coding plan 定制、插件集成等)需基于已就绪的命令行环境展开。
357



被折叠的 条评论
为什么被折叠?



