01 - 快速入门
🚀 15分钟快速上手 Claude Code,开启 AI 辅助编程之旅
📋 本章目标
- ✅ 理解什么是 Claude Code
- ✅ 完成安装和基础配置
- ✅ 创建第一个 AI 辅助项目
- ✅ 掌握基本操作流程
预计用时: 15-20分钟
🤔 什么是 Claude Code?
核心定义
Claude Code 是指将 Claude AI(由 Anthropic 开发的大型语言模型)集成到代码编辑器中的 AI 编程助手,主要通过 Cursor 编辑器实现。
Claude AI (大脑)
+
Cursor Editor (载体)
+
你的创意 (灵魂)
=
Claude Code (超级编程体验)
与传统编程的区别
传统编程方式
你 → 思考 → 编写代码 → 调试 → 完成
(100%人工)
Claude Code 方式
你 → 描述需求 → Claude 生成代码 → 你审查调整 → 完成
(AI辅助,效率↑10倍)
Claude 的独特优势
| 特性 | Claude 3.5 Sonnet | 说明 |
|---|---|---|
| 上下文窗口 | 200K tokens | ≈ 150,000 词或 500 页代码 |
| 代码理解 | ⭐⭐⭐⭐⭐ | 理解复杂项目结构 |
| 多语言支持 | 50+ | Python、JS、TS、Go、Rust... |
| 安全性 | Constitutional AI | 拒绝生成有害代码 |
| 响应速度 | <2秒 | 快速交互体验 |
🛠️ 安装与配置
前置要求
- 操作系统: macOS / Windows / Linux
- 内存: 建议 8GB+
- 网络: 稳定的互联网连接
- API: Claude API Key(可选,Cursor 有内置额度)
步骤1: 安装 Cursor
macOS
# 方法1: 官网下载
# 访问 https://cursor.sh
# 下载 .dmg 文件并安装
# 方法2: Homebrew
brew install --cask cursor
Windows
# 访问 https://cursor.sh
# 下载 .exe 安装包
# 运行安装向导
Linux
# 下载 AppImage
wget https://download.cursor.sh/linux/appImage/x64
chmod +x cursor-*.AppImage
./cursor-*.AppImage
步骤2: 首次启动配置
2.1 选择 AI 模型
打开 Cursor 后:
- 按
Cmd/Ctrl + Shift + P打开命令面板 - 输入 "Settings"
- 选择 "Cursor Settings"
- 选择模型:
推荐配置:
- 主模型: Claude 3.5 Sonnet (最强)
- 快速模型: Claude 3 Haiku (省额度)
2.2 设置 API Key(可选)
免费额度(内置):
- 每月 500 次请求
- 适合轻度使用
自定义 API Key:
Settings → Cursor → API Keys → Add Claude API Key
获取 API Key:
- 访问 https://console.anthropic.com
- 注册账号
- 创建 API Key
- 复制并粘贴到 Cursor
步骤3: 基础设置
推荐配置
// .cursorrules 文件 (项目根目录)
{
"model": "claude-3-5-sonnet-20241022",
"rules": [
"代码风格:使用 ESLint/Prettier 标准",
"注释:为复杂逻辑添加清晰注释",
"测试:为核心功能生成单元测试",
"类型安全:TypeScript 项目启用严格模式"
],
"context": {
"include": ["src/**/*", "docs/**/*"],
"exclude": ["node_modules", "dist", ".git"]
}
}
🎯 第一个 AI 辅助项目
项目:创建一个 Todo App
让我们用 Claude Code 创建一个简单的 Todo 应用,体验 AI 辅助开发的魅力。
Step 1: 项目初始化
1.1 创建项目文件夹
在 Cursor 中:
- File → Open Folder
- 选择或创建文件夹
my-todo-app
1.2 与 Claude 对话
按 Cmd/Ctrl + L 打开 Chat 面板,输入:
请帮我创建一个 React + TypeScript 的 Todo App 项目结构,
包括:
1. 基础配置文件
2. 文件夹结构
3. 必要的依赖
项目需求:
- 使用 Vite 构建
- 支持添加、删除、标记完成待办事项
- 使用 Tailwind CSS 样式
1.3 Claude 会生成
my-todo-app/
├── package.json
├── tsconfig.json
├── vite.config.ts
├── index.html
├── src/
│ ├── main.tsx
│ ├── App.tsx
│ ├── components/
│ │ ├── TodoList.tsx
│ │ ├── TodoItem.tsx
│ │ └── AddTodo.tsx
│ ├── types/
│ │ └── todo.ts
│ └── styles/
│ └── index.css
└── README.md
点击 "Apply",Claude 会自动创建所有文件!
Step 2: 编写核心功能
2.1 使用 Cmd/Ctrl + K(Inline 模式)
- 打开
src/App.tsx - 按
Cmd/Ctrl + K - 输入 Prompt:
实现 Todo App 的核心逻辑:
- 状态管理使用 useState
- 支持添加、删除、切换完成状态
- 数据持久化到 localStorage
- 添加优雅的动画效果
Claude 会直接在文件中生成代码!
2.2 多文件编辑
想要同时修改多个相关文件?
- 在 Chat 中输入:
现在让我们:
1. 在 TodoItem.tsx 中添加编辑功能
2. 在 TodoList.tsx 中添加过滤功能(全部/已完成/未完成)
3. 在 App.tsx 中整合这些功能
Claude 会理解上下文,同时编辑多个文件!
Step 3: 运行项目
3.1 安装依赖
在终端(Cursor 内置):
npm install
3.2 启动开发服务器
npm run dev
3.3 查看结果
浏览器打开 http://localhost:5173
🎉 恭喜!你的第一个 AI 辅助项目完成了!
🎮 基本操作流程
核心快捷键
| 快捷键 | 功能 | 使用场景 |
|---|---|---|
Cmd/Ctrl + L | 打开 Chat | 长对话、复杂需求 |
Cmd/Ctrl + K | Inline Edit | 快速修改当前文件 |
Cmd/Ctrl + I | Composer | 多文件项目级操作 |
Cmd/Ctrl + Shift + L | 清空上下文 | 重新开始对话 |
Tab | 接受建议 | 采用 AI 生成的代码 |
Esc | 拒绝建议 | 不使用 AI 建议 |
三种交互模式
1. Chat 模式 (Cmd + L)
适合:
- 询问问题
- 讨论架构
- 学习知识
- 需要解释说明
示例:
User: 解释一下 React Hooks 的闭包陷阱
Claude: [详细解释 + 代码示例]
2. Inline 模式 (Cmd + K)
适合:
- 快速修改代码
- 重构函数
- 添加功能
- 修复 Bug
示例:
[选中一个函数]
Cmd + K
Prompt: 添加错误处理和 loading 状态
3. Composer 模式 (Cmd + I)
适合:
- 创建新功能(涉及多文件)
- 重构模块
- 项目级修改
示例:
Cmd + I
Prompt: 添加用户认证系统,包括登录、注册、密码重置
工作流程示例
典型的开发流程
1. 需求分析(Chat)
"我想添加用户评论功能,需要哪些步骤?"
2. 架构设计(Chat)
"推荐一个评论系统的数据库设计"
3. 代码生成(Composer)
"创建评论系统的前后端代码"
4. 细节调整(Inline)
[选中具体代码] Cmd+K "优化这段代码的性能"
5. 测试(Chat)
"为评论功能生成单元测试"
6. 文档(Chat)
"生成 API 文档"
💡 实用 Prompt 模板
创建功能
创建一个 [功能名称],要求:
- 功能1
- 功能2
- 功能3
技术栈:[React/Vue/...] + [TypeScript/...] + [其他]
代码风格:[简洁/详细注释/...]
修复问题
当前代码存在问题:
[描述问题]
期望行为:
[期望结果]
请帮我修复并解释原因
优化代码
优化以下代码:
- 性能优化
- 可读性提升
- 添加错误处理
- 遵循最佳实践
[粘贴代码]
学习理解
请解释这段代码:
[粘贴代码]
包括:
1. 整体功能
2. 关键步骤
3. 最佳实践
4. 潜在问题
⚠️ 新手常见问题
问题1: AI 生成的代码不符合预期
原因: Prompt 不够具体
解决:
- "创建一个表单"
+ "创建一个用户注册表单,包含:
+ - 邮箱验证(正则)
+ - 密码强度检查(8位+大小写+数字)
+ - 确认密码匹配
+ - 提交时显示loading
+ - 成功后跳转到首页"
问题2: Claude 没有读取相关文件
原因: 上下文未正确引用
解决:
方法1: 使用 @ 符号引用
"基于 @database.ts 中的类型,创建API"
方法2: 在 Composer 中添加文件
点击 "Add Context" → 选择相关文件
问题3: 回答太长或太短
解决:
太长: "请简明扼要地..."
太短: "请详细解释,包含代码示例..."
问题4: 生成的代码有错误
不要慌!这很正常
- 告诉 Claude 哪里有问题
- 粘贴错误信息
- Claude 会修复
刚才的代码在运行时报错:
[错误信息]
请修复
✅ 检查清单
完成本章后,你应该能够:
- [ ] 理解 Claude Code 的基本概念
- [ ] 成功安装并配置 Cursor
- [ ] 创建第一个 AI 辅助项目
- [ ] 使用三种交互模式(Chat/Inline/Composer)
- [ ] 编写有效的 Prompt
- [ ] 解决常见问题
🎯 练习任务
任务1: 扩展 Todo App
在我们的 Todo App 基础上:
- [ ] 添加截止日期功能
- [ ] 添加优先级标签
- [ ] 添加搜索功能
- [ ] 优化 UI 样式
提示: 使用 Composer 模式一次性完成
任务2: 创建新项目
从零开始创建:
- [ ] 天气查询应用(调用天气API)
- [ ] Markdown 笔记本
- [ ] 计算器
挑战: 尝试用不同的技术栈
任务3: 学习代码
让 Claude 解释一些开源项目的代码:
- [ ] Clone 一个 GitHub 项目
- [ ] 用 Chat 询问架构设计
- [ ] 让 Claude 解释核心模块
📚 延伸阅读
💬 下一步
恭喜完成快速入门!🎉
现在你已经:
- ✅ 掌握了基本操作
- ✅ 创建了第一个项目
- ✅ 理解了工作流程
准备好深入了解核心特点了吗?
🚀 现在就开始使用 Claude Code,体验 AI 辅助编程的乐趣!
"The best time to start was yesterday. The next best time is now."