Skip to content

docs: document brew services usage #44

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
raine merged 1 commit into from
Jul 12, 2026
Merged

docs: document brew services usage #44

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,18 @@ upstream for each request is chosen from `ANTHROPIC_MODEL`. When stdout is a
terminal, `serve` opens a monitor TUI with sessions, active requests, recent
requests, and error events. Use `--no-monitor` for plain terminal output.

Installed via Homebrew, the proxy can also run as a background service that
starts at login and restarts if it exits:

```sh
brew services start claude-code-proxy
```

Service output goes to `~/.local/state/claude-code-proxy/service.log`,
alongside the proxy's own `proxy.log`. Provider logins are still a one-time
interactive step (e.g. `claude-code-proxy codex auth login`); the service
serves 401s until a token is stored.

### 4. Point Claude Code at it

`ANTHROPIC_MODEL` selects the provider:
Expand Down