Claude Code安装指南：新手快速上手教程
要真正上手Claude Code，搭建运行环境是首要任务。这个步骤类似盖楼前打地基，虽然必须完成，但流程并不复杂。我们从最基础的Node.js环境开始。
1. 环境安装
访问官网进行安装
首先，前往Node.js官方网站（nodejs.org/zh-cn）下载并安装对应操作系统的版本。这是后续所有操作的根基，缺少它将无法运行任何Claude Code命令。
验证安装结果
安装完成后，如何确认环境已正确配置？打开终端（Terminal），逐行执行以下两条指令，检查是否返回了版本号。
# 确认Node.js版本
node --version
# 确认npm版本
npm --version
如果终端打印出了版本号信息，说明Node.js和npm已就绪。下一步，我们将引入真正的核心——Claude Code命令行工具。
2. 安装claude-code
2.1. 通过命令行工具安装
安装过程极为简洁，一条全局安装命令即可完成。在终端中执行：
# 全局安装Claude Code命令行工具
npm install -g @anthropic-ai/claude-code
# 控制台输出如下信息表明安装成功
# added 2 packages in 12s
# npm notice
# npm notice New major version of npm a vailable! 10.9.7 -> 11.17.0
# npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.17.0
# npm notice To update run: npm install -g npm@11.17.0
# npm notice
当看到“added 2 packages”以及npm的升级提示时，即表示安装成功。后续关于npm更新的通知可以忽略，它仅提醒你升级npm自身版本。
2.2. 验证安装是否成功
如何确认Claude Code已正确安装？再执行一次版本检查。
# 校验Claude Code版本
claude --version
# 2.1.179 (Claude Code)
若返回具体的版本号（如2.1.179），说明基石已稳固落地。
1.2. 打开claude
安装并验证无误后，即可在终端中启动Claude Code。直接输入：
claude <回车>
1.3. 从官网获取免费密钥
首次运行时，系统会提示进行身份验证。Claude Code需要与Anthropic的API服务器通信，因此必须提供一个有效的API密钥。该密钥可通过Anthropic官方控制台（platform.claude.com/）获取。
1.3.1. 初次输入claude命令，出现如下提示：
当你在终端中首次输入 claude 并回车，系统会弹出提示，要求设置API密钥才能继续使用。
1.3.2. 按回业，如未登录会让你登录，无帐号则要先注册帐号
按下回车后，浏览器将自动跳转至Anthropic控制台页面（console.anthropic.com/）。若尚未拥有账号，需要根据指引完成注册。推荐使用Google邮箱注册，流程顺畅。注册成功后，你的邮箱会收到一封确认邮件，点击邮件中的‘sign in to Claude Console’按钮即可顺利登录。
（图片位置：注册成功后的邮件截图和登录后的控制台界面）
1.3.3. 进入充值界面
登录后你将进入操作面板。请注意选择“Individual”身份（个人用户）。接下来最关键的一步：充值。API调用按量计费，需要先预存费用。
在界面中，选择左侧的‘USD5’套餐（最基础的充值选项），然后依次点击‘Skip for now’跳过其他推荐项，直至进入下一个页面。
（图片位置：选择USD5套餐和跳过选项的界面截图）
进入新页面后，在左侧菜单中找到“API keys”，点击“Create API key”生成一个新的密钥。
（图片位置：创建API Key的界面截图）
将生成的以 sk-ant- 开头的密钥完整复制下来。回到终端后，有两种方式使用该密钥：
- 设置环境变量：将密钥配置为环境变量，后续每次启动Claude Code时自动加载，无需重复输入。
- 直接粘贴到终端：当终端提示输入API key时，将密钥直接粘贴进去。
推荐方式为设置环境变量。以Windows系统为例：
> set ANTHRPIC_API_KEY=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
# 再次启动Claude Code
> claude重要提醒：
- 样式选项保持默认即可。
- 在终端中请勿选择 "Claude account with subscription" 选项。
- 启动
claude时，应选择 "Anthropic Console API key"（不同版本的提示文字可能略有差异，但逻辑完全一致）。
1.4. 可进入claude页面
1.4.1. 出现选择界面样式控制台（一般默认即可） -- API-Key已有的情况
如果你已提前配置好环境变量，再次运行 claude 命令后，会直接进入界面风格选择步骤。通常选择默认样式即可。
（图片位置：选择界面样式的控制台截图）
1.4.2. 选择 "I trust this folder", 进入如下界面
随后，Claude Code会询问是否信任当前工作目录。选择“I trust this folder”，即可正式进入对话界面。
（图片位置：信任文件夹的提示截图和最终进入的对话界面）
1.4.3. 在控制台输入，如 "你是谁" ，会有相应的输出
最后，验证整个流程是否通畅。在控制台中输入“你是谁”或“hello”，观察Claude Code是否正常返回了回应。若收到回复，说明环境配置与身份认证均已成功，你可以立即用它协助编程任务了。
（图片位置：与Claude Code的初次对话截图）