1963 字
10 分钟
我的ClaudeCode使用笔记
最近正式在一些项目开始使用ClaudeCode,记录一些使用笔记。
ClaudeCode使用笔记
或者前往这里
🧭ClaudeCode官方文档
有空更建议研究ClaudeCode官方文档
🔥 重要指令
| 命令 | 功能 | 代码特殊示例 |
|---|---|---|
| /mcp | 管理 MCP 服务器连接与调试,查看可用服务、状态与权限 | /mcp list 或 /mcp status |
| /init | 生成CLAUDE.md;作为项目知识,每次对应项目对话都附带,是AI了解项目的基石《项目提示词》 | 无 |
| /compact | 压缩对话上下文,更节省Token消耗;可以附加提示词选择更侧重哪一方面(增加注意力) | /compact 主要保留前端部分对话 |
| /clear | 用于清除对话记录 | 无 |
| think/thinkhard/thinkharder/ultrathink | 这四个级别的提示词代表用于AI对问题的的思考程度 | think “你的需求” |
| ! | 进入临时命令行模式,同时操作也可以被AI感知 | ! npm install 安装依赖并通知AI |
| # | 长期记忆模式,给项目或我们用户级别添加要Claude知道的东西(附加于CLAUDE.md文件下)用户级别的位于C/User/用户名/.claude文件夹下 | # 用中文与我对话 |
| /ide | 开启ide集成(非常方便,注意要下载对应的插件)使用后,以VSCode举例,接近于VSCode原生Github Copilot下的Agent模式体验 | 无 |
| claude -p “问题” | 临时一次性对话,类似于一次性的Olllma本地模型 | |
| Esc*2/ /rewind | claudecode2.0新增的检查点功能,回退代码! | 无 |
📝 常用命令参考
基础命令
| 命令 | 功能 | 示例 |
|---|---|---|
| claude | 启动交互模式 | claude |
| claude “task” | 运行一次性任务 | claude “fix the build error” |
| claude -p “query” | 运行查询后退出 | claude -p “explain this function” |
| claude -c | 继续最近的对话 | claude -c |
| claude -r | 继续上一个对话 | claude -r |
| claude commit | 创建 Git 提交(个人不常用) | claude commit |
交互模式命令
| 命令 | 功能 |
|---|---|
| /clear | 清除对话历史记录 |
| /help | 获取帮助信息 |
| exit 或 Ctrl+C | 退出 Claude Code |
内置斜杠命令
| 命令 | 用途 |
|---|---|
| /ide | 重要 绑定 IDE 并启用选择、诊断、差异等上下文同步 |
| /add-dir | 添加额外的工作目录 |
| /bug | 报告错误 |
| /clear | 清除对话历史 |
| /config | 查看/修改配置 |
| /cost | 显示令牌使用统计 |
| /doctor | 检查安装健康状况 |
| /help | 获取使用帮助 |
| /init | 使用 CLAUDE.md 初始化项目 |
| /memory | 编辑 CLAUDE.md 内存文件 |
| /model | 选择或更改 AI 模型 |
| /permissions | 查看或更新权限(Allow始终允许、Deny禁止使用、Workspace是项目始终允许) |
| /review | 请求代码审查 |
| /status | 查看账户和系统状态 |
| /vim | 进入 vim 模式 |
| /resume | 找回历史话题(仅回退对话记录,无代码) |
| /export | 将此次对话内容导出(粘贴板/文件) |
🧩 MCP 模块
MCP 工具与权限
| 工具 | 描述 | 需要权限 |
|---|---|---|
| Bash | 在您的环境中执行 shell 命令 | 是 |
| Edit | 对特定文件进行有针对性的编辑 | 是 |
| Glob | 基于模式匹配查找文件 | 否 |
| Grep | 在文件内容中搜索模式 | 否 |
| MultiEdit | 对单个文件原子性地执行多个编辑 | 是 |
| NotebookEdit | 修改 Jupyter notebook 单元格 | 是 |
| NotebookRead | 读取和显示 Jupyter notebook 内容 | 否 |
| Read | 读取文件内容 | 否 |
| Task | 运行子代理来处理复杂的多步骤任务 | 否 |
| TodoWrite | 创建和管理结构化任务列表 | 否 |
| WebFetch | 从指定 URL 获取内容 | 是 |
| WebSearch | 执行带有域过滤的网络搜索 | 是 |
| Write | 创建或覆盖文件 | 是 |
参考命令
| 命令 | 功能 | 示例 |
|---|---|---|
| claude mcp add “mcp名称,建议与MCP相同” | 增加MCP | claude mcp add context7 — npx @upstash/context7-mcp |
| 这个就是按照文档里的来,结构为 | ||
| claude mcp add MCP名称 — “command” + “args” | ||
| — scope user | 添加为用户级别的MCP | 就是在上文的MCP名称后添加 |
| 示例:claude mcp add context7 —scope user — npx @upstash/context7-mcp | ||
| /mcp | 查看mcp服务器 | 无 |
| claude mcp remove MCP名称 | 删除该MCP服务器 | claude mcp remove context7 |
| /permissions进入后选择Allow后mcp__MCP名称 | 位于Allow下面的工具/MCP无需确认,自动使用 | mcp__ context7 |
| claude —dangerously-skip-permissions | 赋予最高权限 | 无 |
远程连接MCP视MCP文档命令即可
🔧工具与权限
| 工具 | 描述 | 需要权限 |
|---|---|---|
| Bash | 在您的环境中执行 shell 命令 | 是 |
| Edit | 对特定文件进行有针对性的编辑 | 是 |
| Glob | 基于模式匹配查找文件 | 否 |
| Grep | 在文件内容中搜索模式 | 否 |
| MultiEdit | 对单个文件原子性地执行多个编辑 | 是 |
| NotebookEdit | 修改 Jupyter notebook 单元格 | 是 |
| NotebookRead | 读取和显示 Jupyter notebook 内容 | 否 |
| Read | 读取文件内容 | 否 |
| Task | 运行子代理来处理复杂的多步骤任务 | 否 |
| TodoWrite | 创建和管理结构化任务列表 | 否 |
| WebFetch | 从指定 URL 获取内容 | 是 |
| WebSearch | 执行带有域过滤的网络搜索 | 是 |
| Write | 创建或覆盖文件 | 是 |
⚡自定义命令
1.项目自建自定义命令
项目文件的.claude文件夹下新建commands文件夹后,新建的.md文件名字即为命令名字
例如有一个code_review.md文件,内容为:对比当前这个分支与main分支的差异,提出你的review意见,并且生成应用过后的更新文件;或者是 对比这个分支:$ARGUMENTS与main分支的差异,提出你的review意见,并且生成应用过后的更新文件
($ARGUMENTS 为占位符,可作为分支名称(变量)传入)
使用方法为/命令名字 传入参数(可选)
2.用户级别自定义命令
将commands文件夹移动至C/User/用户名/.claude文件夹下即可(前文的CLAUDE.md同位置)
📞Hook(自动执行)
1.项目建立Hook
.claude文件夹下建立setting.json或·setting.local.json(更高权限)
例如以下这个自动修复 markdown 文件中缺失的语言标签和格式问题(适合编写我们的博客文件后检查)
{ "hooks": { "PostToolUse": [ { "matcher": "Edit|MultiEdit|Write", "hooks": [ { "type": "command", "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/markdown_formatter.py" } ] } ] }}Hook调用时机:
- PreToolUse:在工具调用之前运行(可以阻止它们)
- PostToolUse:在工具调用完成后运行
- UserPromptSubmit:当用户提交提示时运行,在 Claude 处理之前
- Notification:当 Claude Code 发送通知时运行
- Stop:当 Claude Code 完成响应时运行
- SubagentStop:当子代理任务完成时运行
- PreCompact:在 Claude Code 即将运行压缩操作之前运行
- SessionStart:当 Claude Code 开始新会话或恢复现有会话时运行
- SessionEnd:当 Claude Code 会话结束时运行
🛠️Sub Agent(子智能体并行执行)
使用方法:/agents 后选择是适用于项目还是用户级别
填写对应的描述以及结果(类似于我们的模型系统提示词)
使用这个的好处是可以将任务拆分为多个小任务,并且获得独属于每个确认子任务的精简上下文,不被上下文污染,效率与准确度更棒!
🚥代码回退(Claudecode2.0之前的依靠额外插件,但强烈支持)
下载Github开源项目ccundo
安装命令
npm install -g ccundo使用:
ccundo list 列出对话记录
ccundo undo 编号 即可回退该对话的代码
🌐可视化版本推荐
我的ClaudeCode使用笔记
https://www.micostar.tech/posts/claudecode/