当前位置：首页 > news >正文

Claude Code配置记录

news 2025/10/24 19:40:26

基本使用

命令行命令：

命令	功能说明	示例
claude	启动交互模式	claude
claude "task"	运行一次性任务	claude "修复构建错误"
claude -p "query"	执行一次性查询并退出	claude -p "解释这个函数"
claude -c	继续最近的会话	claude -c
claude -r	恢复之前的会话	claude -r
claude commit	创建一个 Git 提交	claude commit
/clear	清除会话历史	> /clear
/help	显示可用命令	> /help
exit 或 Ctrl+C	退出 Claude Code	> exit

常用斜杠命令：

命令	功能说明
`/init`	初始化项目，创建 Claude. Md
`/compact`	压缩上下文，减少 Token 消耗
`/clear`	清除上下文
`shift tab`	切换模式

`#<记忆内容>`	存储记忆
`/skills`	自定义命令 `$ARGUMENTS` 传递参数
`/ide`	和 ide 打通

`/permissions`	定义允许或不允许直接执行的命令
`--dangerously-skip-permission`s	直接赋予最高权限

`/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

"mcpServers": {"serena": {"type": "stdio","command": "uvx","args": ["--from","git+https://github.com/oraios/serena","serena-mcp-server","--context","ide-assistant"],"env": {}},"mcp-deepwiki": {"type": "stdio","command": "npx","args": ["-y","mcp-deepwiki@latest"]},"tavily-remote-mcp": {"type": "stdio","command": "npx","args": ["-y","mcp-remote","https://mcp.tavily.com/mcp/?tavilyApiKey=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"],"env": {}},"sequential-thinking": {"type": "stdio","command": "npx","args": ["-y","@modelcontextprotocol/server-sequential-thinking"],"env": {}},"fetch": {"type": "stdio","command": "uvx","args": ["mcp-server-fetch"],"env": {}},"context7": {"type": "stdio","command": "npx","args": ["-y","@upstash/context7-mcp"],"env": {}},"chrome-devtools": {"type": "stdio","command": "npx","args": ["chrome-devtools-mcp@latest"],"env": {}}}

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：

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

Hooks

官方教程
参考视频教程

Hooks 触发时机：

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

斜杠命令和Skill

自定义命令官方教程

Skill 官方教程

自定义斜杠命令是用户通过斜杠 / 自主调用的，而Skill 则是写好的工作流，让Agent自动触发调用，基本可以等价换用，具体的细分场景如下：

方面	斜杠命令	代理技能
复杂性	简单提示	复杂功能
结构	单个.md文件	带SKILL.md +资源的目录
发现	显式调用（`/command`）	自动（基于上下文）
文件	仅一个文件	多个文件、脚本、模板
范围	项目或个人	项目或个人
共享	通过git	通过git

下面以Skill 为例说明用法：

基本用法

mkdir -p .claude/commands

为每个命令创建 Markdown 文件

cd .claude/commands/git_message.md

输入命令的具体内容

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

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

> /git_message

添加参数

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

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