Claude Code从零开始手把手安装与初次使用详细教程

想要快速上手Claude Code，第一步自然是搭建好运行环境。就像盖房子必须先打地基一样，这一步虽然无法跳过，但操作起来并不复杂。下面我们就从最核心的Node.js环境配置开始讲起。

1. 环境安装

访问官网进行安装

首先，前往Node.js官方网站（nodejs.org/zh-cn）下载并安装Node.js运行环境。这是所有后续操作的基础，没有它，后续步骤将无法正常执行。

验证安装结果

安装完成后，如何确认环境已就绪？方法很简单：打开你的终端（命令行工具），依次输入以下两条命令，检查是否成功返回版本号。

# 检查Node.js版本
node --version

# 检查npm版本
npm --version

如果终端正确输出了版本号，说明Node.js环境已准备就绪。接下来，我们要正式引入本教程的主角——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)

如果终端返回了版本号信息，恭喜你，基础环境已经稳稳搭建完成。

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. 进入充值界面

登录成功后，你将进入Anthropic控制台的操作界面。请注意，在身份选择时记得勾选“Individual”（个人用户）。接下来是关键的一步：充值。没错，API调用需要预先充值才能使用。

在控制台界面中，选择左侧的‘USD5’套餐（这是最基础的充值选项），然后依次点击‘Skip for now’跳过其余选项，直到进入下一个页面。

（图片位置：选择USD5套餐和跳过选项的界面截图）

进入新页面后，找到左侧菜单中的“API keys”选项，接着点击“Create API key”来生成一个新的密钥。

（图片位置：创建API Key的界面截图）

将生成的那个以 sk-ant- 开头的密钥完整复制下来。然后回到你的终端，有以下两种方式可以使用该密钥：

1. 设置环境变量：将密钥配置为系统环境变量，这样以后每次启动Claude Code时都无需重复输入。
2. 直接粘贴到终端：当终端提示你输入API key时，直接粘贴进去即可。

一个常见且便捷的做法是直接设置环境变量，以Windows系统为例：

> set ANTHRPIC_API_KEY=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

# 再输入命令
> claude

重要提醒：

1. 样式选项一般选择默认即可。
2. 不要在终端选择 "Claude account with subscription"。
3. 启动 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的初次对话截图）