Claude Code

一、常用指令

Claude Code 的上下文管理是核心能力，常用命令如下：

# 查看Claude Code版本号
claude --version

# 直接启动与Claude Code命令行的交互模式
claude
 
# 带初始问题启动Claude Code
claude "今天星期几？"
 
# 一次性执行并退出，单次命令模式，直接执行指令
claude -p "今天星期几？"
 
# 管道输入
cat getfile.py | claude -p "分析这段代码"
 
# 打开当前目录下的对话记录
claude --resume
 
# 继续当前目录的上一次对话
claude -c

# 跳过权限确认（提高效率）
claude --dangerously-skip-permissions

# 继续上次对话
claude --continue

Claude Code内的命令：

/compact	压缩会话历史，保留重要摘要，节省上下文空间。例如：/compact keep only the API design discussion
/clear	清空所有聊天历史与上下文
/context	查看当前上下文使用情况
/add-dir ./src/components	将目录添加到 Claude 分析范围
🔹 Tip：Claude 本身不提供持久化本次上下文的功能，可以手动导出或创建上下文文件以便后续调用。
## 以下是常用命令，建议收藏起来，便于快速查阅
/add-dir  #添加一个新的工作目录
/init     #使用代码库文档初始化一个新的CLAUDE.md文件，强烈建议使用
/clear    #清除对话历史并释放上下文，重新开始
/resume   #恢复之前的对话 ！！！！！！！
/compact  #清除对话历史记录，但保留上下文中的摘要，会话过长时压缩
/exit     #或者quite，退出REPL，退出Claude Code命令行模型
/export   #将当前对话导出到文件或剪贴板001
/mcp      #管理MCP服务器
/memory   #编辑Claude Code的记忆文件
/model    #为Claude Code设置AI模型
/vim      #在Vim模式和普通编辑模式之间切换
 
## 以下命令你可以按个人使用习惯进行整理收藏
/agents   #agent配置管理，可以创建智能体
/bashes   #列出并管理后台Bash Shell脚本
/bug      #提交关于Claude Code的反馈
/config   #打开配置面板，查看Claude Code的具体配置
/context  #查看当前上下文使用情况，并以彩色网格的形式进行可视化
/cost     #显示当前会话的总成本和持续时间
/doctor   #诊断并验证您的Claude Code安装和设置
/help     #显示帮助信息和可用命令
/hooks    #管理工具事件的钩子配置
/ide      #管理IDE集成并显示状态
/login    #切换Anthropic账户
/logout   #从您的Anthropic账户中注销
/review   #代码审查，智能分析审阅一个拉取请求
/status   #显示Claude Code状态，包括版本、模型、账户、API连接和工具状态
/upgrade  #升级至最高级别，以获得更高的速率限制和更多Opus功能
/statusline          #设置Claude Code的状态行用户界面
/output-style        #直接设置输出样式或从选择菜单中设置
/output-style:new    #创建自定义输出样式
/pr-comments         #从GitHub拉取请求中获取评论
/release-notes       #查看发布说明
/migrate-installer   #将全局npm安装迁移到本地安装
/install-github-app  #为存储库设置 Claude GitHub Actions
/security-review     #对当前分支上待处理的更改进行安全审查
/terminal-setup      #为换行安装 Shift+Enter#键绑定


## 开发时使用
/screenshot 在 macOS 系统上截取屏幕并进行智能分析

# 选择窗口截图
/screenshot --window

# 全屏截图  
/screenshot --full

# 选择范围截图
/screenshot --crop
# UI 问题分析
/screenshot --window
"分析这个界面的可用性问题"

# 错误信息诊断
/screenshot --crop  
"解释这个错误的原因和解决方案"

# 设计评估
/screenshot --full
"从 UX 角度评估整体设计"

# 技术咨询：/ask
/ask 应该选择 React 还是 Vue
/ask 微服务架构的最佳实践

错误修复：/bugfix
系统化解决代码缺陷

/bugfix 用户登录后页面白屏
/bugfix API 响应时间过长

深度调试：/debug
使用 UltraThink 模式进行系统化调试

/debug 分析系统性能瓶颈
/debug 查找内存泄漏原因

性能优化：/optimize
专业的性能优化分析和实施

/optimize 提升页面加载速度
/optimize 优化数据库查询性能

二、Claude.md

Claude.md 是项目的核心配置文件之一，它可以帮助团队规范项目结构，保持代码一致性，并且让每个开发者都能清楚地了解项目的开发规范和技术栈。通过创建结构化的 claude.md 文件，可以大大提高开发效率和代码质量。

项目根目录的 claude.md 配置示例：

# 项目概述
这是一个 React + TypeScript 的全栈 Web 应用

## 技术栈
- 前端：React 18 + TypeScript + Vite
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 开发规范
- 使用 ESLint + Prettier 保证代码风格一致性
- 组件命名：PascalCase
- 函数命名：camelCase
- 每个函数必须有 JSDoc 注释
- 所有 API 请求返回的响应都必须符合统一格式

## 文件结构
```shell
- src/components/ - React 组件
- src/api/ - API 接口
- src/utils/ - 工具函数
- public/ - 静态资源
```

通过这种结构化的配置，开发团队可以明确每个模块的职责和开发要求，减少沟通成本，提高团队协作效率。

多层级 claude.md 配置（来自 Reddit 用户 fuzz-ink）： 为了解决不同模块的具体需求，项目可以将配置文件细分，按模块或子系统分别创建 claude.md 文件，这样每个模块都有自己专属的配置文件，使得配置更加灵活和可扩展。

project/
├── claude.md              # 全局规则
├── components/
│   └── claude.md          # 组件特定规则
├── api/
│   └── claude.md          # API 特定规则
└── utils/
    └── claude.md          # 工具函数规则

每个子目录下的 claude.md 文件继承了全局规则，但也可以有自己的定制化规则，适用于该目录下的所有文件和模块。

MCP

Chrome DevTools MCP

Playwright MCP

使用注意点

1、一开始要初始化git

2、一定要先规划，大块，然后在规划每一大块里面的小块

3、一定要让AI按照一个规划文档进行开发，否则会重复，自由生成不受控制的重复模块代码

4、数据库一定要规划好，并且把他写到文档里，这个是重点：每次生成代码要让他知道已经有的数据库结构，不然他会生成新的数据库表，导致后面的业务混乱，所以开发前尽可能规划好数据库的结构

5、AI并不是万能的，需要你一开始就能统筹起来项目而不是让AI自由发挥，尽可能让AI是做补充，而你是架构设计、决策人员。这样才能用好。

Accept Edits - 自动编辑（日常用这个）

特点：AI 可以自动改文件，但运行命令还是会问

什么时候用：日常工作，信任 AI 的改动（整理文档、优化内容、批量处理等）

激活：按一次 Shift + Tab

Plan Mode - 先看计划（复杂任务用）

特点：AI 先列出完整计划，你审查后再执行

什么时候用：复杂功能，想先看清楚 AI 要做什么

激活：按两次 Shift + Tab

Bypass Permissions - 完全自动（⚠️ 危险！）

特点：AI 可以做任何事，不问你（包括删除文件！）

什么时候用：批量自动化操作（文件整理、格式转换、数据处理）

激活：启动时加 --dangerously-skip-permissions 参数

claude --dangerously-skip-permissions

如果想让 AI 帮你设置自动启动，用这个提示词：

帮我设置 Claude Code 自动以 bypass permissions 模式启动。
当我输入 claude 时，自动执行 claude --dangerously-skip-permissions

注意，在 Mac 中粘贴图片不是使用 command + v，而是使用 ctrl + v 快捷键

使用 /init 命令快速上手

从零创建 CLAUDE.md 可能会让人望而却步，尤其是在面对一个不熟悉的代码库时。

而 /init 命令能自动完成这一过程 —— 它会分析你的项目，生成一份初始配置。

在任意 Claude Code 会话中运行以下命令：

cd your-project
claude
/init

Claude Code 能自动扫描你的整个代码库，读取包管理文件、已有的项目文档、各类配置文件以及代码目录结构，然后根据你的项目情况自动生成一份初版 CLAUDE.md。生成内容通常包含构建/运行命令、测试说明、关键目录以及能从代码中推断出的编码规范。

即使你的项目里已经有现成的 CLAUDE.md 了，也能使用 /init 命令。这种情况下，Claude Code 会对比现有文件和代码库的最新变化，给出针对性的优化建议。

/init 之后，下一步做什么？

  • 检查准确性：确保所有推断出的信息都是正确的。
  • 补充“潜规则”：加入 Claude Code 无法推断的工作流，比如分支命名规范、部署流程、代码审查的具体要求等。
  • 精简内容：删掉那些不适合当前项目的通用指导内容。
  • 纳入版本控制：把最终版文件提交到版本控制系统里，方便团队成员共享使用。

其实 /init 命令的核心作用就是快速搭好基础框架，CLAUDE.md 的真正价值在于后续的持续迭代完善。在日常使用 Claude Code 时，用 # 键记录下那些重复性的操作指南，慢慢把这份文件打磨成能精准匹配团队运作模式的专属配置。

如何构建一份真正高效的 CLAUDE.md

接下来的内容，会手把手教你如何打磨这份文件，让它成为你的得力助手。我们将聚焦于几个核心场景：如何帮助它理解复杂架构、跟踪多步骤任务、集成自定义工具，以及通过统一流程减少重复沟通。

为 Claude Code 提供“项目地图”

在日常开发中，最耗时的往往不是写代码，而是反复解释项目架构、模块依赖、关键库、编码风格等背景信息。要让 Claude Code 长期、稳定地理解你的代码库，就需要把这些基础上下文写进 CLAUDE.md，让它无需每次都从零开始。

最基础也最重要的内容，是项目的总体概览和目录结构。

你可以在 CLAUDE.md 中加入简洁的项目说明和一份结构清晰的目录树，帮助 Claude Code 快速建立认知模型，知道关键模块分别放在哪里。例如：

main.py
├── logs
│   ├── application.log
├── modules
│   ├── cli.py
│   ├── logging_utils.py
│   ├── media_handler.py
│   ├── player.py

在项目地图中，你可以进一步加入主要依赖、架构模式以及任何“非标准”的组织方式。如果项目采用了 DDD、微服务拆分，或使用了某些特定框架，也可以在这里说明。这样 Claude Code 能更准确地判断代码属于哪一层、修改应该落在哪里，不会误入无关模块。

把 Claude Code 接入你的运行环境

Claude Code 会继承你的开发环境，但它并不知道“哪些工具该用、怎么用”。这个时候就需要你在 CLAUDE.md 中明确告诉它。

如果团队里有部署脚本、测试脚本、代码生成器、数据处理脚本等常用工具，都可以写在 CLAUDE.md 中。建议包含以下信息：

  • 工具名称与用途
  • 基础使用方法（命令格式、关键参数）
  • 典型调用场景
  • 是否支持 --help 获取帮助文档

只要你把这些说明补充完整，Claude Code 就可以在任务中正确调用这些工具。对于较复杂的内部工具，建议再补充团队最常用的几条“高频用法”。

Claude Code 还内置了 MCP（Model Context Protocol）客户端，可以连接外部 MCP 服务器，从而使用更多扩展能力。

你可以通过以下方式配置 MCP：

  • 项目设置
  • 全局设置
  • 仓库中的 .mcp.json 文件

如果某个 MCP 工具没有正常显示，可以用 --mcp-debug 排查异常。

举个例子，若你的团队已配置 Slack MCP 服务器，而你希望 Claude Code 在对话中能直接调用 Slack 工具，可在 CLAUDE.md 中添加如下内容：

### Slack MCP
- Posts to #dev-notifications channel only
- Use for deployment notifications and build failures
- Do not use for individual PR updates (those go through GitHub webhooks)
- Rate limited to 10 messages per hour

定义标准工作流

要是让 Claude Code 没个明确规划就直接改代码，大概率会白忙活一场。它给的方案可能漏了需求点，或者用错了架构思路，更糟的还会搞崩现有功能，最后只能返工。

关键是得让 Claude Code 动手前先 “想清楚”。所以一定要在 CLAUDE.md 里针对不同类型的任务定好标准工作流，让它照着执行。一套完善的默认工作流，核心是动手修改前先把四个问题捋明白：

  1. 这个问题是不是得先调研一下，摸清当前的代码现状才能动手？
  2. 动手写代码前，要不要先搭个详细的实现方案？
  3. 现在手里的信息够不够？还缺哪些关键内容没明确？
  4. 做完之后怎么验证？怎么确保方案是有效的？

工作流可以根据任务类型灵活定制：

  • 功能开发：可遵循“调研-规划-编码-提交”的流程。
  • 算法开发：更适合采用“测试驱动开发”（TDD）模式。
  • UI 迭代：则可遵循“视觉原型迭代”的流程。

同时，也请在文档中明确测试要求、提交信息规范以及各类审批流程。当 Claude Code 预先掌握了这些工作流，它就能主动地与团队的实际节奏保持一致，而不是凭感觉行事。

以下是一个工作流指令的示例：

1) Before modifying Code  in the following locations: X, Y, Z
        - Consider how it might affect A, B, C
        - Construct an implementation plan
        - Develop a test plan that will validate the following functions...

从简入手，逐步完善

很多人一开始就想把 CLAUDE.md 做得面面俱到，结果既冗长又难维护。由于 CLAUDE.md 会在每次对话前被载入上下文，保持简洁并按需拆分更有效。实用做法：

  • 先只写最关键的内容：项目结构、构建/运行命令、常用脚本示例。
  • 把辅助信息拆成独立的 Markdown 文件（例如：testing.md、deploy.md、.claude/commands/*），并在 CLAUDE.md 中引用它们。
  • 随着使用过程中的痛点逐步补充内容——让文件随着团队实践自然成长，而不是一次性塞满所有想法。

CLAUDE.md 会成为 Claude Code 的系统上下文，且通常会提交到仓库与团队共享。切勿把任何敏感凭证写进文件，包括但不限于 API Key、数据库连接字符串、私有证书或详细的安全漏洞信息。把它当成可能公开的文档来写。

让 CLAUDE.md 真正解决问题

CLAUDE.md 文件的核心价值，就是将 Claude Code 从一个通用助手，转变为你代码库的“定制版”工具。

从简单开始，逐步演进。 先用基本的项目结构和构建信息打基础，然后根据实际工作流中遇到的痛点，不断丰富它的内容。它应该能做到：

  • 把你经常重复输入的命令、检查点和上下文“固化”下来；
  • 捕捉那些需要十分钟口述才能讲清的架构与约定；
  • 明确工作流，让 Claude Code 在动手前按团队流程思考，减少返工。

很多人会把CLAUDE.md当成“配置完就不管”的文件，但它的真正价值恰恰在于“持续进化”。软件项目从来不是静止的：业务迭代会新增模块，团队磨合会沉淀更高效的协作模式，新工具（比如引入ESLint新规则、改用Docker部署）也会融入工作流——这些变化都需要同步更新到CLAUDE.md中。

一句话总结：好的CLAUDE.md，不是“写出来”的，而是“用出来”的。它不需要完美的格式，只需要解决真问题；不需要追随理论，只需要贴合你的团队——最终和你的代码库一起，成为项目成长的一部分。