# claude-bridge

A **subscription-safe bridge** that lets a primary **Claude Code (Opus 4.8, on Pro/Max)**
session drive a **secondary Claude agent running a different model** via its own
`ANTHROPIC_BASE_URL` — without ever putting a proxy on the primary session.

Sibling of [`crush-bridge`](https://git.ltms.dev/systems/vms) (which drives a headless
**Crush** worker on GX10 DeepSeek). `claude-bridge` keeps the worker a *real Claude Code
process*, so it inherits `CLAUDE.md`, hooks, skills, and MCP — just pointed at a
cheaper/local model.

## Leading approach — AgentAPI

[`coder/agentapi`](https://github.com/coder/agentapi) wraps the Claude Code **CLI** as an
HTTP server (`POST /message`, `GET /messages`, `GET /events` SSE, `GET /status`). The
worker's model is whatever env its wrapped `claude` process launches with — so the worker
server runs with `ANTHROPIC_BASE_URL=https://ollama.ltms.dev` + a bearer token, and the
primary Opus session talks to it over HTTP.

```
  Opus (Claude Code, subscription, env CLEAN)
        │  HTTP  POST /message ─┐
        ▼                       ▼
  agentapi server  ──launches──►  claude  (ANTHROPIC_BASE_URL=ollama.ltms.dev, worker model)
        ▲  GET /events (SSE) ◄──┘
```

- **Subscription boundary:** the *primary* never sets `ANTHROPIC_BASE_URL` (stays on
  Pro/Max). Only the *secondary* process is off-subscription.
- **Different model per process** sidesteps Claude Code's lack of per-subagent provider
  routing — the worker isn't a subagent, it's its own configured process.

## Docs

Full design, setup, and operations live in the **[wiki](https://git.ltms.dev/lms/claude-bridge/wiki)**,
vendored here as a submodule under [`wiki/`](./wiki):

```bash
git clone --recurse-submodules ssh://git@git.ltms.dev:2224/lms/claude-bridge.git
# or, after a plain clone:
git submodule update --init
```

Edit docs in `wiki/`, then `cd wiki && git commit && git push` to publish them to the
Gitea wiki.

## Status

🟡 Planning — AgentAPI selected as the primary approach (2026-07-08).