Claude Code
Run Claude Code as a Subshell agent.
Before you start
Install claude using the vendor instructions and authenticate it under the execution account. Ask an administrator to enable the harness under Settings → Server Settings → Plugins in the server dashboard's sidebar. Follow Install an agent CLI to confirm detection on the target node.
Launch
- In the server dashboard's sidebar, choose Subshells, select New subshell, and choose Claude Code.
- Select a preset or configure the supported launch settings.
- Choose the target node and an existing project directory.
- Launch and confirm that the CLI opens normally.
The plugin detects claude through PATH and its known locations. CLAUDE_PATH can identify the binary explicitly in the execution environment. Before changing that override, see Files and paths for configuration locations and service-environment guidance.
MCP and session behavior
Automatic configuration supplies a per-subshell MCP file and attention hooks. Claude Code is the built-in harness that declares conversation resumption and attention reporting. Restart can resume a surviving transcript; clearing or forking a conversation can change its session identity.
Subshell runs the real CLI rather than proxying its provider API. Provider configuration, usage limits, and CLI-specific permissions remain the agent's own settings.
Next steps
Read MCP configuration, Presets, and Agent and launch errors.
Edit on GitHubLast updated on
