本文总结了我在使用 Claude Code 过程中整理的命令、配置和最佳实践，包括 上下文管理、agent 使用、文件分析 等实用技巧，帮助你高效利用 Claude 完成项目开发与代码分析。

---

一. 命令总览

Claude Code 提供了丰富的命令体系，可分为 基础配置、执行操作、上下文管理和文件操作 四大类。

---

1️⃣ 基础配置

使用命令 /config 可以对 Claude 进行基础配置，常用设置如下：

设置项	当前值	功能描述	推荐值	使用场景
Auto-compact	true	自动压缩会话历史	true	避免上下文空间不足，保持对话流畅
Use todo list	true	启用待办事项功能	true	任务跟踪和管理，团队协作
Verbose output	false	控制输出详细程度	false	日常开发关闭，学习调试时开启
Auto-updates	true	自动下载安装更新	true	确保使用最新功能和安全补丁
Theme	Dark mode	界面主题风格	个人偏好	Dark mode 对长时间编码更友好
Notifications	Auto	通知显示策略	Auto	智能决定何时显示通知
Output style	default	定义回答格式和风格	default	平衡可读性和详细程度
Editor mode	normal	编辑器行为模式	个人偏好	根据编辑器习惯选择
Model	Default	选择 AI 模型版本	Default	系统自动选择最佳模型
Auto-connect to IDE	false	自动连接外部 IDE	false	按需开启 IDE 集成

🔹 Tip：合理设置 Auto-compact 可以避免会话上下文过长导致 Claude 分析缓慢或遗漏重点。

---

2️⃣ 执行过程中的快捷操作

特性	Esc (退出键)	Ctrl+C (控制组合键)
主要功能	退出当前输入模式或选择状态	强制终止正在运行的代码
影响范围	当前输入块	整个代码执行进程
上下文保持	✅ 完全保持	❌ 完全丢失
可恢复性	立即恢复，无损失	无法恢复，需重新运行

🔹 Tip：Esc 可以安全退出某个操作而不丢失上下文，而 Ctrl+C 用于紧急中断，慎用。

---

3️⃣ 上下文管理

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

命令	功能
/compact	压缩会话历史，保留重要摘要，节省上下文空间。例如：/compact keep only the API design discussion
/clear	清空所有聊天历史与上下文
/context	查看当前上下文使用情况
/add-dir ./src/components	将目录添加到 Claude 分析范围

🔹 Tip：Claude 本身不提供持久化本次上下文的功能，可以手动导出或创建上下文文件以便后续调用。

---

4️⃣ 文件引用与分析

Claude 支持精确文件和目录分析，非常适合项目级代码审查或重构：

# 读取特定文件
@src/utils/auth.js 这个文件的登录逻辑有问题
​
# 读取目录
@src/components/ 分析所有 React 组件性能
​
# 结合使用
@package.json 和 @src/index.js，帮我分析项目结构
​
# 排除特定文件
@src/ --exclude="*.test.js" 分析生产代码

🔹 Tip：使用 --exclude 可以避免分析测试文件或无关目录，节省上下文空间，提高分析效率。

---

二. Agent 的使用

Claude Code 允许创建 agent，类似于定制化智能体，用于执行特定任务或规范。

创建与使用流程：

1. 执行 /agents 创建 agent：

   • 可选择类型（Project、API、Document 等）

   • 设置目标、规范和默认行为

   • 生成 markdown 文档存储在指定目录

2. 之后再次执行 /agents 可查看和使用已有 agent。

🔹 场景示例：

1. 将项目代码规范放入 agent，后续生成的代码均遵循规范；

2. 进行安全检查，避免敏感信息泄露；

3. 生成 API 文档或项目文档；

4. 拆解需求文档，输出详细实现思路。

---

三. 使用技巧与优化

经过几天使用，我总结了一些提升效率的技巧：

1. 长上下文分析：Claude 在处理庞大项目时容易陷入反复修改，建议先让 Claude 生成实现思路，确认可行性后再落地代码。

2. 选择性文件分析：通过 /add-dir 或 @文件路径 命令分析相关文件，避免无关文件干扰。

3. 上下文压缩：长上下文可能导致 Claude 分析效率下降，可使用 /compact 保留关键部分。

4. 结合其他模型：可以先用 Claude 理解项目结构和逻辑，再用 GPT-5 等更擅长代码生成的模型完成精确实现。

---

四. 总结

• Claude Code 功能强大，尤其在 需求理解、项目结构分析、代码审查 上很有优势；

• 合理的上下文管理、agent 使用和文件选择 是高效使用 Claude 的关键；

• 在大型项目中，结合不同模型的优势，可实现高效、可靠的开发流程。

🔹 最佳实践：先让 Claude 理解业务逻辑 → 提供分析和建议 → 再使用高性能模型生成具体代码。