0.1: 安装

• 完成时间： 15 分钟
• 前提要求： Claude Code 访问权限

概述

模块 0.1 涵盖 Claude Code 的安装和认证。这个参考指南提供快速访问信息，以补充互动教程。

关键要点： Claude Code 需要 Node.js 18+ 和 Claude 账户。一旦满足前提要求，安装只需不到 5 分钟。

前提要求

获取 Claude Code：

1. 访问 claude.ai/code
2. 注册或登录 Claude 账户
3. 下载并安装 Claude Code
4. 具体使用限制和权限请参考官方快速开始指南

注意事项：

• 官方账号开通、付费可能存在困难，且账号容易被封禁
• 替代方案： 可以配合 Claude Code CLI + 国产模型使用
• 详细说明请参考：Claude Code CLI + 国产模型使用指南

如何打开终端

本指南中的所有命令都需要输入到终端（也称为命令行）中。以下是打开方式：

Mac：

1. 按 Cmd + Space 打开 Spotlight
2. 输入 “Terminal”
3. 按回车

Windows：

1. 按 Windows 键
2. 输入 “PowerShell”
3. 按回车

你会看到一个带有闪烁光标窗口 - 这就是你输入命令的地方。

快速安装

检查 Node.js 版本

打开终端并输入此命令，然后按回车：

node --version

如果看到 v18.0.0 或更高版本，继续安装。否则，先安装 Node.js。

安装 Node.js（如果需要）

推荐： 从 nodejs.org 下载 LTS 版本

使用包管理器：

重要： 安装 Node.js 后，完全关闭终端窗口并打开一个新的。这会刷新系统的 PATH，使其识别 node 命令。

安装 Claude Code

在终端中，复制并粘贴以下命令之一，然后按回车：

Mac：

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell)：

irm https://claude.ai/install.ps1 | iex

验证安装

在终端中输入此命令并按回车：

claude --version

如果看到版本号，安装成功。如果看到 command not found，完全关闭终端窗口并打开一个新的，然后重试。

认证

在终端中输入此命令并按回车：

claude

当提示时：

1. 选择”具有订阅的 Claude 账户”（不是 Anthropic Console）
2. 完成浏览器认证
3. 选择你偏好的终端文本样式

认证后，你会看到 Claude Code 欢迎屏幕。

健康检查

在 Claude Code 中，输入此命令：

/doctor

这会验证：

• 安装完整性
• 活跃订阅
• 系统配置
• 常见问题

健康的输出会在所有项目上显示绿色复选标记。

故障排除

命令未找到：claude

修复：

1. 完全关闭终端窗口并打开一个新的
2. 如果仍然失败，检查 PATH 配置：

Mac： 添加到 ~/.bashrc 或 ~/.zshrc：

export PATH=$HOME/.local/bin:$PATH

Windows： 重启计算机（安装程序会自动更新 PATH）

需要订阅

• 在 claude.ai 验证活跃的 Claude Pro/Max 订阅
• 注销并重新登录以刷新认证

Node 版本太旧

在终端中输入此命令：

node --version

如果低于 v18.0.0，从 nodejs.org 下载最新 LTS 版本

权限被拒绝

Mac：

sudo curl -fsSL https://claude.ai/install.sh | bash

Windows： 以管理员身份运行 PowerShell（右键 PowerShell → 以管理员身份运行）

命令参考

资源

• 官方快速开始指南（中文）
• 官方文档（英文）
• GitHub Issues
• Claude Code 社区论坛

下一步是什么？

模块 0.2： 启动 Claude Code 并克隆课程仓库。

你将学习：

• 与 Claude Code 进行第一次对话
• 使用 Claude 克隆仓库
• 理解基于意图的任务委派

互动轨道：继续使用课程仓库的 CLAUDE.md 文件