一、核心理念
请勿将 Claude Code 当作普通聊天机器人使用。它的本质是一个 AI 编程操作系统——更准确地说，是一个 AI Agent 命令行工具（CLI）。只有理解这一点，才算真正掌握了它的用法。
/命令= 调用能力.md规则= AI 长期记忆/insight= 自我优化系统
二、核心命令总览
1. 项目初始化（最关键一步）
/init
初始化项目，自动生成规则文档（通常为 .md 格式）。该命令会扫描项目结构、识别技术栈，为 AI 建立上下文记忆，并生成开发规范。简单来说：就是为 AI 构建项目大脑。
最佳实践：
/init
然后手动补充：
- UI框架（如 OSA）
- 资源管理（如 Resmgr）
- 网络系统
- 性能规则
- 禁止项（至关重要，后文详述）
2. 自我优化（强烈推荐）
/insight
分析你的使用习惯，输出一份优化报告，涵盖 Prompt 质量、命令使用情况、Agent 运用水平、工作流瓶颈、Token 效率等关键指标。
推荐用法：
/insight /plan 根据insight优化我的使用方式
使用频率：
- 新手阶段：每天或每两天执行一次
- 熟练之后：每周一次
- 项目节点：每个功能完成后执行一次
三、开发核心工作流命令
推荐标准流程（重中之重）
/search → /analyze → /plan → /act
这是最值得养成的习惯：先搜索定位关键代码，再分析结构，接着制定计划，最后执行。四个命令一气呵成，能大幅降低错误成本。
1. 搜索 & 分析
/search <关键词>→ 全项目搜索/grep→ 正则搜索/analyze→ 分析代码结构 / 问题/trace→ 调用链追踪
2. Agent模式（核心能力）
/plan→ 生成执行计划（强烈建议先使用）/act→ 执行计划/step→ 逐步执行/think→ 深度推理模式/review→ 代码评审
3. 修改代码
/edit→ 修改当前文件/apply→ 应用AI修改/diff→ 查看改动
4. 调试与修复
/fix→ 自动修复问题/debug→ 分析bug/test→ 运行测试
5. 代码生成与优化
/generate→ 生成代码/refactor→ 重构代码/optimize→ 性能优化/doc→ 生成文档
6. 项目上下文
/context→ 查看当前上下文/index→ 建立索引/clear→ 清空上下文
7. 外部能力
/web→ 联网查询/install→ 安装依赖
8. Git相关
/git status /git diff /git commit /git push
或直接使用下面这条快捷命令：
/commit
四、高手用法（重点）
1. /init + 手动规则强化
示例规则：
## UI Framework - 使用 OSA - 禁止大量实例化UI ## Resource Management - 使用 ResmgrNative - 禁止 Resources.Load ## Performance - 使用定点数 - 避免GC Alloc ## 禁止项 - 禁止 FindObjectOfType
作用十分直接：降低 AI 理解成本、提高代码一致性、提升一次成功率。切勿小看“禁止项”，用对了能省去大量后期调试时间。
2. /insight 持续优化
循环流程：
开发功能 → /insight → /plan 优化使用方式 → 调整习惯
本质是什么？让 AI 教你如何更高效地使用 AI。每完成一个功能就反思一次，逐步形成自己的最佳路径。
3. 固定工作流（强烈推荐）
✅ 日常开发
/search 关键词 /analyze /plan 实现XXX功能 /act
✅ 修Bug
/analyze /debug /plan 修复问题 /act
✅ 重构
/analyze /refactor /optimize
五、常见错误
实际使用中，最容易踩的坑有以下几个：
- ❌ 不用
/plan→ 直接改代码，错误率偏高 - ❌
/init后不维护 → AI 逐渐偏离项目风格 - ❌ 不写“禁止项” → AI 乱用 API
- ❌ 只聊天不用命令 → 浪费 Claude Code 潜力
- ❌ 不用
/insight→ 无法持续提升使用水平
六、推荐完整流程（最佳实践）
# 初始化 /init # 开发 /search /analyze /plan /act # 优化 /insight /plan 优化使用方式
