{"data":{"post":{"title":"Using an Opus 5.5 Subagent With Opus 4.6 as the Main Agent","subtitle":"","isPublished":true,"createdTime":"2026-11-15T00:00:00.000Z","lastModifiedTime":null,"license":null,"tags":["AI","Agent"],"category":"Programming","file":{"childMdx":{"excerpt":"Yesterday I shared a  post on X  showing how a Claude Opus 4.6 main agent paired with a Claude Opus…","code":{"body":"function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\n\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n\nconst layoutProps = {};\nreturn class MDXContent extends React.Component {\n  constructor(props) {\n    super(props);\n    this.layout = null;\n  }\n\n  render() {\n    const _this$props = this.props,\n          {\n      components\n    } = _this$props,\n          props = _objectWithoutProperties(_this$props, [\"components\"]);\n\n    return React.createElement(MDXTag, {\n      name: \"wrapper\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Yesterday I shared a `, React.createElement(MDXTag, {\n      name: \"a\",\n      components: components,\n      parentName: \"p\",\n      props: {\n        \"href\": \"https://x.com/realWeZZard/status/2121766783636119690\"\n      }\n    }, `post on X`), ` showing how a Claude Opus 4.6 main agent paired with a Claude Opus 5.5 subagent creates a classic `, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"p\"\n    }, `Confused Deputy`), ` problem in multi-agent systems. Readers in the replies asked a practical question: how do you spawn an Opus 5.5 subagent when your main Claude Code session runs on Opus 4.6?`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Ask the main agent to spawn `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `claude-opus-5-5`), ` on the fly in a prompt, and you hit a wall. Anthropic has tightened model selection across Claude Code's `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `Agent`), ` tool and context forking. Today, `, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"p\"\n    }, `the only reliable way to run an Opus 5.5 subagent under an Opus 4.6 main agent is to define a custom subagent in `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `.claude/agents/`), ` and pin its `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `model`), ` field to the Model ID `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `claude-opus-5-5`), `.`)), React.createElement(MDXTag, {\n      name: \"h2\",\n      components: components\n    }, `Model Name, Model Alias, and Model ID`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Claude Code's documentation distinguishes three terms that developers often conflate:`), React.createElement(MDXTag, {\n      name: \"table\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"thead\",\n      components: components,\n      parentName: \"table\"\n    }, React.createElement(MDXTag, {\n      name: \"tr\",\n      components: components,\n      parentName: \"thead\"\n    }, React.createElement(MDXTag, {\n      name: \"th\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Term`), React.createElement(MDXTag, {\n      name: \"th\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Purpose`), React.createElement(MDXTag, {\n      name: \"th\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Examples`), React.createElement(MDXTag, {\n      name: \"th\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Accepted in `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"th\"\n    }, `model`), ` Config?`))), React.createElement(MDXTag, {\n      name: \"tbody\",\n      components: components,\n      parentName: \"table\"\n    }, React.createElement(MDXTag, {\n      name: \"tr\",\n      components: components,\n      parentName: \"tbody\"\n    }, React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"td\"\n    }, `Model Name`)), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Human-readable product title shown in menus and documentation.`), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `Claude Opus 5.5`), `, `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `Claude Opus 4.6`)), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `No`)), React.createElement(MDXTag, {\n      name: \"tr\",\n      components: components,\n      parentName: \"tbody\"\n    }, React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"td\"\n    }, `Model Alias`)), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Dynamic shorthand that resolves to the latest default release in a tier.`), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `opus`), `, `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `sonnet`), `, `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `haiku`), `, `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `fable`)), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Yes (tracks latest version)`)), React.createElement(MDXTag, {\n      name: \"tr\",\n      components: components,\n      parentName: \"tbody\"\n    }, React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"td\"\n    }, `Model ID`)), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Immutable backend identifier pinned to one model snapshot.`), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `claude-opus-5-5`), `, `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"td\"\n    }, `claude-opus-4-6`)), React.createElement(MDXTag, {\n      name: \"td\",\n      components: components,\n      parentName: \"tr\",\n      props: {\n        \"align\": \"left\"\n      }\n    }, `Yes (in session flags and subagent frontmatter)`)))), React.createElement(MDXTag, {\n      name: \"ul\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `A Model Name is for humans alone:`), ` Configuration files and CLI flags reject `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `Claude Opus 5.5`), ` because the API expects a machine-readable identifier.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `A Model Alias is a moving target:`), ` `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus`), ` resolves to whichever Opus generation Claude Code sets as the default, so a single alias cannot pin two generations of the same family side by side.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `A Model ID pins a specific generation:`), ` Passing `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-4-6`), ` to the main session and `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-5-5`), ` to a custom subagent locks each layer to an exact model snapshot.`)), React.createElement(MDXTag, {\n      name: \"h2\",\n      components: components\n    }, `The Only Working Setup: A Predefined Custom Subagent`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Claude Code stores custom subagents as Markdown files with YAML frontmatter in `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `.claude/agents/`), ` (for one repository) or `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `~/.claude/agents/`), ` (across all projects). Unlike ad-hoc `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `Agent`), ` tool calls, the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `model`), ` field in subagent frontmatter accepts a full `, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"p\"\n    }, `Model ID`), `.`), React.createElement(MDXTag, {\n      name: \"h3\",\n      components: components\n    }, `Step 1: Define the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"h3\"\n    }, `opus-55`), ` Subagent`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Create `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `.claude/agents/opus-55.md`), ` (or `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `~/.claude/agents/opus-55.md`), `) and set `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `model`), ` to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `claude-opus-5-5`), `:`), React.createElement(MDXTag, {\n      name: \"pre\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"code\",\n      components: components,\n      parentName: \"pre\",\n      props: {\n        \"className\": \"language-markdown\"\n      }\n    }, `---\nname: opus-55\ndescription: Specialized Claude Opus 5.5 worker for deep technical analysis and implementation tasks.\nmodel: claude-opus-5-5\n---\n\nYou are a focused technical specialist running in an isolated subagent context.\nComplete the delegated engineering or analysis task and return a clear, structured result to the main agent.\n`)), React.createElement(MDXTag, {\n      name: \"ul\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `The `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `name`), ` field registers a named subagent type:`), ` A named agent lets the main session bypass generic context forking and dispatch work directly to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus-55`), `.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `The `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `model`), ` field pins the exact Model ID:`), ` `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `model: claude-opus-5-5`), ` overrides the parent session's `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-4-6`), ` model whenever `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus-55`), ` starts.`)), React.createElement(MDXTag, {\n      name: \"h3\",\n      components: components\n    }, `Step 2: Launch the Main Session on Opus 4.6`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Start Claude Code with the main session pinned to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `claude-opus-4-6`), `:`), React.createElement(MDXTag, {\n      name: \"pre\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"code\",\n      components: components,\n      parentName: \"pre\",\n      props: {\n        \"className\": \"language-bash\"\n      }\n    }, `claude --model claude-opus-4-6\n`)), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Inside an existing interactive session, `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `/model claude-opus-4-6`), ` switches the main model in place.`), React.createElement(MDXTag, {\n      name: \"h3\",\n      components: components\n    }, `Step 3: Delegate Work to the Predefined Subagent`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `From your `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `claude-opus-4-6`), ` session, instruct the main agent to delegate the task to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `opus-55`), `:`), React.createElement(MDXTag, {\n      name: \"pre\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"code\",\n      components: components,\n      parentName: \"pre\",\n      props: {\n        \"className\": \"language-text\"\n      }\n    }, `Use the opus-55 subagent to ... [write whatever you want here]\n`)), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `When Claude Code invokes `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `opus-55`), `, the main coordinator stays on `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `claude-opus-4-6`), ` while the subagent runs inside a fresh, isolated `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `claude-opus-5-5`), ` context window.`), React.createElement(MDXTag, {\n      name: \"h2\",\n      components: components\n    }, `Why Every Other Workaround Fails (Verified on Claude Code v2.1.325)`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Earlier versions of Claude Code let the built-in `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"p\"\n    }, `Agent`), ` tool switch models freely on the fly. Today, Claude Code blocks every zero-file workaround, including environment-variable alias overrides, or routes it back to the main agent's Opus model (Opus 4.6 in our example):`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"figure\",\n      components: components,\n      parentName: \"p\"\n    }, `\n    `, React.createElement(MDXTag, {\n      name: \"a\",\n      components: components,\n      parentName: \"figure\",\n      props: {\n        \"href\": \"/static/0e9229e5a86f8ae99fb47498a40c8825/08608/figure-1-subagent-routing.webp\"\n      }\n    }, React.createElement(MDXTag, {\n      name: \"picture\",\n      components: components,\n      parentName: \"a\"\n    }, `\n  `, React.createElement(MDXTag, {\n      name: \"source\",\n      components: components,\n      parentName: \"picture\",\n      props: {\n        \"src\": \"/static/0e9229e5a86f8ae99fb47498a40c8825/0cc25/figure-1-subagent-routing.png\",\n        \"srcSet\": [\"/static/0e9229e5a86f8ae99fb47498a40c8825/5116e/figure-1-subagent-routing.png 178w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/92f55/figure-1-subagent-routing.png 356w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/0cc25/figure-1-subagent-routing.png 712w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/7ae06/figure-1-subagent-routing.png 1068w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/eee47/figure-1-subagent-routing.png 1424w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/38407/figure-1-subagent-routing.png 2136w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/8ea0e/figure-1-subagent-routing.png 4440w\"],\n        \"sizes\": \"(max-width: 712px) 100vw, 712px\"\n      }\n    }), React.createElement(MDXTag, {\n      name: \"source\",\n      components: components,\n      parentName: \"picture\",\n      props: {\n        \"src\": \"/static/0e9229e5a86f8ae99fb47498a40c8825/690c8/figure-1-subagent-routing.webp\",\n        \"srcSet\": [\"/static/0e9229e5a86f8ae99fb47498a40c8825/25c8a/figure-1-subagent-routing.webp 178w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/60698/figure-1-subagent-routing.webp 356w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/690c8/figure-1-subagent-routing.webp 712w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/d7e52/figure-1-subagent-routing.webp 1068w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/456ef/figure-1-subagent-routing.webp 1424w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/2a654/figure-1-subagent-routing.webp 2136w\", \"/static/0e9229e5a86f8ae99fb47498a40c8825/08608/figure-1-subagent-routing.webp 4440w\"],\n        \"sizes\": \"(max-width: 712px) 100vw, 712px\"\n      }\n    }), `\n  `, React.createElement(MDXTag, {\n      name: \"img\",\n      components: components,\n      parentName: \"picture\",\n      props: {\n        \"src\": \"/static/0e9229e5a86f8ae99fb47498a40c8825/08608/figure-1-subagent-routing.webp\",\n        \"alt\": \"A horizontal routing diagram titled \",\n        \"subagent\": \"\",\n        \"model\": \"\",\n        \"routing\": \"\",\n        \"in\": \"\",\n        \"claude\": \"\",\n        \"code\": \"\",\n        \"(v2.1.325).\\\"\": \"\",\n        \"on\": \"\",\n        \"the\": \"\",\n        \"left,\": \"\",\n        \"a\": \"\",\n        \"main\": \"\",\n        \"session\": \"\",\n        \"coordinator\": \"\",\n        \"hub\": \"\",\n        \"running\": \"\",\n        \"claude-opus-4-6\": \"\",\n        \"branches\": \"\",\n        \"into\": \"\",\n        \"three\": \"\",\n        \"dispatch\": \"\",\n        \"paths.\": \"\",\n        \"path\": \"\",\n        \"a,\": \"\",\n        \"context\": \"\",\n        \"fork\": \"\",\n        \"(subagent_type:\": \"\",\n        \"\\\"fork\\\"),\": \"\",\n        \"copies\": \"\",\n        \"signed\": \"\",\n        \"thinking\": \"\",\n        \"blocks\": \"\",\n        \"and\": \"\",\n        \"lands\": \"\",\n        \"red\": \"\",\n        \"\\\"locked\": \"\",\n        \"to\": \"\",\n        \"parent\": \"\",\n        \"—\": \"\",\n        \"runs\": \"\",\n        \"opus\": \"\",\n        \"4.6\\\"\": \"\",\n        \"outcome.\": \"\",\n        \"b,\": \"\",\n        \"env\": \"\",\n        \"alias\": \"\",\n        \"override\": \"\",\n        \"(anthropic_default_opus_model),\": \"\",\n        \"spawns\": \"\",\n        \"built-in\": \"\",\n        \"@general-purpose\": \"\",\n        \"agent\": \"\",\n        \"also\": \"\",\n        \"c,\": \"\",\n        \"predefined\": \"\",\n        \"(.claude\": \"\",\n        \"agents\": \"\",\n        \"opus-55.md),\": \"\",\n        \"opens\": \"\",\n        \"clean\": \"\",\n        \"window\": \"\",\n        \"inside\": \"\",\n        \"highlighted\": \"\",\n        \"\\\"sole\": \"\",\n        \"working\": \"\",\n        \"escape\": \"\",\n        \"hatch\\\"\": \"\",\n        \"lane\": \"\",\n        \"reaches\": \"\",\n        \"green\": \"\",\n        \"\\\"pinned\": \"\",\n        \"id\": \"\",\n        \"5.5\\\"\": \"\",\n        \"(claude-opus-5-5)\": \"\",\n        \"outcome.\\\"\": \"\",\n        \"title\": \"Subagent Model Routing in Claude Code (v2.1.325)\",\n        \"width\": 712,\n        \"height\": 380,\n        \"loading\": \"lazy\"\n      }\n    }))), `\n    `, React.createElement(MDXTag, {\n      name: \"figcaption\",\n      components: components,\n      parentName: \"figure\"\n    }, `\n        `, React.createElement(MDXTag, {\n      name: \"span\",\n      components: components,\n      parentName: \"figcaption\"\n    }, `\n            Subagent Model Routing in Claude Code (v2.1.325)\n        `), `\n    `))), React.createElement(MDXTag, {\n      name: \"ul\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Prompting the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `Agent`), ` tool with a raw Model ID fails:`), ` Claude Code restricts per-invocation `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `model`), ` parameters on the built-in `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `Agent`), ` tool and blocks the calling LLM from passing versioned Model IDs such as `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-5-5`), ` at runtime.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Pinning the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"strong\"\n    }, `opus`), ` alias through environment variables fails:`), ` A tempting workaround launches Claude Code with `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `ANTHROPIC_DEFAULT_OPUS_MODEL=\"claude-opus-5-5\"`), ` (even paired with `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `CLAUDE_CODE_SUBAGENT_MODEL=\"claude-opus-5-5\"`), ` and `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `CLAUDE_CODE_FORK_SUBAGENT=0`), `), switches the main session to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `/model claude-opus-4-6`), `, and asks the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `Agent`), ` tool to spawn an `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus`), ` subagent.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Built-in subagents still inherit Opus 4.6:`), ` On Claude Code `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `v2.1.325`), `, asking the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `Agent`), ` tool to spawn an `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus`), ` subagent dispatches to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `@general-purpose`), ` and runs on `, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Opus 4.6`), ` (`, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `Agent(...) Opus 4.6`), `), ignoring the `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus`), ` alias override.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Generic subagent forks lock the parent model:`), ` When Claude Code forks the main agent's context (`, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `subagent_type: \"fork\"`), `), the child agent inherits the full conversation history and stays locked to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-4-6`), `.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Named custom subagents remain the only escape hatch:`), ` Invoking a predefined subagent from `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `.claude/agents/`), ` opens a clean context window and reads `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `model: claude-opus-5-5`), ` straight from frontmatter, bypassing both the fork lock and built-in `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `Agent`), ` inheritance.`)), React.createElement(MDXTag, {\n      name: \"h2\",\n      components: components\n    }, `Why Anthropic Locked Forked Contexts to the Same Model`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `Anthropic locks every forked context to its parent model—even within the Opus family—for two reasons: one cryptographic, one economic.`), React.createElement(MDXTag, {\n      name: \"ul\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Cryptographic thinking-block signatures block cross-model replay (Anti-Distillation):`), ` On frontier models such as Claude Opus 5.5, Anthropic omits raw chain-of-thought text by default (`, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `display: \"omitted\"`), `) and binds each thinking block to an encrypted cryptographic `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `signature`), ` to block chain-of-thought extraction, distillation, and cross-session replay.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Cross-model forks break signature verification:`), ` A forked subagent copies the parent conversation's signed thinking blocks verbatim; replaying Opus 4.6's thinking blocks into Opus 5.5—or forking an Opus 5.5 transcript into another model—fails model-bound signature checks and returns `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `400 Invalid signature in thinking block`), ` from the Messages API.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Prompt caching demands an exact per-model prefix match (Token Economics):`), ` Anthropic scopes its prompt cache per model and matches prefixes byte for byte, so switching models on a forked full-history session invalidates the cached transcript and re-bills every historical token from scratch.`)), React.createElement(MDXTag, {\n      name: \"h2\",\n      components: components\n    }, `How Clean-Context Delegation Creates the Confused Deputy`), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `The exact mechanism that makes this setup work—opting out of context forking into a fresh subagent window—also explains why pairing an Opus 4.6 main agent with an Opus 5.5 subagent creates a `, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"p\"\n    }, `Confused Deputy`), `:`), React.createElement(MDXTag, {\n      name: \"ul\",\n      components: components\n    }, React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Direct prompts expose the full intent to Opus 5.5:`), ` In a standalone `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-5-5`), ` session, dual-use security or reverse-engineering prompts keep the user's high-level goal and low-level technical steps inside one context window, where Opus 5.5's stricter safeguards evaluate the full trajectory and block the request.`), React.createElement(MDXTag, {\n      name: \"li\",\n      components: components,\n      parentName: \"ul\"\n    }, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"li\"\n    }, `Subagent delegation strips away upstream intent:`), ` When a `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `claude-opus-4-6`), ` main session accepts the user's request and delegates a scoped technical subtask to `, React.createElement(MDXTag, {\n      name: \"inlineCode\",\n      components: components,\n      parentName: \"li\"\n    }, `opus-55`), `, the predefined subagent starts with a clean slate and sees only a neutral, self-contained engineering prompt—never the upstream conversation that motivated it.`)), React.createElement(MDXTag, {\n      name: \"p\",\n      components: components\n    }, `That is a textbook `, React.createElement(MDXTag, {\n      name: \"strong\",\n      components: components,\n      parentName: \"p\"\n    }, `Confused Deputy`), ` in multi-agent systems. By locking full-history forks to the parent model while routing custom subagents into isolated context windows, Claude Code prevents cross-model thinking extraction—yet creates a clean context boundary that strips away the upstream intent signals single-session safeguards depend on.`));\n  }\n\n}\nMDXContent.isMDXComponent = true;","scope":""},"headings":[{"value":"Model Name, Model Alias, and Model ID","depth":2},{"value":"The Only Working Setup: A Predefined Custom Subagent","depth":2},{"value":"Step 1: Define the opus-55 Subagent","depth":3},{"value":"Step 2: Launch the Main Session on Opus 4.6","depth":3},{"value":"Step 3: Delegate Work to the Predefined Subagent","depth":3},{"value":"Why Every Other Workaround Fails (Verified on Claude Code v2.1.325)","depth":2},{"value":"Why Anthropic Locked Forked Contexts to the Same Model","depth":2},{"value":"How Clean-Context Delegation Creates the Confused Deputy","depth":2}]}}},"earlierPostExcerpt":{"slug":"/post/2026/07/j-space-reveals-how-examples-shape-model-behavior-fa92","title":"J-Space Reveals How Examples Shape Model Behavior","subtitle":"","createdTime":"2026-07-20T00:00:00.000Z","tags":["AI","Prompting","Interpretability"],"category":"Programming","file":{"childMdx":{"excerpt":"While tuning Claude's English output style, I kept hitting the same wall. I had already given it rules such as: Do not use jargon. Use plain, direct language. Do not invent terms unless you define them first. It still slipped back into jargon and ad-hoc coinages. When I asked Claude to check whether…"}}},"laterPostExcerpt":null},"pageContext":{"postId":"a3853bc6-7c91-5c95-afe2-8c4b8e6d1088","earlierPostId":"8fe704d3-5c7e-5ee8-b9d0-ba722673e025","laterPostId":null}}