Claude Code 教程目录

Anthropic Claude Code Tutorial

Claude Code 结构化输出

结构化输出的目标是可解析，不是看起来漂亮。你需要清晰 schema、错误兜底和严格验证。

什么时候需要 JSON

CI 要根据结果决定下一步。
后台要保存分析结果。
需要把风险列表变成数据库记录。
需要和工单、PR 评论或监控系统对接。

{
  "summary": "short text",
  "risks": [{ "severity": "high", "file": "src/app.ts", "reason": "..." }],
  "tests": ["npm test"]
}

可靠性建议

在 prompt 中给出 schema。
要求不要输出 schema 之外内容。
调用端做 JSON parse 和字段校验。
失败时回退到人工阅读模式。

常见问题

Markdown 表格适合自动化吗？

不适合机器消费。自动化优先 JSON，人工报告再转 Markdown。

参考来源

内容基于 Anthropic 官方 Claude Code 文档、Claude Code 最佳实践文章和 Model Context Protocol 官方资料整理，并改写为中文教程站结构。