第 1 章 · Claude Code 简介与安装
本章目标：理解 Claude Code 的定位与核心价值，完成安装与认证配置，验证环境可用。
1.1 什么是 Claude Code
Claude Code 是 Anthropic 推出的终端 AI 编码助手（agentic coding tool）。它运行在你的终端中，能直接读写项目文件、执行 Shell 命令、运行测试、提交 Git——而不只是生成代码片段让你手动粘贴。
与传统 IDE 插件的核心区别：
| 特性 | IDE 补全插件 | Claude Code |
|---|---|---|
| 运行位置 | 编辑器内 | 独立终端进程 |
| 能否执行命令 | ❌ | ✅ Bash / 测试 / Git |
| 上下文来源 | 当前文件 | 整个项目目录 |
| 多文件编辑 | 单文件 | 跨文件原子操作 |
| 自主性 | 被动补全 | 主动规划并执行 |
核心理念
Claude Code 遵循 "agentic" 设计哲学：你描述目标，它自主规划步骤、调用工具、验证结果、迭代修正——你负责审查和决策。
1.2 安装
前置条件
- Node.js 18+
- macOS / Linux / Windows (WSL)
npm 全局安装
bash
npm install -g @anthropic-ai/claude-code验证安装
bash
claude --version
# 输出版本号，如 2.1.241
claude --help
# 显示所有可用子命令和选项1.3 认证配置
Claude Code 支持两种认证方式：
方式一：Anthropic API Key（按用量计费）
bash
export ANTHROPIC_API_KEY="sk-ant-..."建议将此行加入 ~/.zshrc 或 ~/.bashrc 持久化。
方式二：Claude Pro/Max 订阅（包含在订阅内）
首次运行 claude 时选择 "Log in with Claude account"，浏览器会打开 OAuth 认证页面。
1.4 首次启动
进入任意项目目录，启动 Claude Code：
bash
cd my-project/
claude你会看到交互式 REPL 提示符。输入一条消息测试：
text
> 请告诉我这个项目的结构和技术栈Claude Code 会自动读取目录中的文件、分析代码、给出总结。
1.5 版本管理
bash
# 检查当前版本
claude --version
# 更新到最新版
npm update -g @anthropic-ai/claude-code
# 固定特定版本（团队协作推荐）
npm install -g @anthropic-ai/claude-code@2.1.241版本一致性
团队协作时，建议所有成员使用相同版本的 Claude Code，避免因行为差异导致 CLAUDE.md 指令效果不一致。
本章小结
- Claude Code 是终端 AI 编码助手，能直接操作文件、执行命令、管理 Git；
- 通过
npm install -g @anthropic-ai/claude-code安装； - 支持 API Key 和 Pro/Max 订阅两种认证方式；
- 在项目根目录启动
claude即可开始使用。
🧪 随堂测验
点击你认为正确的选项。答错时会展示正确答案与原因解析。
1. Claude Code 与传统 IDE 插件的核心区别是什么？
2. 安装 Claude Code 的正确命令是？
3. Claude Code 支持哪两种认证方式？
4. Claude Code 要求的最低 Node.js 版本是？
🛠️ 动手实践
- 安装 Claude Code 并验证版本号。
- 配置 API Key 或登录订阅账号。
- 在一个已有项目中启动
claude，让它描述项目结构。
完成后进入第 2 章。