Subshell Docs

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

  1. In the server dashboard's sidebar, choose Subshells, select New subshell, and choose Claude Code.
  2. Select a preset or configure the supported launch settings.
  3. Choose the target node and an existing project directory.
  4. 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 GitHub

Last updated on

On this page