从头学 Claude Code（二）—— 请个编程实习生进门

本系列适合零基础新手，手把手带你掌握 AI 编程助手

上节回顾

上一讲我们认识了 Claude Code 这个”编程实习生”。这一讲，我们把它请进你的电脑。

就像请员工上门工作一样，需要： 1. 准备好办公环境（Node.js） 2. 领进门（安装 Claude Code） 3. 给它门禁卡（API Key）

1. 准备工作：检查”电路”

Claude Code 本质上是一个 Node.js 应用，所以你的电脑需要先安装 Node.js。

检查是否已有 Node.js

1
2
3

# 终端里运行这两条命令
node --version
npm --version

如果显示了版本号（比如 v20.x.x），说明已经有了，跳过安装步骤。

如果显示”command not found”，继续往下看。

安装 Node.js：推荐 nvm

比喻：nvm 就像一个”插座转换器”，让你可以随时切换不同版本的 Node.js，就像换不同型号的手机充电器一样方便。

# macOS / Linux 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安装 LTS（长期稳定版）Node.js
nvm install --lts

💡 提示：Windows 用户可以下载 Node.js 官网的安装包，或者使用 nvm-windows。

2. 安装 Claude Code

一行命令搞定

# 全局安装
npm install -g @anthropic/claude-code

# 验证安装
claude --version

⚠️ 常见问题：安装后说”command not found”？

解决方案：检查 PATH（npm 全局目录没加到系统路径）。就像请了保洁但没给她钥匙进门。

3. 给它”门禁卡”：API Key

什么是 API Key？

比喻：API Key 就像公司的门禁卡——没有它，实习生进不了公司大门。

Claude Code 需要通过 API Key 连接 Anthropic 的服务器。

如何获取？

访问 Anthropic Console
注册账号（需要身份证登记）
创建 API Key（领一张新卡）

配置 API Key

# 方式一：直接给卡（命令行）
claude config set ANTHROPIC_API_KEY your_api_key_here

# 方式二：给张临时通行证（环境变量）
export ANTHROPIC_API_KEY=your_api_key_here

⚠️ 重要：API Key 就像银行卡密码，千万不要泄露到网上！

4. 它的”工位”在哪里？

Claude Code 会创建自己的”办公室”：

~/                   # 你家
├── .claude/          # 它的办公室
│   ├── config.json   # 工作手册（配置）
│   ├── projects/     # 项目文件柜
│   └── logs/         # 工作日志
└── memory/           # 它的记忆本（可选）

5. 第一次打招呼：测试连接

# 启动交互模式——就像叫住它说"嘿，来了？"
claude

# 如果一切正常，你会看到欢迎消息
# 输入 "Hello" 测试——就像对讲机试音

或者用一次性模式：

1	claude --print "Hello"

6. 常见问题：进门那些坑

问题	原因	解决方案
安装后找不到命令	PATH 没配置	检查 npm 全局目录
API Key 无效	密钥错了或过期	去控制台确认
网络连接失败	被墙了或网络问题	检查网络或代理

本节小结

完成以下事项，你的”编程实习生”就进门了：

安装 Node.js（通电）
安装 Claude Code（领进门）
获取并配置 API Key（给门禁卡）
运行第一次测试（打招呼）

🎉 恭喜！你已经成功请了个编程实习生回家！

下节预告

下一讲：看看这个”实习生”有哪些工具可用——核心工具详解

有问题？评论区见！如果觉得有帮助，点个赞再走~

标签: #Claude Code #AI编程 #编程助手 #安装教程

Stone's Blog

从头学 Claude Code（二）把它请进门——环境安装