本文总结了我在使用 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，类似于定制化智能体，用于执行特定任务或规范。
创建与使用流程：
-
执行
/agents创建 agent：- 可选择类型（Project、API、Document 等）
- 设置目标、规范和默认行为
- 生成 markdown 文档存储在指定目录
-
之后再次执行
/agents可查看和使用已有 agent。
🔹 场景示例：
- 将项目代码规范放入 agent，后续生成的代码均遵循规范；
- 进行安全检查，避免敏感信息泄露；
- 生成 API 文档或项目文档；
- 拆解需求文档，输出详细实现思路。
三. 使用技巧与优化
经过几天使用，我总结了一些提升效率的技巧：
- 长上下文分析：Claude 在处理庞大项目时容易陷入反复修改，建议先让 Claude 生成实现思路，确认可行性后再落地代码。
- 选择性文件分析：通过
/add-dir或@文件路径命令分析相关文件，避免无关文件干扰。 - 上下文压缩：长上下文可能导致 Claude 分析效率下降，可使用
/compact保留关键部分。 - 结合其他模型：可以先用 Claude 理解项目结构和逻辑，再用 GPT-5 等更擅长代码生成的模型完成精确实现。
四. 总结
- Claude Code 功能强大，尤其在 需求理解、项目结构分析、代码审查 上很有优势；
- 合理的上下文管理、agent 使用和文件选择 是高效使用 Claude 的关键；
- 在大型项目中，结合不同模型的优势，可实现高效、可靠的开发流程。
🔹 最佳实践：先让 Claude 理解业务逻辑 → 提供分析和建议 → 再使用高性能模型生成具体代码。
