From 2a569e5827f899973647eafbe132c929adb196b7 Mon Sep 17 00:00:00 2001 From: Soham Dasgupta Date: Sun, 12 Jul 2026 23:48:12 +0530 Subject: [PATCH] document brew services usage The Homebrew formula gains a service block (raine/homebrew-claude-code-proxy#1); document starting the proxy as a background service alongside the existing foreground serve guidance. --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 3c65e553..723ea244 100644 --- a/README.md +++ b/README.md @@ -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: