Claude code使用笔记

一、常见指令类型

可以把对 Claude Code 的指令分为三类：

1. 解释型

   解释这段代码 这个函数为什么这么写

2. 修改型

   帮我重构这个函数 拆分成多个小函数

3. 生成型

   补一个测试用例 增加日志输出

• 一个简单但好用的指令模板：

  在不改变现有行为的前提下， 帮我优化 XXX 文件的可读性， 并说明你做了哪些修改。

二、基本操作

• 在提示框里输入 /（或点击输入框）就能打开命令菜单。
• 使用 /init 命令来初始化项目：

# Claude 会自动扫描你的代码库——读取 package.json、现有文档、配置文件以及代码结构，# 然后生成一份专属于你项目的 CLAUDE.md 文件。# Claude 整个过程无需手动操作，Claude 会自行分析并输出初始配置。# CLAUDE.md 是一个放在项目根目录的 Markdown 文件，Claude Code 在每次会话开始时都会自动读取。

• 常用斜杠命令速查表

在 Claude Code 的对话框中，以 / 开头的是内置命令，不会发送给模型。

三、Claude Code使用实例

项目目标
我们要搭建一个具备以下功能的 REST API：

技术栈：Node.js + Express，数据暂存于内存（不需要数据库，降低复杂度）。

• 步骤 1：用自然语言描述需求

在 Claude Code 的对话框中输入以下内容（直接复制粘贴即可）：

请帮我从零创建一个 Node.js+Express 的 Todo REST API 项目。 要求：-支持 GET/todos、POST/todos、PUT/todos/:id、DELETE/todos/:id四个接口-数据先存在内存数组里，不需要数据库-每个 todo 包含：id、title、completed（布尔值）、createdAt 字段-请求和响应都使用 JSON 格式-加上基础的错误处理（404、400等）-生成一份 README.md，说明如何启动和测试接口 项目结构建议： my-todo-api/├── src/│ ├── index.js# 入口文件│ └── routes/│ └── todos.js# Todo 路由├── package.json └── README.md

• 步骤 2：Claude Code 生成文件结构
• 步骤 3：审查并确认修改
• 步骤 4：安装依赖并启动服务
  在 Claude Code 对话框中输入：

请帮我安装依赖并启动项目，然后告诉我怎么用 curl 测试每个接口

• 测试命令

新开一个终端窗口，依次运行以下 curl 命令：

# 创建第一条 Todo$ curl-X POST http://localhost:3000/todos \-H"Content-Type: application/json"\-d'{"title": "学习 Claude Code"}'# 创建第二条 Todo$ curl-X POST http://localhost:3000/todos \-H"Content-Type: application/json"\-d'{"title": "完成 DeepSeek 配置"}'# 获取所有 Todos$ curl http://localhost:3000/todos# 把第一条标记为完成$ curl-X PUT http://localhost:3000/todos/1\-H"Content-Type: application/json"\-d'{"completed": true}'# 删除第二条$ curl-X DELETE http://localhost:3000/todos/2# 再次查看列表，确认删除成功$ curl http://localhost:3000/todos

预期输出（GET /todos 最终结果）

[{"id":1,"title":"学习 Claude Code","completed":true,"createdAt":"2026-05-20T10:30:00.000Z"}]

• 进阶挑战：让 Claude Code 帮你加新功能
  API 跑通之后，试着用自然语言让 Claude Code 扩展功能：

请给 Todo API 加上以下功能：-GET/todos 支持 ?completed=true/false 的查询参数过滤-GET/todos 支持 ?sort=createdAt&order=desc 的排序参数-同时更新 README.md 里的接口文档

• CLAUDE.md 写法模板：基本内容包括项目概述、技术栈、目录结构、命名规范和重要约定。

# 项目说明（CLAUDE.md）## 项目概述这是一个 Node.js+Express 的 Todo REST API 项目。 当前阶段：数据存在内存中，下一步会迁移到 SQLite。## 技术栈-运行时：Node.js18+-框架：Express4.x-测试：（暂无，后续加 Jest）-代码风格：ESLint+Prettier（配置见.eslintrc）## 目录结构src/├── index.js# 入口，只做 app 配置和监听└── routes/└── todos.js# Todo 业务逻辑全在这里## 命名规范-文件名：kebab-case（如 todo-service.js）-变量/函数：camelCase-常量：UPPER_SNAKE_CASE-路由文件按资源名命名（如 users.js、products.js）## 重要约定-所有接口返回 JSON，错误统一格式：{"error":"错误描述"}-HTTP 状态码语义要准确：创建成功用201，删除成功用204-禁止在路由文件里直接操作数据库（现在是内存数组，将来是 DB）-每个路由文件只处理一种资源## 禁止事项-不要用 var，只用 const/let-不要用回调风格，统一用async/await-不要在代码里写中文注释（英文注释即可）-不要安装 lodash，原生 JS 方法够用## 启动方式npm start# 生产模式npm run dev# 开发模式（nodemon 热重载）## 测试接口见 README.md 的 curl 示例

• CLAUDE.md 的维护节奏