🎉 欢迎使用 AI合租 文档系统!返回主站 →
文档中心
使用技巧
输出样式

输出样式定制

个性化 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 从单纯的编程助手变成适合任何领域的智能助手!