Run the agent on Claude with your own key¶
New in 0.2
The hosted editor lets Claude drive the MCP server on your own Anthropic API key. It checks the dollar budget before every call and writes every call's cost to the ledger. When Claude refuses, the same run goes on with a local model.
You need the mcp, hf and hosted extras, and a key in the environment:
The key is read from ANTHROPIC_API_KEY only. It is never printed or written to the run directory, and the MCP server process does not get it. Your own agreement with Anthropic applies to the calls the editor makes on your key.
1. Write the run config¶
[run]
dir = "runs/hosted"
seed = 0
model_dir = "/path/to/model"
[limits]
forward_passes = 20
code_runs = 50
tokens = 2000000
dollars = 20.0
[editor]
kind = "hosted"
model = "claude-opus-5-5"
max_output_tokens = 16000
max_turns = 40
fallback_base_url = "http://127.0.0.1:8000"
fallback_model = "MODEL"
dollars: the run's dollar cap. Default 20.0 for the hosted editor. Set your own; it must be above 0, since a hosted run needs a dollar budget.model: a Claude model id with a price inastro_weights.mcp.editors.prices.PRICES(Reference). Any other id is refused before the run starts.max_output_tokens(default 16000) andmax_turns(default 40).fallback_base_urlandfallback_model: the OpenAI-compatible server and model that take over after a refusal; set it up as in How-to: run the agent on a local model. Orno_fallback = trueto end the run on a refusal. One of the two is required.
Every key is in Reference: CLI.
2. Run¶
How spend is capped¶
- Before each call the editor counts the prompt's tokens, adds 5%, and prices that prompt plus
max_output_tokensat the model's price. If that bound could take the run pastdollars, the call is not made and the run finishes with outcomedollar_cap. - After each call its tokens and dollars go to the ledger. A stream that breaks off mid-call is charged the full bound, since tokens may have been billed.
- Prices come from the Claude pricing page; the read date is in the
pricesmodule docstring. Check your own bill; the ledger is an estimate from that table.
Refusals¶
When Claude stops with a refusal, the refused turn is still charged, its partial output is dropped and the refusal category goes to record.jsonl. The fallback model then gets the same messages plus a note that it now drives the run, and goes on at $0. With no_fallback = true the run ends with outcome refused.
Exit codes: 0 the run finished (by the model, the turn cap, a spent budget or the dollar cap); 1 refused with no fallback, or a loop or API error (as JSON on stdout, key removed); 2 bad arguments, a bad run directory, an unknown model, a dollar limit of 0, an unset key or a server that did not start.
astro-weights run checks that ANTHROPIC_API_KEY is set and not empty before it writes anything.
Not tested: never run against the real API; the editor and astro-weights run with kind = "hosted" are tested with fakes only, no key, no network.