Claude Code 实战指南

基础命令

启动与配置

命令	作用	示例
`claude`	启动交互会话	`claude`
`claude -p "提示词"`	非交互模式输出	`claude -p "分析这个文件"`
`claude --permission-mode plan`	规划模式启动	`claude --permission-mode plan`
`claude --permission-mode acceptEdits`	自动接受编辑模式	`claude --permission-mode acceptEdits`
`claude -c`	继续最近对话	`claude -c`
`claude -r`	恢复指定对话	`claude -r`
`claude --dangerously-skip-permissions`	免授权模式	`claude --dangerously-skip-permissions`
配置管理
命令	作用	示例
——	——	——
`claude config list`	查看所有配置	`claude config list`
`claude config get <key>`	获取配置值	`claude config get theme`
`claude config set <key> <value>`	设置配置值	`claude config set theme dark`
`claude config remove <key>`	删除配置项	`claude config remove theme`

MCP 服务管理

命令	作用	示例
`claude mcp list`	列出 MCP 服务	`claude mcp list`
`claude mcp add <name> <command>`	添加 MCP 服务	`claude mcp add playwright npx -y @playwright/mcp@latest`
`claude mcp remove <name>`	删除 MCP 服务	`claude mcp remove playwright`

会话命令

上下文管理

命令	作用	使用场景
`/clear`	清理当前会话上下文	完成功能模块后，开始新任务前
`/compact`	压缩会话内容	上下文过长时
`/memory`	设置全局提示词	需要AI具备特定思维模式时
`@文件路径`	引用特定文件	需要AI分析具体文件时

历史与撤销

命令	作用	使用场景
`ESC x 2`	调出历史指令	快速复用之前的复杂指令
`回滚` / `撤销`	撤销AI在当前会话的修改	AI操作出错时

自定义命令

命令	作用	配置位置
`/命令名`	执行自定义 Slash 命令	`.claude/commands/命令名.md`

工作流技巧

核心配置

技巧	配置位置
CLAUDE.md	项目根目录
全局提示词	`/memory`
Git 版本控制	项目初始化

交互模式选择

模式	启动方式	适用场景
规划模式	`--permission-mode plan`	需求分析、架构设计
自动接受	`--permission-mode acceptEdits`	批量代码生成
默认模式	`claude`	调试、精细修改

强制思考模式

关键词	效果	使用场景
`think`	基础思考	简单任务规划
`think hard`	深度思考	复杂功能设计
`ultrathink`	超深度思考	系统级架构规划

模型与成本管理

命令	作用	说明
`/model`	切换AI模型	在Claude Opus与Sonnet 4之间切换
`/cost`	查看当前会话消耗	显示当前会话已花费金额
`ccusage`	详细使用统计	需要单独安装：`npm install -g ccusage`

记忆文件系统

类型	文件位置	用途
项目记忆（共享）	`./CLAUDE.md`	项目团队共享的指令、架构、规范
用户记忆（全局）	`~/.claude/CLAUDE.md`	所有项目的个人偏好设置
项目记忆（本地）	`./CLAUDE.local.md`	项目个人偏好设置（已废弃）

Output Styles 功能详解

核心概念：Output styles 允许您把Claude Code「变身」为不同类型的智能体（Agent），同时保留其核心能力（运行本地脚本、读写文件、跟踪TODO等）。它通过直接修改Claude Code的系统提示词（system prompt）来改变行为与交流方式。

内置Output Styles：官方提供3种内置风格：

风格名称	特点	使用场景
Default	面向高效软件工程协作的默认系统提示	日常开发、高效编码
Explanatory（讲解型）	在完成任务的同时插入教学式的「Insights」，解释实现选择与代码库模式	代码审查、知识分享、团队学习
Learning（学习/带教型）	更像结对编程教练；边做边教，在代码中插入`TODO(human)`让用户亲自补全，随后给反馈	新人培训、技能传授、TDD开发

快速使用命令

# 进入风格菜单
/output-style

# 直接切换到讲解型
/output-style explanatory

# 直接切换到学习型
/output-style learning

# 新建自定义风格（自然语言描述）
/output-style:new 我想要一个安全审计风格：偏严格、先threat modeling、产出修复建议与自动化检测脚本

# 查看或修改配置
/config

配置管理

配置项	位置	说明
生效范围	项目本地级别（local project level）	设置保存到 `.claude/settings.local.json`
用户级自定义风格	`~/.claude/output-styles`	个人专用风格定义
项目级自定义风格	`.claude/output-styles`	团队共享风格定义

实战应用场景

1. 遗留代码库分析（Explanatory风格）

选择风格：/output-style explanatory
典型指令：「请为 services/order/ 目录做系统性走查，按模块输出架构图要点与常见反模式，并给我 3 条重构路线图。」
产出预期：边输出改动建议，边穿插「Insights」解释为什么、涉及哪些设计权衡
加分技巧：在每个建议后链接到具体文件/行号并生成小型PoC提交

2. 团队新人入职带教（Learning风格）

选择风格：/output-style learning
典型指令：「我们要给 UserService 增加批量导入，按 TDD 来：请先写失败用例，然后在实现里留下 TODO(human) 让我完成关键片段。」
产出预期：测试先行，Claude插入TODO(human)让新人补全，随后自动点评与改进建议
加分技巧：录成屏幕录像作为团队教材，形成标准化学习路径

3. 安全审计官（自定义风格）

创建风格：/output-style:new 我想要严格的安全审计风格：先威胁建模，再静态/依赖/配置审计，输出CWE映射、修复PR草案与本地脚本
典型指令：「审计 auth/ 和 infra/terraform/，列出高/中/低风险清单；为高风险生成修复PR diff和/scripts下的自动化检查脚本。」
产出预期：威胁清单（含CWE/CVE引用）、修复策略、脚本原型
加分技巧：把风格文件放进项目级.claude/output-styles/security.md，全队共享同一”口味”

4. 产品经理评审（自定义风格）

创建风格：/output-style:new 我想要偏PM的风格：强调用户故事、影响评估、成功指标、边界用例与回滚预案，产出简洁评审结论
典型指令：「评审这个重构PR：补全用户故事、指标、风险与灰度策略；给出放行/阻塞结论。」
产出预期：结构化评审单，能直接贴到PR讨论

5. 数据科学记事本（自定义风格）

创建风格：/output-style:new 我想要数据科学记事本风格：偏探索、每步都写动机/假设/结果/后续问题，附可复现实验脚本
典型指令：「对 notebooks/churn.ipynb 做特征淘洗与对照实验，记录每一步实验日志与结论。」
产出预期：每步都带”为什么”的研究日志 + 可复现脚本

6. 测试驱动修复（自定义风格）

创建风格：/output-style:new 测试驱动修复：先复现bug的最小失败用例，再最小化修复，最后回归影响评估与监控告警建议
典型指令：「这个issue #342在Edge上报JS报错，按风格走：给出最小复现、修复diff、补充监控。」
产出预期：最小可验证的失败→修复闭环，附监控/报警

7. 合规与许可证检查（自定义风格）

创建风格：/output-style:new 合规风格：扫描依赖许可证与第三方片段，输出风险矩阵、替代建议与自动标注脚本
典型指令：「审计 package.json、NOTICE、third_party/，生成合规矩阵与修复脚本。」
产出预期：可追踪、可执行的合规整改单与脚本

关键区别对比

特性	Output Styles	CLAUDE.md / `-append-system-prompt`	Agents（子代理）
工作原理	替换/关闭默认工程化system prompt	追加用户消息 / 附加到默认system prompt	可指定模型、工具、触发场景
影响范围	主循环行为	仅追加指令	完整子代理
适用场景	角色扮演、风格转换	补充说明、追加约束	专业任务、自动化流程

自定义风格文件格式

---
name: 自定义风格名称
description: 详细描述这个风格的用途和特点
---

# 自定义风格指令
你的具体行为规范和说明...

## 关注领域
- 专注点1
- 专注点2

## 方法
- 工作方式1
- 工作方式2

## 输出内容
- 产出格式1
- 产出格式2

手动创建Output Style示例

# 进入风格目录
cd ~/.claude/output-styles

# 创建自定义风格文件
nano security-auditor.md

团队协作建议

风格沉淀：将常用风格沉淀到.claude/output-styles/，形成”标准化智能体角色库”
经验固化：把团队经验固化为可执行的系统提示
版本控制：将自定义风格文件纳入Git版本控制
定期优化：根据实际使用效果持续优化风格定义

输出格式配合

# 仅导出纯文本
claude -p 'summarize this data' --output-format text > summary.txt

# 导出为JSON
claude -p 'analyze this code for bugs' --output-format json > analysis.json

最佳实践