零基础教程：Claude Code 从安装到使用

• 它是一个在终端里帮你写代码的 AI 助手。
• 你告诉它“帮我创建一个计算器”，它就会自动生成代码文件，甚至帮你运行测试。
• 你需要会一点打字，不需要会写代码（但懂一点更好）。

第二步：你需要准备的东西

1. 一台电脑（Windows / Mac / Linux 都可以）
2. 网络（Claude Code 需要联网调用 AI）
3. 一个邮箱（用来注册 Anthropic 账号）
4. 一点点耐心（安装过程会用到几个命令，我全写给你）

第三步：安装 Node.js（这是基础环境）

Claude Code 需要 Node.js 来运行。Node.js 就像是一个“翻译器”，让电脑能理解 Claude Code 的命令。

3.1 下载 Node.js

• 打开浏览器，在搜索引擎中搜索 Node.js 官网，进入官方网站。
• 在首页找到两个大按钮，点击左边的 LTS（长期支持版，更稳定）。
• 下载完成后，双击安装包，一路点“下一步”或“继续”（所有默认选项都行）。

3.2 验证安装

• Windows：按下键盘 Win 键，输入 cmd，回车打开命令提示符。
• Mac：按下 Command + 空格，输入 终端，回车打开。
• Linux：按 Ctrl + Alt + T 打开终端。

在打开的黑色窗口里，输入以下命令后按回车：

node -v

如果看到类似 v18.20.0 这样的文字，说明安装成功。如果报错，请重启电脑再试一次。

第四步：安装 Claude Code

在终端里输入以下命令，然后按回车：

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

• 这个命令会从网上下载 Claude Code 并安装到你的电脑里。
• 安装过程可能需要几十秒，不要关闭窗口。
• 如果遇到权限错误（比如 EACCES），Mac/Linux 用户可以在命令前加 sudo（输入密码）：

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

  Windows 一般不会出现权限问题。

安装完成后，输入以下命令验证：

claude --version

如果显示版本号（例如 0.1.0），就成功了。

第五步：获取 API 密钥（相当于密码）

Claude Code 需要向 Anthropic 的服务器发送请求，这需要一个“钥匙”来验证身份。

1. 打开浏览器，在搜索引擎中搜索 Anthropic Console，进入官方网站。
2. 点击 Sign Up 注册账号（用邮箱或 Google 账号）。
3. 登录后，在左侧菜单找到 API Keys。
4. 点击 Create Key，给你的密钥取个名字（比如“mykey”）。
5. 复制生成的密钥（类似 sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx）。
   • 注意： 关掉页面后密钥就看不到了，请立即保存到安全的地方（比如记事本）。

第六步：把密钥告诉 Claude Code

你需要设置一个环境变量，让 Claude Code 知道你的密钥。

临时设置（每次打开终端都要重新设置）

在终端中输入以下命令，把 sk-ant-xxxxx 换成你的真实密钥：

Mac/Linux 用户：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx"

Windows 用户（cmd 命令提示符）：

set ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

永久设置（推荐）

Mac/Linux 用户：

1. 在终端中输入：nano ~/.zshrc （如果用的是 bash，则输入 nano ~/.bashrc）
2. 在文件末尾添加一行：export ANTHROPIC_API_KEY="你的密钥"
3. 按 Ctrl+O 保存，按 Ctrl+X 退出
4. 输入 source ~/.zshrc 生效

Windows 用户：

1. 搜索“环境变量”，打开“编辑系统环境变量”。
2. 点击“环境变量”，在“用户变量”里点击“新建”。
3. 变量名：ANTHROPIC_API_KEY，变量值：你的密钥。
4. 确定后，关闭所有终端再重新打开。

第七步：开始使用 Claude Code

7.1 进入你的项目文件夹

在终端中，使用 cd 命令进入你存放代码的文件夹。例如：

cd Desktop/my-project

（如果你还没有项目文件夹，可以先创建一个：mkdir my-project 然后 cd my-project）

7.2 启动 Claude Code

在终端中输入：

claude

你会看到类似这样的对话界面：

Claude Code (v0.1.0)
Type your request or 'exit' to quit.
You: 

7.3 你的第一个请求

现在你可以用中文或英文输入指令。比如：

帮我创建一个 index.html 文件，里面是一个简单的网页，标题是“我的第一个AI页面”，背景颜色是浅蓝色。

Claude 会开始工作，并显示它创建了文件。你可以打开文件夹看到 index.html 已经在了。

7.4 更多示例（零基础也能用）

• 修改文件：把 index.html 的背景颜色改成粉色
• 读取文件：显示 index.html 的内容
• 运行命令：帮我打开 index.html 在浏览器中预览（Mac 用 open index.html，Windows 用 start index.html）
• 解释代码：解释一下这段代码做了什么（需要先粘贴代码给它）
• 写一个简单程序：用 Python 写一个计算器，支持加减乘除，保存为 calculator.py

注意：Claude 执行命令时会先显示命令，并问你是否允许（输入 y 确认）。这是安全设计。

第八步：退出 Claude Code

在对话中，输入 exit 然后回车，或者直接按 Ctrl + C 即可退出。

常见问题（零基础版）

Q：我输入 claude 显示“命令未找到”怎么办？
A：说明 Node.js 安装有问题，或者 npm 全局安装路径没加到环境变量。重新安装 Node.js，并选择“自动添加到 PATH”选项。

Q：密钥填错了怎么改？
A：重新设置环境变量，或者直接在终端里再执行一次 export ANTHROPIC_API_KEY="新密钥"。

Q：对话过程中卡住了怎么办？
A：按 Ctrl + C 强制退出，再重新启动 claude。

Q：Claude 说“没有权限读取文件”
A：确保你在项目文件夹内启动的 claude，并且该文件夹有读写权限。

Q：我不想用 API 付费，有免费版吗？
A：Claude Code 目前需要 API 密钥，而 API 是付费的（充值后才能用）。如果你只是好奇，可以试试 Claude 的免费版本，但不如 Claude Code 强大。

总结

您现在已经能：

• 安装 Node.js 和 Claude Code
• 获取 API 密钥并配置
• 在终端里用自然语言写代码、修改文件、运行命令

这只是一个开始，随着您使用更多，您会发现它能帮您做越来越多的事情。如果遇到任何问题，欢迎随时追问，我会帮您一步步解决。