通俗版 Claude Code 文档

结构照原 docs,内容改成真能照着做的人话版。

查看原始文档 目录顺序与官方保持一致

Model and responses

输出风格

输出风格 这一页讲的,就是 输出风格 这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

输出风格

页面性质

第三方中文解释页

使用建议

先看人话解释,再对照原页命令和代码

这页不是官方原文,而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留,解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异,最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

输出风格决定 Claude 最后把话说成什么样。

你是要看 Markdown、纯文本、结构化 JSON,提前说清楚。

同样一件事,给领导看、给机器看、给自己看,写法都不一样。输出风格就是在提前定规矩。

如果你后面还要把结果喂给别的程序,结构化格式尤其重要。

给人看就优先选清楚易读的格式,给机器接就选 JSON/XML 这类结构化输出。

别一会儿要自由发挥,一会儿又要固定字段,先定好主目标。

预留广告位

正文中段响应式广告 等你后面真接 AdSense,这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Built-in output styles

这一块主要是在说"Built-in output styles"真到手上该怎么用,哪里最容易踩坑。

How output styles work

这里不是让你背"How output styles work"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Change your output style

这一段是在把 /config and select Output style to pick a style from a menu. Your selection is saved to .claude/settings.local.json at the local project level. 真跑起来。别只看命令长什么样,还得看跑完该出现什么。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

改配置

Change your output style

这一段说完,最后还得写到配置里才算真的生效。

{
  "outputStyle": "Explanatory"
}

Create a custom output style

这里不是让你背"Create a custom output style"这个词,而是让你看它真干活时怎么使。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

改配置

Create a custom output style

光知道意思还不够,这里得把规矩落进配置里,下面这块照着填。

---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]

Frontmatter

这里不是让你背"Frontmatter"这个词,而是让你看它真干活时怎么使。

Comparisons to related features

这一块主要是在说"Comparisons to related features"真到手上该怎么用,哪里最容易踩坑。

Output Styles vs. CLAUDE.md vs. —append-system-prompt

这一块主要是在说"Output Styles vs. CLAUDE.md vs. —append-system-prompt"真到手上该怎么用,哪里最容易踩坑。

这里还牵扯作用域,意思就是这条规则到底管当前项目、你个人,还是只管这一趟会话。

Output Styles vs. Agents

这里不是让你背"Output Styles vs. Agents"这个词,而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界,别为了省事一把全开。

Output Styles vs. Skills

这里不是让你背"Output Styles vs. Skills"这个词,而是让你看它真干活时怎么使。

如果你打算把外接能力往里挂,这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

照着做一遍

这页属于“输出风格”这类活,最稳的办法还是一小步一小步来。

下面这三步不一定华丽,但通常最不容易绕晕。

第 1 步:先起步

给人看就优先选清楚易读的格式,给机器接就选 JSON/XML 这类结构化输出。

第 2 步:边做边看

别一会儿要自由发挥,一会儿又要固定字段,先定好主目标。

一眼看懂这一页

这页的作用,就是把原本偏专业的话题,拆成能直接照着走的明白话。

输出风格
   |
   v
输出风格 这一页讲的,就是 输出风格 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成,原站加页、删页、改页时,这里会跟着更新。

人话解释会尽量顺着原页往下讲,但命令、参数名、配置名这些硬东西还是保留原样,免得你抄过去跑不起来。