Claude Local
claudelocal runs Anthropic's Claude Code CLI on the same machine as Paperclip. Use it when you want a local coding agent with session persistence, skills injection, and full access to the configured…
Claude Local
claudelocal runs Anthropic's Claude Code CLI on the same machine as Paperclip. Use it when you want a local coding agent with session persistence, skills injection, and full access to the configured working directory.
---
When To Use
You already use Claude Code on the host machine. You want a local agent that can read and write files in a working directory. You want Paperclip to resume the same Claude session across heartbeats. You want the adapter to sync Paperclip skills into Claude's skill path automatically.
When Not To Use
The agent runs on another machine or behind a webhook. Use HTTP (/docs/adapters/http) instead. You only need a one-shot script or command. Use Process (/docs/adapters/process). Claude Code is not installed or is not available on PATH.
---
Common Fields
| Field | Required | Notes | |---|---:|---| | cwd | no | Absolute working directory for the agent. Recommended in practice. If omitted, the adapter falls back to the current process working directory. Paperclip creates the path when permissions allow. | | model | no | Claude model id. Common choices include claude-opus-4-6, claude-sonnet-4-6, and claude-haiku-4-6. | | promptTemplate | no | Prompt template used for the run. | | env | no | Environment variables passed to Claude Code. Secret refs are supported. | | command | no | Defaults to claude. Override only if you need a different executable path. | | extraArgs | no | Extra CLI arguments appended to the Claude invocation. | | effort | no | Reasoning effort passed with --effort (low, medium, or high). | | chrome | no | Passes --chrome when enabled. | | maxTurnsPerRun | no | Caps the number of agentic turns in one heartbeat. Defaults to 300. | | dangerouslySkipPermissions | no | Defaults to true because Paperclip runs Claude in headless --print mode. | | timeoutSec | no | Run timeout in seconds. 0 means no timeout. | | graceSec | no | Grace period before a forced stop. | | workspaceStrategy | no | Execution workspace strategy, such as gitworktree. | | workspaceRuntime | no | Reserved workspace runtime metadata. |