claude-code-local

Call Claude Code as a non-interactive coding agent on the same machine as OpenClaw. Use when: (1) You need to delegate coding, refactoring, or bug-fixing tasks to Claude Code, (2) You want non-interactive code exploration and analysis, (3) You need to run batch code reviews, (4) You're setting up automated CI/CD code checks, (5) You want to use Claude Code as a specialized subordinate for project work while keeping the orchestrator agent focused on coordination.

调用本机 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 10
JSON 输出	cd <project> && claude --bare -p "<任务>" --output-format json --max-turns 10

Key Flags

Flag	Purpose
--bare	Minimal mode, skip hooks/LSP/plugins, faster startup
-p / --print	Non-interactive, output to stdout (do not use PTY)
--max-turns N	Limit turns: 10 short, 30 long
--output-format stream-json	Streaming output, prevents timeout
--output-format json	Single JSON with result field
--verbose	Detailed logging (with stream-json)
--include-partial-messages	Incremental output (with stream-json)

Permission Modes

Default to the lowest level that accomplishes the task.

Level	Mode	Flags	Use Case
1 Read	plan	--permission-mode plan --allowedTools "Read,Glob,Grep,LSP"	Code exploration, doc review
2 Analyze	default	--allowedTools "Read,Bash,Glob,Grep,LSP"	Run diagnostic commands
3 Edit	acceptEdits	--permission-mode acceptEdits --allowedTools "Read,Edit,Write,Bash,Glob,Grep,LSP"	Modify source files
4 Full	bypass	--dangerously-skip-permissions	Trusted projects, batch ops

Timing Expectations

Complexity	Duration	max-turns
Simple (回答问题)	2-5 min	5-10
Medium (探索+单文件)	5-15 min	10-20
Complex (多文件+测试)	15-30 min	20-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