Claude Code Local#

调用本机 Claude Code 作为非交互 coding agent。Orchestrator 负责指挥和验收，Claude Code 负责写代码。

Quick Reference#

场景命令模板短任务cd <project> && claude --bare -p "<任务>" --max-turns 10长任务cd <project> && claude --bare -p "<任务>" --output-format stream-json --verbose --include-partial-messages --max-turns 30全权限cd <project> && claude --bare -p "<任务>" --dangerously-skip-permissions --output-format stream-json --verbose --include-partial-messages --max-turns 30只读分析cd <project> && claude --bare -p "<任务>" --permission-mode plan --allowedTools "Read,Glob,Grep,LSP" --max-turns 10JSON 输出cd <project> && claude --bare -p "<任务>" --output-format json --max-turns 10

Key Flags#

FlagPurpose--bareMinimal mode, skip hooks/LSP/plugins, faster startup-p / --printNon-interactive, output to stdout ( do not use PTY)--max-turns NLimit turns: 10 short, 30 long--output-format stream-jsonStreaming output, prevents timeout--output-format jsonSingle JSON with result field--verboseDetailed logging (with stream-json)--include-partial-messagesIncremental output (with stream-json)

Permission Modes#

Default to the lowest level that accomplishes the task.

LevelModeFlagsUse Case1 Readplan--permission-mode plan --allowedTools "Read,Glob,Grep,LSP"Code exploration, doc review2 Analyzedefault--allowedTools "Read,Bash,Glob,Grep,LSP"Run diagnostic commands3 EditacceptEdits--permission-mode acceptEdits --allowedTools "Read,Edit,Write,Bash,Glob,Grep,LSP"Modify source files4 Fullbypass--dangerously-skip-permissionsTrusted projects, batch ops

Timing Expectations#

ComplexityDurationmax-turnsSimple (回答问题)2-5 min5-10Medium (探索+单文件)5-15 min10-20Complex (多文件+测试)15-30 min20-40

Never kill Claude Code when exec times out. Check ps aux | grep claude first.

Post-Task Checklist#

• Summary of changes
• Modified files list
• Commands executed
• git status --short
• git diff --stat
• Test results
• Next steps

References#

• references/streaming.md — Stream-JSON event types and filtering
• references/troubleshooting.md — Common failures and fixes