Claude Code怎么接入脚本?-p非交互模式、JSON与退出状态
使用claude -p执行范围明确的只读任务,区分stdout结果、stderr和非零退出;核对…
文章目录
想把Claude Code放进脚本,不一定需要自己模拟终端按键。官方提供-p非交互入口,它仍可能加载项目配置与工具。本文只检查练习README,不修改文件、不自动提PR或发消息,重点是输入、输出和退出状态。
第一步:固定目录与只读任务
先在练习仓库确认登录、当前目录和已有配置,记录CLI版本。非交互不等于没有权限检查,也不等于默认没有工具;先限制任务范围,不把任意外部工单正文直接当作可执行指令。
原有Hooks、Skills、MCP或CLAUDE.md可能参与普通-p运行,必须知道当前加载环境。不要因为脚本在CI里就假设与本地交互完全相同。
claude -p "只阅读当前练习仓库README,列出安装步骤与缺失信息。不运行安装或测试,不修改文件,不联网补充。"
第二步:明确输出格式
默认文本适合阅读,需要程序解析时按官方–output-format选JSON。先检查实际字段与成功标识,不用一条正则从任意自然语言里猜结果。输出文件写到新路径,避免覆盖唯一日志。
claude -p "只概括练习README的用途和缺失信息,不修改或执行命令。" --output-format json
第三步:同时处理退出码与输出
官方说明成功退出码0,失败非零;无效参数可在启动前写stderr,运行内失败如缺认证可能把错误作为stdout结果。应用不能只检查stdout非空,更不能将错误文字作为正常摘要入库。
记录退出状态、必要错误与任务身份,避免把凭据或完整私人资料写日志。超时后也要确认进程和任务状态,不能无限重启导致多个任务同时跑。
脚本验收:命令存在;目录正确;认证可用;输出格式可解析;退出码符合预期;结果不是错误说明;只读范围得到遵守;空结果或超时进入明确失败状态。
第四步:谨慎选择bare模式
官方–bare可跳过自动发现的Hooks、Skills、插件、MCP、自动记忆及CLAUDE.md等内容,适合需要可重复环境的脚本,但意味着原来依赖的检查和项目说明也可能不再加载。
不要为解决一次配置冲突直接全面开启bare,再以为旧项目规则仍有效。需要哪些指导与权限应显式设计,先核对官方例外和当前版本行为;改变运行模式后重新验收。
第五步:继续会话与重复运行分开
–continue等继续能力可能沿用历史,自动脚本应绑定准确任务与目录,不把最近会话误当目标。重试前核对前次是否已产生文件或外部动作,非交互不自动提供业务幂等。
需要完整程序化事件、工具批准或多轮控制时可进一步使用Agent SDK,不能把CLI最后一段输出当成全部工具记录。完成标准是任务范围清晰、失败能被程序识别、结果可回查,未运行的检查不标通过。
官方资料
资料核对日期:2026年11月19日。
本文地址:https://www.163264.com/21900

