上一篇【第07篇】Cursor完全上手指南——地表最强AI IDE的正确打开方式
下一篇【第09篇】Windsurf与GitHub Copilot——AI编程工具的生态战争


摘要

如果说Cursor是"带AI的IDE",那么Claude Code就是"带IDE的AI"——它不依赖图形界面,而是在终端中用最纯粹的方式实现Vibe Coding。CLAUDE.md让你定义"AI应该知道的一切",Memory系统让AI记住跨会话的偏好,Skills让你安装"AI的能力扩展包"。本文用完整的配置示例和实战场景,带你掌握这个"终端里的AI开发者"。


一、Claude Code是什么?——终端AI编程的新范式

1.1 先理解定位差异

【Claude Code vs Cursor的本质差异】

              Cursor                    Claude Code
形态          GUI IDE                   CLI 终端工具
运行方式      图形界面                   命令行(或WorkBuddy内置)
交互方式      鼠标+键盘                  纯文本对话
编辑方式      AI内嵌在编辑器中            AI直接读写文件
项目理解      Codebase Indexing          Memory + Rules + Index
生态扩展      MCP协议                    Skills + MCP
学习曲线      低(类VS Code体验)         中(需要命令行习惯)
适用场景      UI开发、前端、全栈          CLI开发、后端、自动化

一句话总结:
Cursor = 在IDE中使用AI
Claude Code = AI本身就是一个开发者,它通过终端操作一切

1.2 Claude Code的独特优势

【Claude Code的五大独特优势】

1. 终端原生
   ├── 不需要开IDE就能开发
   ├── SSH到远程服务器也能用
   ├── CI/CD流水线中可以集成
   └── 适合微服务/容器化开发

2. Memory系统
   ├── Cloud Memory:长期偏好(跨所有项目)
   ├── Workspace Memory:项目级记忆(每日日志+经验沉淀)
   └── 三层记忆:让AI像真正的团队成员一样"记住"

3. Skills系统
   ├── 可安装的能力扩展包(PDF处理、Excel操作、PPT生成)
   ├── 社区市场:大量预置Skills
   └── 自定义Skills:封装你的专属工作流

4. 无界面限制
   ├── 编辑器不受限(可以用自己最喜欢的编辑器)
   ├── 终端命令无沙箱限制
   └── 并行处理能力强

5. Agent原生
   ├── 自主启动多个子Agent并行工作
   ├── 任务分解与编排
   └── 真正的"AI团队"模式

二、安装与初始化

2.1 基础配置

【Claude Code安装步骤】

方式1:通过WorkBuddy Desktop(推荐)
  Claude Code内置于WorkBuddy,开箱即用

方式2:通过npm安装
  npm install -g @anthropic-ai/claude-code
  claude login  # 登录Anthropic账号

方式3:在项目中使用
  cd your-project/
  claude        # 在项目目录启动
                # 自动检测package.json、.git等

2.2 项目初始化——/init命令

/init是Claude Code最重要的命令之一,它会在项目根目录创建CLAUDE.md文件:

【/init 生成的项目记忆】

$ claude
> /init

Claude Code分析项目结构后生成:

# CLAUDE.md

## 项目概览
- 名称:user-management-system
- 类型:NestJS后端服务
- 主要语言:TypeScript

## 技术栈
- 框架:NestJS 10.x
- ORM:Prisma 5.x
- 数据库:PostgreSQL 15
- 测试:Vitest + Supertest

## 目录结构
- src/modules/ - 业务模块
- src/shared/ - 公共工具
- prisma/ - 数据库Schema
- test/ - 测试文件

## 常用命令
- pnpm dev - 启动开发服务器
- pnpm test - 运行测试
- pnpm prisma migrate dev - 数据库迁移
- pnpm lint - 代码检查

## 编码约定
- 使用严格TypeScript模式
- 每个模块有独立的 controller/service/repository
- 错误统一使用自定义异常类
- API响应格式:{ code, data, message }

三、核心命令体系

3.1 六大致命命令

【Claude Code核心命令】

/clarify   → 澄清需求
┌──────────────────────────────────────┐
│ 当你描述的需求不够清晰时,AI会主动提问    │
│                                      │
│ 示例:                                │
│ > /clarify 加一个导出功能               │
│ AI:                                  │
│ "为了帮你实现导出功能,我需要确认:       │
│  1. 导出什么数据?用户列表还是订单?      │
│  2. 导出格式?CSV、Excel还是PDF?       │
│  3. 是否需要筛选条件?                  │
│  4. 文件命名规则是什么?"               │
└──────────────────────────────────────┘

/init      → 初始化项目记忆
┌──────────────────────────────────────┐
│ 自动分析项目结构,生成CLAUDE.md         │
│ 也接受自定义模板                       │
│                                      │
│ > /init --template nestjs            │
│ # 使用NestJS模板初始化                │
└──────────────────────────────────────┘

/review    → 代码审查
┌──────────────────────────────────────┐
│ 审查当前变更,给出改进建议                │
│                                      │
│ > /review                             │
│ AI:[分析git diff]                    │
│ "审查结果:                            │
│  1. user.service.ts:42 - 缺少空值检查  │
│  2. user.controller.ts:18 - API路径    │
│     建议改为 /api/v1/users            │
│  3. 整体评价:代码质量良好,建议补充     │
│     单元测试"                          │
└──────────────────────────────────────┘

/test      → 生成测试
┌──────────────────────────────────────┐
│ 为指定模块生成测试用例                   │
│                                      │
│ > /test src/modules/user/            │
│ AI:[生成 user.service.test.ts]      │
│ "已生成28个测试用例,覆盖率85%           │
│  运行 pnpm test 验证"                  │
└──────────────────────────────────────┘

/fix       → 修复问题
┌──────────────────────────────────────┐
│ 自动修复lint错误、类型错误、测试失败      │
│                                      │
│ > /fix                                │
│ AI:[分析所有lint/类型错误]            │
│ "发现3个问题,正在修复:                 │
│  1. ✅ 修复未使用的import              │
│  2. ✅ 修复缺少的返回类型               │
│  3. ✅ 修复async函数缺少await          │
│  所有问题已修复"                        │
└──────────────────────────────────────┘

/architect → 架构设计
┌──────────────────────────────────────┐
│ 讨论和设计系统架构                       │
│                                      │
│ > /architect 设计一个支持多租户的CMS架构 │
│ AI:[输出架构图 + 技术选型 + 模块划分    │
│      + 数据流设计]                    │
└──────────────────────────────────────┘

四、CLAUDE.md——项目记忆文件的正确写法

4.1 CLAUDE.md是Claude Code的灵魂

【CLAUDE.md的作用域】

你的项目                    AI的"知识库"

src/                        CLAUDE.md
├── modules/                  ├── 技术栈是什么?
├── shared/                   ├── 目录结构约定?
├── prisma/                   ├── 编码规范?
├── tests/                    ├── 常用命令?
└── CLAUDE.md ← 入口          └── 项目特有的约定?

每次对话开始时,Claude Code自动读取CLAUDE.md
→ AI不需要每次都问"这个项目用的是什么框架?"

4.2 进阶:CLAUDE.md的完整模板

【企业级CLAUDE.md模板】

# 项目名:TradePlatform

## 项目简介
面向B端客户的交易管理平台,支持多商户、多币种、多渠道。

## 核心业务规则
- 用户状态流转:pending → active → verified → suspended
- 订单状态:created → paid → shipped → completed → [refunded]
- 金额计算:全部以分为单位存储,前端转换
- 时区:统一使用UTC,前端展示时转换

## 技术架构

Frontend (React 18) ←→ API Gateway (Kong) ←→ Backend (NestJS)
↕ ↕ ↕
Zustand Redis PostgreSQL


## API设计规范
- 路径:/api/v1/{resource}
- 分页:{ page: 1, pageSize: 20, total, items }
- 错误响应:{ code: string, message: string, details?: any }
- 认证:JWT Bearer Token,过期时间2小时
- 幂等性:写操作使用idempotency-key header

## 数据库约定
- 所有表必须有:id(UUID v4)、createdAt、updatedAt
- 软删除:deletedAt字段(null = 未删除)
- 外键命名:{referenced_table}_id
- 不直接使用数据库枚举,用字符串+应用层校验

## 代码组织
- 每个业务模块放在 src/modules/{module_name}/
- 模块内部结构:controller → service → repository
- 跨模块调用:通过service接口,不直接访问repository
- 公共逻辑:抽取到 src/shared/

## 测试策略
- 单元测试:所有service和util函数
- 集成测试:所有API接口
- E2E测试:核心业务流程
- 覆盖率要求:>80%

## Git工作流
- 主分支:main(保护分支)
- 开发分支:develop
- 功能分支:feature/TICKET-123-description
- PR要求:通过CI + 至少1人审核

五、Skills系统——AI的"能力扩展包"

5.1 Skills的工作原理

【Skills体系架构】

Claude Code
    │
    ├── 内置能力
    │   ├── 代码生成
    │   ├── 文件操作
    │   └── 终端命令
    │
    └── Skills扩展
        ├── User-level Skills (~/.workbuddy/skills/)
        │   ├── pdf(PDF文档处理)
        │   ├── xlsx(Excel表格处理)
        │   ├── pptx(演示文稿生成)
        │   └── ...
        │
        └── Project-level Skills (.workbuddy/skills/)
            ├── deploy-to-staging
            ├── run-migration
            └── code-style-check

5.2 常用Skills速览

【高效开发Skills精选】

文档类:
├── pdf:阅读、创建、合并、拆分PDF
├── docx:Word文档的创建与编辑
├── xlsx:Excel表格处理(数据导入导出)
└── pptx:PPT演示文稿生成

工具类:
├── github:GitHub操作(PR、Issue、Actions)
├── tencent-docs:腾讯文档操作
├── lexiang:乐享知识库管理
└── wechat-miniprogram:微信小程序开发

开发类:
├── playwright-cli:浏览器自动化测试
├── cloudstudio-deploy:一键云部署
└── es-setup:Elasticsearch配置

六、Claude Code vs Cursor——如何搭配使用?

6.1 不是"二选一",而是"1+1>2"

【Claude Code + Cursor 协作工作流】

           Cursor                      Claude Code
       (写代码 + 调试)              (架构 + 自动化 + 审查)

开发阶段:
需求分析    ❌ 不擅长              ✅ /architect 架构设计
技术选型    ❌ 不擅长              ✅ /clarify 深入讨论
项目初始化  ✅ 手动创建             ✅ 自动分析 + 推荐
编码        ✅ 最佳体验             ⚠️ 可用但无GUI
调试        ✅ 断点调试、日志       ⚠️ CLI调试体验一般
测试生成    ✅ Cmd+K              ✅ /test 批量生成
代码审查    ⚠️ 基本审查            ✅ /review 深度审查
自动化      ⚠️ Agent模式           ✅ 原生Agent + SKILLS
部署        ❌ 需要额外配置         ✅ Skills一键部署

推荐工作流:
1. Claude Code做架构设计和技术选型
2. Cursor完成编码(Tab + Cmd+K + Composer)
3. Claude Code做代码审查和测试生成
4. Claude Code完成部署和文档生成

6.2 典型的一天工作流

【Vibe Coder的日常(Cursor + Claude Code)】

09:00  Claude Code
       > 今天需要做什么?
       AI:回顾昨天的Daily Log,列出待办事项

09:30  Claude Code
       > /architect 新功能的技术方案
       AI输出架构设计 + 影响分析

10:00  Cursor
       根据架构设计开始编码(Composer + Cmd+K)

12:00  Cursor
       手动调试,修复小bug

14:00  Claude Code
       > /review 审查上午写的代码
       AI进行代码审查,提出改进建议

14:30  Claude Code
       > /test 生成测试用例
       > /fix 修复lint和类型错误

15:00  Claude Code Agent
       > 运行所有测试,如果失败自动修复
       AI自主运行测试 → 分析失败原因 → 修复 → 重测

16:00  Claude Code
       > /commit 生成提交信息和PR描述
       AI自动分析diff,生成规范的commit

16:30  Claude Code
       > 更新项目文档
       AI根据代码变更更新README和API文档

总结

  1. Claude Code是终端AI编程的标杆:不依赖GUI,无界面限制,天然适合自动化、CI/CD集成、远程开发等场景。
  2. CLAUDE.md是Claude Code的灵魂:一份详尽的CLAUDE.md可以替代无数次重复的解释,是Context Engineering在Claude Code中的核心实现。
  3. Memory系统让AI真正"记住":三层记忆(Cloud + Workspace + Daily Log)使Claude Code能像团队老成员一样了解项目历史。
  4. Skills让AI能力无限扩展:通过社区市场和自定义Skills,Claude Code可以从"代码助手"升级为"全能开发者"。
  5. Cursor + Claude Code是最佳组合:Cursor负责编码体验,Claude Code负责架构、审查、测试和自动化,两者互补而非替代。

上一篇【第07篇】Cursor完全上手指南——地表最强AI IDE的正确打开方式
下一篇【第09篇】Windsurf与GitHub Copilot——AI编程工具的生态战争


Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐