通俗版 Claude Code 文档

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

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

用 Claude Code 搞构建

编程方式调用

在脚本或程序里调用 Claude Code,把它当命令行工具或库来用。

页面信息

对应原页

编程方式调用

页面性质

第三方中文解释页

使用建议

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

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

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

这一页先讲明白

无头模式就是不进聊天界面,直接在脚本或 CI 里调用 Claude Code。

适合自动流程、批处理和流水线集成。

你可以把它当成“把帮工嵌进机器流程里”。人不一定站在旁边,但机器会按你定好的话把活派出去。

这种模式特别适合重复审查、批量解释、自动生成报告。

先挑一个低风险场景试,比如解释报错、生成摘要、审查改动。

自动流程里要特别注意输入范围和权限,别让它拿到超出预期的东西。

预留广告位

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

照着做一遍

第一次用无头模式,别先接进整条 CI 流水线。

先在本地命令行里跑一个最小示例,确认它会吐你想要的结果。

终端里敲

第 1 步:先跑一个最小问题

先问一个一眼能看出对不对的小问题。

claude -p "explain this function"
终端里敲

第 2 步:再试带文件的任务

让它真正碰一下项目里的文件,看输出是不是靠谱。

claude -p "summarize the changes in src/auth/login.ts"
终端里敲

第 3 步:要给别的程序吃时,再收紧格式

人看和机器看不是一回事,后面接程序时再固定结构。

claude -p "return JSON with keys summary and risk"
终端里敲

第 4 步:最后才接进自动流程

先本地确认稳定,再放进脚本或 CI。

./run-claude-check.sh

一眼看懂这一页

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

编程方式调用
   |
   v
在脚本或程序里调用 Claude Code,把它当命令行工具或库来用。
   |
   v
照着步骤去做

文末提醒

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

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