claude-code-blocking-background

Claude Code Blocking Background

Use a native Codex subagent as the owner of the blocking MCP call. Do not create a separate user-owned Codex task and do not poll the MCP.

Delegate

1. Split out one concrete Claude task that can run independently. Do not delegate work whose result is required before any safe parent work can begin.
2. If the user asks which models are available, requests model selection, or supplies an uncertain model identifier, call claude_code_models once in the parent before spawning. Pass its returned value to the child. Model discovery is short and does not belong in the background subagent.
3. Spawn one native Codex subagent with a prompt that includes:
   • the complete task, working directory, scope, constraints, desired output, and requested Claude model;
   • an instruction to call claude_code_run exactly once through claude-code-blocking;
   • the minimum explicit allowedTools, askTools, and disallowedTools;
   • an instruction not to spawn another agent, not to poll, and to wait for the MCP call to return;
   • an instruction to report the result, terminal status, and sessionId without dropping material details.
4. Keep the returned subagent identifier.
5. Continue useful independent work in the parent agent. Do not immediately wait unless no independent work remains or the user asked only for the Claude result.
6. When the result becomes necessary, use Codex's native agent wait/mailbox primitive. Avoid repeated status narration or application-level polling.
7. Integrate the subagent's returned Claude result, clearly attributing it to Claude.

Suggested child instruction:

Call claude_code_run exactly once through the claude-code-blocking MCP for the task below. Do not spawn agents or poll. Wait for the blocking call to return, then report its result, status, and session ID.

Resume

To continue the same Claude session in the background, spawn or re-task a native subagent to call claude_code_resume exactly once with the prior sessionId. Keep the parent/child ownership and waiting pattern unchanged.