Claude Code 学习站
v2.1.148

安装 / 快速上手

把 Claude Code 装上,跑通第一个会话。包括环境要求、各平台命令、首次登录与升级。

环境要求

  • Node.js 18 或更高版本(推荐 LTS 20+)。Node 22 也已经稳定支持。
  • 一个能访问 anthropic.com 的网络环境。中国大陆用户可能需要为 Node 配置代理(HTTPS_PROXY 环境变量)或使用镜像。
  • 一个 Claude 账号(claude.ai)或者 Anthropic API Key。两种方式二选一即可。

不需要 Python、Docker 或者本地大模型。Claude Code 是一个纯 Node CLI,所有推理在 Anthropic 云端完成。

检查 Node 版本:

node --version
# 应该看到 v18.x.x 或更高

如果 Node 版本太低,推荐用 nvm 或 fnm 装一个最新的 LTS。

macOS / Linux / WSL

用 npm 全局安装即可:

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

如果遇到 EACCES 权限错误,不要直接 sudo —— 推荐改 npm 全局目录到用户家目录:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# 加到 shell 启动脚本(~/.zshrc 或 ~/.bashrc)
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
 
npm install -g @anthropic-ai/claude-code

验证安装:

claude --version

Windows

推荐 使用 WSL2,体验和 Linux 一致。原生 Windows 也支持,但部分文件路径处理可能有差异。

WSL2 装好后,在 WSL 终端里:

sudo apt update && sudo apt install -y nodejs npm
npm install -g @anthropic-ai/claude-code

或者用 nvm-windows / fnm 装 Node 20+,再 npm install -g @anthropic-ai/claude-code。

首次登录

claude

第一次启动会引导你登录。两种选择:

  1. 使用 Claude 订阅(claude.ai) —— 浏览器跳转 OAuth,适合已有 Pro/Max 订阅的用户。
  2. 使用 API Key —— 从 console.anthropic.com 拿一个 key,按用量计费。

如果服务器没有浏览器,选 API Key 方式即可。

第一个会话

进入任意项目目录,启动:

cd ~/my-project
claude

试一个最简单的请求:

> 这个项目是用什么写的?

Claude 会读 README.md、package.json 等关键文件,回你一段总结。

再来一个改代码的:

> 在 src/utils.ts 里加一个 formatDate 函数,接收 ISO 字符串,返回 YYYY-MM-DD

Claude 会:

  1. 先用 Read 工具看 src/utils.ts
  2. 用 Edit 工具改写
  3. 把 diff 给你确认

按 Enter 接受,或者 n 拒绝。

省时小贴士:输入 /init 让 Claude 给项目生成一份 CLAUDE.md,把项目结构、惯例写进去,后续会话效率会高很多。

升级与卸载

升级到最新版:

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

或者用内置命令:

claude update

卸载:

npm uninstall -g @anthropic-ai/claude-code
# 同时清理配置(可选)
rm -rf ~/.claude

下一步:看 核心功能示例 → 学习文件编辑、Agent、Skills、Hooks 等能力。