Claude Code. Any Model. The most powerful AI coding agent now speaks every language.
The wire reader: every request from the connection's wire
How claudish decides the API, URL, output-limit field, reasoning encoding, mode and speed of a request: from the catalog's per-connection
wireand the route registry, never from a model name. Read before touchingproviders/connection-*.ts,providers/wire-*.ts,providers/declared-wire.ts,ComposedHandlerstep 5w, an adapter's token or reasoning fields, or the advisor's Claude call.
Spec: Models Index ai-docs/claudish-wire-requirements.md (R1–R13) and
ai-docs/claudish-catalog-3.7.0.md. Plan and gap counts: ai-docs/reports/wire-reader-plan-20261012.md.
Why it exists
Catalog 3.7.0 (live 2026-10-08) changed what the model-level tokenParam and endpoints mean:
they now describe the model OWNER's direct connection only. claudish 10.4.1 applied the
model-level field to every chat body on every host, so GPT and Grok chat requests to gateways
carried max_output_tokens (a Responses-only field): about 150 chat connections on generation
g-20261012101007285-7770c36e; [email protected] answered 400. Before that, months of
regressions came from name rules (requiresResponsesApi, includes("codex"), OpenCode family
lists, effort ladders by gpt-5.x) being falsified by each new model release.
The pipeline
- Data (
all-models-cache.ts,catalog-client.ts). The refresh reads the slim model pages, the plans, andqueryModels?catalog=routes&generationId=<same>; a different generationId restarts the whole refresh once. A 3.7.0 cache is rejected whole if any mapped connection lacks a wire, names a missing route profile, or has a known API without a base URL — a partial wire table would send some requests from data and the rest from nothing. Reads are memoized by mtime and size: the request path reads the 2.7 MB file per request. - Connection (
connection-resolver.ts). The provider's exact route binding plus the exact wire id; never a family or sibling. It carries the wire, the registry profile, the model's VENDOR (catalogprovider) and the owner's direct-connection wire. - Handler (
wire-handler.ts, fromcreateHandlerForProviderbefore any profile). Adapter bywire.api, URL from the registry (a user base-URL override is kept and logged), the provider's own transport only for auth and identity headers (Codex keeps its credential-decided host: OAuth → chatgpt.com, API key → api.openai.com). - Request (
ComposedHandlerstep 5w →wire-request.ts). After every adapter has run, every field any of them may have emitted for the limit, reasoning, mode or speed is removed, then the wire's values are written at their RFC 6901 pointers.
Decisions (Jack, 2026-10-12) and where they diverge from the backend spec
| Topic | Backend spec | claudish |
|---|---|---|
Effort not in effort.values |
refuse | clamp to the nearest published value, ties up |
tokenParam / reasoning unknown |
send nothing | try the owner's direct-connection value when it is on the SAME API; drop exactly those borrowed fields on the 400 that names them (recoverBorrowedWireFields) |
wire.status: unknown, or model not published for the provider |
APIs in fixed order | same (TryInTurnHandler): advance only on 404/405/protocol-400, remember the winner per generation |
| No catalog | wait or fail | local providers only; catalog providers wait, then refuse per request (below) |
| Pro / speed | --mode, --speed suggested |
model+pro, model#fast |
not_applicable is an ANSWER, never borrowed over (Codex found the shaper treating it like
unknown). Mode and speed are never borrowed: they carry entitlement and price.
Output limit
The request's own max_tokens is sent unchanged, at the wire's tokenParam. When the request
has none (MCP run_prompt and compare_models send none), only an API that REQUIRES a limit
gets one: the Messages API (anthropic-messages) receives the catalog's maxOutputTokens for
the connection's model (ResolvedConnection.maxOutputTokens, written by step 5w through
WireChoices.catalogMaxOutputTokens). Chat Completions, Responses and Gemini are left to the
upstream's own default. The slim catalog publishes the ceiling per model, not per connection.
An unknown ceiling follows the same rule as an unknown tokenParam in the table above: send
nothing, never a pinned number. [Wire] logs "the catalog publishes no maxOutputTokens: none
sent". The adapter's old max_tokens || 4096 capped every Messages connection (minimax-m3
via minimax and opencode, qwen3.8-max via opencode) at 4096 output tokens wherever no
wire overwrote it. With no wire the adapter now fills from the same catalog field
(lookupModelMaxOutputTokens), or leaves the field out. On generation
g-20261016053727894-8a743761 6 of 58 Messages connections had no model maxOutputTokens, minimax-m3 among them.
Recommended effort
models-index publishes data.recommendations.efforts[modelId][taskType] = {effort, basis, sendableOn, ...} on ?catalog=recommended (2.3.0). The value is a canonical level (low …
max). getRecommendedModels writes it, normalised, to
~/.claudish/cloud-models-catalog-v3.efforts.json (providers/effort-recommendations.ts) for the
generation it read, before the top100 fetch, so a top100 failure cannot lose it.
claudish does not choose a task type. The agent that calls the claudish MCP tools already knows its task, so it chooses (Jack, 2026-10-22):
list_modelsappends the newest generation's table: a row per canonical model id, a column per task type.- The caller maps its task to a column and takes the cell for each model it runs. The models can come from the user or be fixed by the task; the lookup is the same.
- It passes one effort per model:
teamefforts: {"<model>": "<level>"}(keys exactly as inmodels),create_sessioneffort,run_prompteffort. teamandcreate_sessionappend claudish's own--effort-override <level>to the child's flags (afterclaude_flags, so it wins). The child's proxy pins that level on every request, as the flag always did.run_promptsendsoutput_config.effort, the field Claude Code sends, and step 5w maps it onto the connection's published levels.
A model with no entry keeps Claude Code's own effort, which is the behaviour from before.
A call with NO effort at all, while one of its models has a row, starts nothing and answers
needs_effort: with those rows (effortClarification, mcp-server.ts); efforts: {} or
effort: "default" keeps Claude Code's own level on purpose. Measured why (bench
recommended-effort run9, 2026-10-23): with exact model ids the calling agent went straight
to team / create_session in 16/16 sessions, never opened the claudish-usage skill (0/8
with the new skill) and passed no effort; the efforts parameter description alone did not
change that (run2, 0/6). When the user named only a family, it read list_models and matched
the table 8/8. list_models names no provider: its old Access line ([email protected]) was
copied into calls and bypassed routing (2 of 3 run9 failures). On a
bare Claude name the effort is ignored: the native passthrough and run_prompt's print path
never reach step 5w.
Rejected (built and removed on 2026-10-22): a task classifier inside the proxy that labelled
each user turn with one call to a lightweight model, plus --task, MCP task_type and plan-mode
and slash-command rules. It added about 1.7 s (median, 10 calls on cx@gpt-6-luna) before the
first request of every unlabelled turn, and it needed demotion rules, a timeout and user-set
effort detection. It guessed a fact that the calling agent already had. The work is kept in the
gitignored session dev-feature-recommended-effort-20261021-101332-a05a, under
backup-before-rework-*.
Traps
- Older claudish erases the registry. Releases before 10.5.0 rewrite
cloud-models-catalog-v3.jsonon every refresh withoutrouteRegistry(measured 2026-10-14: an installed 10.4.1 in another session replaced the cache with a newer generation). The registry therefore also lives in a sidecar,cloud-models-catalog-v3.routes.json, attached on read when its generation matches; when it does not,ensureRouteRegistryReadyfetches onlycatalog=routesfor the cache's generation (1.4 s live, against 9.3 s for a full refresh). - The first run after an upgrade. The old cache has no registry; the refresh that writes it
measured 9.3 s, and the request path first waited 5 s and refused. The proxy caches handlers
per model, so the refusal stuck for the whole session (
--probe gpt-6-solrefused cx@, oai@ and zen@ while grok-4.7, built after the refresh, answered). Now: 30 s wait, thenCatalogPendingHandler, which rebuilds per request and refuses only while the catalog is still missing. Never return a cached refusal for a transient state. +is ALSO the route-chain separator (teamspawnszgo@x+mm@y+or@z).parseModelChainattaches a segment that is only a mode word to the spec before it; real chain elements always contain@.-pro(102 ids) and-fast(22) are real model ids;>>and|are shell operators (an unquoted>>fastsilently redirects to a file).#is literal mid-word in bash and default zsh; with zshextendedglobit fails loudly ("no matches found").- Markers travel per request (
wireMarkerContext, AsyncLocalStorage), never in a cached handler or a body: the native passthrough forwards the body verbatim. - A name gate one layer down. Removing the dialect choice left two: the shared message
converter added the Grok tool prompt for any id containing "grok", and the Gemini
thought-signature middleware re-filtered itself by name after being selected from data. Both
now read the connection's vendor (
setUpstreamVendor,alwaysHandle). Search for the NAME check at every layer, not just the selector. - Codex's reasoning summary. The wire does not publish
reasoning.summary; the shaper drops the wholereasoningobject. Claude Code's visible thinking needs it, so the Codex transport restoressummary: "auto"where reasoning was sent. - Kimi Code
k3. Itsdisableis served by K2.8 Preview (served_model_changes). Reasoning stays on and the log says why, unless--accept-served-model(envCLAUDISH_ACCEPT_SERVED_MODEL=1) names the swap.
Off-catalog requests
- Custom endpoints declare their wire (
config-schema.tsCustomEndpointWireSchema); the documented default is the transport's API,max_tokens(max_output_tokenson Responses), no reasoning. They go through step 5w like a catalog connection (declared-wire.ts). LiteLLM and OpenRouter/Poe models the catalog does not publish get the same default. - Dynamic subscriptions (
gk@,ag@,dv@) publish no wire; the account decides what they serve. Onlygk@names a dialect, explicitly in its profile (Grok effort with learn-on-400). Nothing picks a dialect by model name any more;dialect-manager.tsserves local models only. One model quirk no wire field describes stays, keyed on the catalog VENDOR: aminimaxmodel on any connection gets the MiniMax dialect for its temperature clamp (its reasoning fields are overwritten by step 5w). Dropping it with the name dialects was caught in test review. - The advisor builds no request of its own for a routed panel member or collector: each runs
through the chain startup built for it, so
ComposedHandlerstep 5w shapes it from the connection'swirelike any main request (advisor.md, "Panel routing and billing"). The advisor sends only an Anthropic-shaped{model, system, messages, max_tokens: 2048, stream: false}into that chain. The one hand-built request is a Claude member's call to the fixedhttps://api.anthropic.com/v1/messages: on an API-key arm it is shaped by theanthropicconnection's wire when the catalog publishes one; on the Claude Code login arm it is the S0-measured body, with no wire shaping (claudeAdvisorRequestInit,handlers/native-handler-advisor.ts). There is no cold-catalog endpoint table any more. - Discovery (
model-discovery.ts) lists models from the registry base +/modelsfor a catalog-routed provider (OpenCode moved Zen toopencode.ai/inference/v1on 2026-10-12); a user base-URL override keeps the definition's path. - Vision with a connection reads the catalog's
inputModalities/supportsVision; unknown sends the image the user attached.
Verification on record
- 1770 mapped connections on generation
g-20261012101007285-7770c36e: every one carries a wire, every known API has a base URL, the registry covers every claudish route binding. - Intercepted end-to-end capture of 19 connections, each body exactly the wire's
(
ai-docs/sessions/…/p3-capture.ts, gitignored). - Live
--probe(2026-10-12): every funded hop answered —oai@gpt-6-solon/v1/responses,[email protected]on Responses,kc@onapi.kimi.ai,oc@onollama.com/v1with plain ids,qtoken@on the qwencloud host,[email protected]withmax_tokens. Zen and Together answered 402 (account funds). providers/no-name-rules.test.tsscans every non-test source file (NUL-safe:devin.tsandgrok-effort-support.tscontain NUL bytes) for the removed identifiers.