文思AI产品笔记
首页
最新文章
AI编程
AI架构
关于我
  • AI生态圈
  • AI大模型
  • 多维表格
  • AI创业笔记
  • AI落地案例
  • 个人产品推介
  • 问题集
  • 简体中文
  • English
首页
最新文章
AI编程
AI架构
关于我
  • AI生态圈
  • AI大模型
  • 多维表格
  • AI创业笔记
  • AI落地案例
  • 个人产品推介
  • 问题集
  • 简体中文
  • English
  • Claude Code 教程

    • Claude Code 从入门到精通
    • 01 - 快速入门
    • 02 - 核心特点
    • 03 - 版本演进史
    • 04 - 架构深入解析
    • 05 - Claude Skills 详解
    • 06 - MCP 协议完全指南
    • 07 - 高级功能全解
    • 08 - 最佳实践
    • 09 - 使用诀窍与技巧
    • 10 - 配置优化指南

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 后:

  1. 按 Cmd/Ctrl + Shift + P 打开命令面板
  2. 输入 "Settings"
  3. 选择 "Cursor Settings"
  4. 选择模型:
推荐配置:
- 主模型: Claude 3.5 Sonnet (最强)
- 快速模型: Claude 3 Haiku (省额度)

2.2 设置 API Key(可选)

免费额度(内置):

  • 每月 500 次请求
  • 适合轻度使用

自定义 API Key:

Settings → Cursor → API Keys → Add Claude API Key

获取 API Key:

  1. 访问 https://console.anthropic.com
  2. 注册账号
  3. 创建 API Key
  4. 复制并粘贴到 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 中:

  1. File → Open Folder
  2. 选择或创建文件夹 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 模式)

  1. 打开 src/App.tsx
  2. 按 Cmd/Ctrl + K
  3. 输入 Prompt:
实现 Todo App 的核心逻辑:
- 状态管理使用 useState
- 支持添加、删除、切换完成状态
- 数据持久化到 localStorage
- 添加优雅的动画效果

Claude 会直接在文件中生成代码!


2.2 多文件编辑

想要同时修改多个相关文件?

  1. 在 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 + KInline Edit快速修改当前文件
Cmd/Ctrl + IComposer多文件项目级操作
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: 生成的代码有错误

不要慌!这很正常

  1. 告诉 Claude 哪里有问题
  2. 粘贴错误信息
  3. 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 解释核心模块

📚 延伸阅读

  • 02 - 核心特点 - 深入了解 Claude 的强大能力
  • 09 - 使用诀窍 - 更多实用技巧
  • 官方文档

💬 下一步

恭喜完成快速入门!🎉

现在你已经:

  • ✅ 掌握了基本操作
  • ✅ 创建了第一个项目
  • ✅ 理解了工作流程

准备好深入了解核心特点了吗?

👉 继续学习:02 - 核心特点


🚀 现在就开始使用 Claude Code,体验 AI 辅助编程的乐趣!

"The best time to start was yesterday. The next best time is now."

最近更新: 2025/12/22 14:25
Contributors: wsyx
Prev
Claude Code 从入门到精通
Next
02 - 核心特点