Skip to content

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

feat: support CLAUDE_CODE_USE_FOUNDRY and custom upstream gateways (#726)

yehsufd90cdce3b69b
diff --git a/headroom/cli/wrap.py b/headroom/cli/wrap.py
index 3e51e0eb3..b576b3c9e 100644
--- a/headroom/cli/wrap.py
+++ b/headroom/cli/wrap.py
@@ -184,6 +184,7 @@ def _start_proxy(
anyllm_provider: str | None = None,
region: str | None = None,
openai_api_url: str | None = None,
+ anthropic_api_url: str | None = None,
copilot_api_token: str | None = None,
) -> subprocess.Popen:
"""Start Headroom proxy as a background subprocess.
@@ -227,6 +228,9 @@ def _start_proxy(
if openai_api_url:
cmd.extend(["--openai-api-url", openai_api_url])
+ if anthropic_api_url:
+ cmd.extend(["--anthropic-api-url", anthropic_api_url])
+
log_path = _get_log_path()
log_file = open(log_path, "a") # noqa: SIM115
@@ -240,6 +244,8 @@ def _start_proxy(
proxy_env.setdefault("HEADROOM_STACK", f"wrap_{agent_type}")
if openai_api_url:
proxy_env["OPENAI_TARGET_API_URL"] = openai_api_url
+ if anthropic_api_url:
+ proxy_env["ANTHROPIC_TARGET_API_URL"] = anthropic_api_url
# Pin the wrapper-validated Copilot token for this proxy instance only.
# Injected into the subprocess env here (not the parent's os.environ) so it
# never leaks into shared state. The proxy's CopilotTokenProvider honours
@@ -1629,6 +1635,7 @@ def _ensure_proxy(
anyllm_provider: str | None = None,
region: str | None = None,
openai_api_url: str | None = None,
+ anthropic_api_url: str | None = None,
copilot_api_token: str | None = None,
) -> subprocess.Popen | None:
"""Start or verify proxy. Returns process handle if we started it."""
@@ -1783,6 +1790,7 @@ def _ensure_proxy(
anyllm_provider=anyllm_provider,
region=region,
openai_api_url=openai_api_url,
+ anthropic_api_url=anthropic_api_url,
copilot_api_token=copilot_api_token,
),
)
@@ -2272,8 +2280,20 @@ def claude(
click.echo(" ╚═══════════════════════════════════════════════╝")
click.echo()
+ # Detect Foundry mode: Claude Code uses ANTHROPIC_FOUNDRY_BASE_URL instead of
+ # ANTHROPIC_BASE_URL when CLAUDE_CODE_USE_FOUNDRY=1 is set.
+ foundry_upstream = None
+ if os.environ.get("CLAUDE_CODE_USE_FOUNDRY"):
+ foundry_upstream = os.environ.get("ANTHROPIC_FOUNDRY_BASE_URL")
+
proxy_holder[0] = _ensure_proxy(
- port, no_proxy, learn=learn, memory=memory, agent_type="claude", code_graph=code_graph
+ port,
+ no_proxy,
+ learn=learn,
+ memory=memory,
+ agent_type="claude",
+ code_graph=code_graph,
+ anthropic_api_url=foundry_upstream,
)
if not no_rtk:
@@ -2303,16 +2323,25 @@ def claude(
if code_graph:
_setup_code_graph(verbose=verbose)
+ proxy_url = _claude_proxy_base_url(port)
click.echo()
click.echo(" Launching Claude Code (API routed through Headroom)...")
- click.echo(f" ANTHROPIC_BASE_URL={_claude_proxy_base_url(port)}")
+ if foundry_upstream:
+ click.echo(
+ f" Foundry mode: ANTHROPIC_FOUNDRY_BASE_URL={proxy_url} → upstream {foundry_upstream}"
+ )
+ else:
+ click.echo(f" ANTHROPIC_BASE_URL={proxy_url}")
if claude_args:
click.echo(f" Extra args: {' '.join(claude_args)}")
_print_telemetry_notice()
click.echo()
env = os.environ.copy()
- env["ANTHROPIC_BASE_URL"] = _claude_proxy_base_url(port)
+ if foundry_upstream:
+ env["ANTHROPIC_FOUNDRY_BASE_URL"] = proxy_url
+ else:
+ env["ANTHROPIC_BASE_URL"] = proxy_url
result = subprocess.run([claude_bin, *claude_args], env=env)
raise SystemExit(result.returncode)
diff --git a/headroom/providers/registry.py b/headroom/providers/registry.py
index 1eff86be5..b6de4a039 100644
--- a/headroom/providers/registry.py
+++ b/headroom/providers/registry.py
@@ -100,7 +100,9 @@ def resolve_api_overrides(
"""Resolve provider API URL overrides from CLI/config inputs and environment."""
env = environ or os.environ
return ProviderApiOverrides(
- anthropic=anthropic_api_url or env.get("ANTHROPIC_TARGET_API_URL"),
+ anthropic=anthropic_api_url
+ or env.get("ANTHROPIC_TARGET_API_URL")
+ or env.get("ANTHROPIC_FOUNDRY_BASE_URL"),
openai=openai_api_url or env.get("OPENAI_TARGET_API_URL"),
gemini=gemini_api_url or env.get("GEMINI_TARGET_API_URL"),
cloudcode=cloudcode_api_url or env.get("CLOUDCODE_TARGET_API_URL"),