输出样式定制
个性化 Claude Code 的输出格式,将 Claude 转换为任何类型的智能助手。
输出样式让你保持 Claude Code 的所有核心能力(运行脚本、读写文件、任务跟踪),同时改变 Claude 的行为模式!
🎯 样式配置
访问样式菜单
# 打开输出样式选择菜单
/output-style
# 直接切换到指定样式
/output-style explanatory
/output-style learning
# 通过配置菜单访问
/config
内置样式
Default 默认样式
Claude Code 的标准系统提示,专为软件工程任务设计,高效完成开发工作。
Explanatory 解释型样式
在完成软件工程任务的同时提供教育性"洞察",帮助你理解实现选择和代码库模式。
Learning 学习型样式
协作式的边做边学模式,Claude 不仅会在编码时分享"洞察",还会要求你贡献小而策略性的代码片段,在代码中添加 TODO(human)
标记供你实现。
🛠️ 创建自定义样式
交互式创建
# 创建新的输出样式
/output-style:new 我想要一个输出样式,它...
Claude 会引导你创建个性化的输出样式,适用于各种场景:
- 商业分析师模式
- 内容研究助手
- 专业代码审查
- 技术写作助手
样式文件结构
自定义样式保存为 Markdown 文件:
---
name: 我的自定义样式
description: 专为团队协作设计的代码助手
---
# 自定义样式指令
你是一个专注于团队协作的交互式 CLI 工具。
## 具体行为
- 在代码修改前询问团队成员意见
- 优先考虑代码可读性和维护性
- 提供详细的实现说明和注释
存储位置
- 用户级样式:
~/.claude/output-styles/
(跨项目使用) - 项目级样式:
.claude/output-styles/
(仅限当前项目)
🎯 应用场景
业务分析
/output-style business-analyst
# 转换为商业分析师,专注数据洞察和业务决策
学习模式
/output-style learning
# 边做边学,包含教育性解释和练习任务
代码审查
/output-style code-reviewer
# 专业代码审查,关注安全性、性能和最佳实践
⚙️ 与其他功能的区别
⚠️
重要区别:输出样式完全替代 Claude Code 的默认系统提示,而不是附加内容。
- CLAUDE.md: 作为用户消息添加到对话中
- --append-system-prompt: 附加到系统提示
- 输出样式: 完全替换软件工程相关的系统提示
🚀 高级功能
无头模式集成
# CI/CD 和自动化场景
claude -p "分析代码质量" --output-format stream-json
社区工具
使用 ccoutputstyles
获取预建模板:
# 安装模板库
npm install -g ccoutputstyles
ccoutputstyles
批量切换
# 项目级配置保存在 .claude/settings.local.json
{
"outputStyle": "explanatory"
}
📊 实际效果
传统模式
修复了登录函数中的错误,更新了验证逻辑。
Learning 样式
修复了登录函数中的错误:
💡 **洞察**: 这个错误是典型的空值引用问题
📝 **TODO(human)**: 请在第23行添加用户输入验证
🎯 **学习要点**: 防御性编程的重要性
输出样式让 Claude Code 从单纯的编程助手变成适合任何领域的智能助手!