Claude Code配置记录

基本使用

命令行命令：
命令功能说明示例claude启动交互模式claudeclaude "task"运行一次性任务claude "修复构建错误"claude -p "query"执行一次性查询并退出claude -p "解释这个函数"claude -c继续最近的会话claude -cclaude -r恢复之前的会话claude -rclaude commit创建一个 Git 提交claude commit/clear清除会话历史> /clear/help显示可用命令> /helpexit 或 Ctrl+C退出 Claude Code> exit常用斜杠命令：
命令功能说明/init初始化项目，创建 Claude. Md/compact压缩上下文，减少 Token 消耗/clear清除上下文shift tab切换模式#存储记忆/skills自定义命令 $ARGUMENTS 传递参数/ide和 ide 打通/permissions定义允许或不允许直接执行的命令--dangerously-skip-permissions直接赋予最高权限/resume找回历史对话（ccundo 同时回退代码）/export导出对话其他操作：

• 问题中携带 think, think hard, think harder, ultra think 可以显式让模型开启思考模式
  
• 快捷操作
  
  
  
  • Ctrl + W：删除完整单词
    
  • Ctrl + A/Ctrl + E：快速跳转行首/行尾
    
  • Ctrl + U/Ctrl + K：删除整行或行尾内容
    
  • Ctrl + B/Ctrl + F：逐字符移动光标（比方向键更高效）
    
  
  
• 双击ESC 键：显示当前对话的历史记录，可以选择到一条特定对话回滚（只会回滚对话上下文，不会回滚已操作的文件）
  

核心组件

MCP

官方教程
可以通过 Claude 的命令添加mcp，可以选择添加为项目或者用户级，用户级的mcp 后续会保存在 ~/.calude.json 文件夹中（不过注意json 的格式和cursor 中的不是完全一致）。
添加方式：把cursor 中的json文件传递给AI，让AI 生成claude code 命令来添加mcp，最终在 ~/.claude.json 中生成的json 片段如下，配置了：

• Serena
  
• DeepWiki-Mcp
  
• Context 7
  
• Tavily
  
• Sequential-thinking
  
• Fetch
  
• Chrome-devTools
  

1. "mcpServers": {
2.         "serena": {
3.       "type": "stdio",
4.       "command": "uvx",
5.       "args": [
6.         "--from",
7.         "git+https://github.com/oraios/serena",
8.         "serena-mcp-server",
9.         "--context",
10.         "ide-assistant"
11.       ],
12.       "env": {}
13.     },
14.     "mcp-deepwiki": {
15.       "type": "stdio",
16.       "command": "npx",
17.       "args": [
18.         "-y",
19.         "mcp-deepwiki@latest"
20.       ]
21.     },
22.     "tavily-remote-mcp": {
23.       "type": "stdio",
24.       "command": "npx",
25.       "args": [
26.         "-y",
27.         "mcp-remote",
28.         "https://mcp.tavily.com/mcp/?tavilyApiKey=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"
29.       ],
30.       "env": {}
31.     },
32.     "sequential-thinking": {
33.       "type": "stdio",
34.       "command": "npx",
35.       "args": [
36.         "-y",
37.         "@modelcontextprotocol/server-sequential-thinking"
38.       ],
39.       "env": {}
40.     },
41.     "fetch": {
42.       "type": "stdio",
43.       "command": "uvx",
44.       "args": [
45.         "mcp-server-fetch"
46.       ],
47.       "env": {}
48.     },
49.     "context7": {
50.       "type": "stdio",
51.       "command": "npx",
52.       "args": [
53.         "-y",
54.         "@upstash/context7-mcp"
55.       ],
56.       "env": {}
57.     },
58.     "chrome-devtools": {
59.       "type": "stdio",
60.       "command": "npx",
61.       "args": [
62.         "chrome-devtools-mcp@latest"
63.       ],
64.       "env": {}
65.     }
66.   }

复制代码

SubAgent

官方教程
在Claude Code 中输入 /agents 打开agent 设置，之后就可以选择新建一个agent

• 选择agent 的作用范围
  
• 选择使用Claude 生成，或者自己配置
  
  
  
  • Generate With Claude：输入agent，Claude 会自动生成提示词和使用场景
    
  • Manual configuration：自己输入名称，提示词和使用场景
    
  
  
• 最终生成的agent 的配置文件会保存在 ~/.claude/agents （用户级anget 而不是项目级）目录下，随时可以修改
  
• 如何激活agent
  
  
  
  • 自动激活：当claude code 发现当前场景匹配agent 的描述时，会自动调用
    
  • 显式激活：在对话时指定使用某个agent 进行操作
    
    
    
    
  
  

一个使用Serena-mcp 进行项目分析的prompt：

1. 开源项目分析专家
3. ## 角色定位
4. 你是一个专业的代码分析助手，使用Serena MCP工具对开源项目进行深度分析并生成分析报告。
6. ## 核心能力
7. - 使用Serena的语义搜索和LSP功能理解代码结构
8. - 分析项目架构、代码质量和潜在问题
9. - 生成结构化的项目分析报告
11. ## 工作流程
13. ### 1. 项目初始化
14. - 激活目标项目：`告诉我激活项目 /path/to/project`
15. - 等待Serena完成项目扫描和记忆创建
16. - 检查配置：`显示当前配置`
18. ### 2. 分析执行
19. - **架构分析**：识别主要模块、依赖关系、设计模式
20. - **代码质量**：评估复杂度、可维护性、测试覆盖率
21. - **安全检查**：扫描潜在漏洞、依赖安全性
22. - **文档评估**：检查文档完整性和质量
24. ### 3. 报告输出
25. 生成包含以下部分的分析报告：
27. #### 项目概览
28. - 项目名称、技术栈、主要功能
29. - 整体健康度评分（1-10分）
31. #### 技术架构
32. - 核心模块结构
33. - 关键依赖和集成点
34. - 架构优缺点
36. #### 质量评估
37. - 代码复杂度分析
38. - 测试策略评估
39. - 维护性指标
41. #### 改进建议
42. - 优先级排序的改进点
43. - 具体实施建议
44. - 预估工作量
46. ## 操作原则
47. - 使用Serena的语义搜索精确定位代码
48. - 基于LSP数据提供准确分析
49. - 保持只读模式，不修改源码
50. - 提供具体可执行的建议
52. ## 输出要求
53. - 使用中文撰写报告
54. - 提供具体代码示例和文件路径
55. - 量化评估结果
56. - 突出关键发现和风险点

复制代码

Hooks

• 官方教程
  
• 参考视频教程
  

Hooks 触发时机：
Hook 名称调用时机说明SessionStart启动新会话或恢复会话时初始化状态、加载上下文UserPromptSubmit用户提交 Prompt 之前可截获输入或修改指令PreToolUse工具（如代码执行、编辑）调用前可阻止或修改行为PostToolUse工具调用完成后收集执行结果、生成日志NotificationClaude Code 发送通知时用于自定义消息通知或状态更新SubagentStop子智能体任务结束时清理子任务或记录子代理输出PreCompactClaude 将上下文压缩前可保存历史状态、调优上下文压缩逻辑StopClaude Code 完成响应时清理资源、保存日志SessionEnd会话结束释放所有上下文、结束环境交互斜杠命令和Skill

自定义命令官方教程
Skill 官方教程
自定义斜杠命令是用户通过斜杠 / 自主调用的，而Skill 则是写好的工作流，让Agent自动触发调用，基本可以等价换用，具体的细分场景如下：
方面斜杠命令代理技能复杂性简单提示复杂功能结构单个.md文件带SKILL.md +资源的目录发现显式调用（/command）自动（基于上下文）文件仅一个文件多个文件、脚本、模板范围项目或个人项目或个人共享通过git通过git下面以Skill 为例说明用法：
基本用法

• 在项目中创建命令目录：
  

1. mkdir -p .claude/commands

复制代码

• 为每个命令创建 Markdown 文件
  

1. cd .claude/commands/git_message.md

复制代码

• 输入命令的具体内容
  

1. ## 指令
2. 生成清晰、描述性的Git提交信息，遵循最佳实践。
3. 1. 分析Git diff或代码变更
4. 2. 识别变更类型（功能、修复、重构等）
5. 3. 生成简洁且描述性的提交信息
6. 4. 遵循约定式提交格式
7. ## 提交信息格式
8. <类型>[模块名]: <描述>  
9. [正文]  
10. [可选脚注]
11. - 类型如下：
12.     - `feat`: 新功能
13.     - `fix`: 错误修复
14.     - `docs`: 文档变更
15.     - `style`: 代码格式化
16.     - `refactor`: 代码重构
17.     - `test`: 测试相关
18.     - `chore`: 构建过程或辅助工具变更
19. - 正文使用 Bullet Point形式分点说明，三点左右，不超过五点
21. ## 示例
22. - `feat(auth): add user login functionality`
23. - `fix(api): resolve null pointer exception in user service`
24. - `docs: update installation instructions`
25. - `refactor(utils): simplify date formatting logic`
26. ## 最佳实践
27. - 使用现在时态的动词
28. - 首字母小写
29. - 不以句号结尾
30. - 限制在50个字符内
31. - 正文详细说明"什么"和"为什么"

复制代码

• 在 Claude Code 中使用您的自定义命令
  

1. > /git_message

复制代码

添加参数

• 使用 $ARGUMENTS 占位符创建命令文件
  

1. echo 'Find and fix issue #$ARGUMENTS. Follow these steps: 1.
2. Understand the issue described in the ticket 2. Locate the relevant code in
3. our codebase 3. Implement a solution that addresses the root cause 4. Add
4. appropriate tests 5. Prepare a concise PR description' >
5. .claude/commands/fix-issue.md

复制代码

• 使用带有问题编号的命令
  

1. > /fix-issue 123

复制代码

这将在提示中用”123”替换 $ARGUMENTS。
功能扩展

插件

• 官方教程
  
• B 站视频教程
  
• 文字参考教程
  

Claude Code的插件支持四种核心组件：

• 斜杠命令（Slash Commands）：创建你自己的快捷指令
  
• 子代理（Subagents）：专门处理特定任务的AI助手
  
• 事件钩子（Hooks）：在关键节点自动执行操作
  
• MCP服务器：连接外部工具和数据源
  

这四个组件就像乐高积木，你可以根据实际需求自由组合。想做代码审查？组合一套审查命令+安全专家Agent+自动扫描Hook。想做自动化部署？搭配部署命令+测试Hook+监控工具。
除了自己开发插件，你还能从插件市场安装别人分享的优秀工作流。目前已经有不少开发者在GitHub上分享了他们的最佳实践，涵盖DevOps自动化、文档生成、项目管理、测试套件等各个方面。
可视化

使用 Claudia 可以进行可视化操作，包括项目管理，对话管理，Agent 管理，Hook 管理，Command 管理，创建检查点等等。

参考

• https://feisky.xyz/posts/2025-07-08-claude-code-best-practices/
  
• https://zhuanlan.zhihu.com/p/1928918331810886674
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！