harness-multitool

0020 — Claude Code as a delegate agent

Decision

A session can run its turns through the unmodified claude binary, signed in by the user through Anthropic's own flow. Claude Code stays Claude Code: its system prompt and its tools are its own, and the harness adds to them and shows what it does. The harness never reads, stores or passes its credentials, so this is not an Auth adapter: it is a second AgentBackend (IF-17).

Anthropic's terms do not prevent an end user signing in to the unmodified binary. They also say:

This first kept it out of the default build, behind a cargo feature, until Anthropic answered whether it may ship (Q-33). Anthropic's published terms now say it: they do not prevent "an end user from signing in to the unmodified Claude Code binary with their own Claude subscription, including where a platform hosts Claude Code", on conditions the harness meets. The owner settled Q-33 on 2026-11-19, and the feature is in the default build (delegates). This record is not legal advice.

Not this: Claude Code as a hidden model behind the harness's own tool loop, with its tools switched off and its prompt replaced. That reads as a way round the terms, and external tools only reach it through MCP in any case.

Two modes

ModeHowFits
oneshot (first)claude -p per message, the prompt on stdin, --resume with the stored session id; nothing runs between messages (CON-58)Reliability, a hot reload, many idle tabs
sessionOne process per tab with --input-format stream-json, one result per message; ended after 10 idle minutes and at a hot reload, back with --resume (CON-59)Long work, if its first-event time turns out better

Which is the default is decided by measuring (Q-34).

What the harness keeps

Its memory and debug tools reach Claude Code through multitool mcp on stdio. The user's own hooks and servers should not run in the nested process (CON-61): --bare cannot be used for that, because it answers "Not logged in" (checked 2026-11-01, version 2.1.316).

What is open

Q-33, whether it may ship; Q-34, the default mode; Q-35, long sessions: who compacts and whether the log stays in step, memory when idle, a dropped pipe, limits.

This page's source