Claude code使用笔记 一、常见指令类型可以把对 Claude Code 的指令分为三类解释型解释这段代码 这个函数为什么这么写修改型帮我重构这个函数 拆分成多个小函数生成型补一个测试用例 增加日志输出一个简单但好用的指令模板在不改变现有行为的前提下 帮我优化 XXX 文件的可读性 并说明你做了哪些修改。二、基本操作在提示框里输入 /或点击输入框就能打开命令菜单。使用 /init 命令来初始化项目# Claude 会自动扫描你的代码库——读取 package.json、现有文档、配置文件以及代码结构# 然后生成一份专属于你项目的 CLAUDE.md 文件。# Claude 整个过程无需手动操作Claude 会自行分析并输出初始配置。# CLAUDE.md 是一个放在项目根目录的 Markdown 文件Claude Code 在每次会话开始时都会自动读取。常用斜杠命令速查表在 Claude Code 的对话框中以 / 开头的是内置命令不会发送给模型。命令作用/status查看当前模型、Base URL、会话统计/help显示所有可用命令/clear清除当前对话上下文不删除文件/exit 或 CtrlC或 CtrlC 退出 Claude Code/undo撤销上一次文件修改/diff查看最近一次修改的 git diff三、Claude Code使用实例项目目标我们要搭建一个具备以下功能的 REST API接口功能GET /todos获取所有待办事项POST /todos创建新待办事项PUT /todos/:id更新待办事项标记完成/修改内容DELETE /todos/:id删除待办事项技术栈Node.js Express数据暂存于内存不需要数据库降低复杂度。步骤 1用自然语言描述需求在 Claude Code 的对话框中输入以下内容直接复制粘贴即可请帮我从零创建一个 Node.jsExpress 的 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步骤 2Claude Code 生成文件结构步骤 3审查并确认修改步骤 4安装依赖并启动服务在 Claude Code 对话框中输入请帮我安装依赖并启动项目然后告诉我怎么用 curl 测试每个接口测试命令新开一个终端窗口依次运行以下 curl 命令# 创建第一条 Todo$ curl-X POST http://localhost:3000/todos \-HContent-Type: application/json\-d{title: 学习 Claude Code}# 创建第二条 Todo$ curl-X POST http://localhost:3000/todos \-HContent-Type: application/json\-d{title: 完成 DeepSeek 配置}# 获取所有 Todos$ curl http://localhost:3000/todos# 把第一条标记为完成$ curl-X PUT http://localhost:3000/todos/1\-HContent-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 支持 ?completedtrue/false 的查询参数过滤-GET/todos 支持 ?sortcreatedAtorderdesc 的排序参数-同时更新 README.md 里的接口文档CLAUDE.md 写法模板基本内容包括项目概述、技术栈、目录结构、命名规范和重要约定。# 项目说明CLAUDE.md## 项目概述这是一个 Node.jsExpress 的 Todo REST API 项目。 当前阶段数据存在内存中下一步会迁移到 SQLite。## 技术栈-运行时Node.js18-框架Express4.x-测试暂无后续加 Jest-代码风格ESLintPrettier配置见.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 的维护节奏时机要做的事引入新依赖更新「技术栈」部分修改文件结构更新「目录结构」部分制定新的编码规范追加到「重要约定」发现 AI 反复犯同一个错加入「禁止事项」