1963 字
10 分钟
我的ClaudeCode使用笔记
最近正式在一些项目开始使用ClaudeCode,记录一些使用笔记。
2025-09-20
加载中...

ClaudeCode使用笔记#

或者前往这里

🧭ClaudeCode官方文档#

有空更建议研究ClaudeCode官方文档

Claude Code 概述 - Claude Docs


🔥 重要指令#

命令功能代码特殊示例
/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/ /rewindclaudecode2.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相同”增加MCPclaude 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

GitHub - RonitSachdev/ccundo: ccundo seamlessly integrates with Claude Code to provide granular undo functionality. It reads directly from Claude Code’s session files to track file operations and allows you to selectively revert changes with full preview and cascading safety.

安装命令

Terminal window
npm install -g ccundo

使用:

ccundo list 列出对话记录

ccundo undo 编号 即可回退该对话的代码


🌐可视化版本推荐#

Github项目opcode

我的ClaudeCode使用笔记
https://www.micostar.tech/posts/claudecode/
作者
流转星(Betsy)
发布于
2025-09-20
许可协议
CC BY-NC-SA 4.0

这篇文章是否对你有帮助?