LAN Mode — Share with Family 🏠
Share your Claude Pro/Max subscription across your household. One machine runs OCP, everyone connects.
New Features
- 3-tier authentication — choose what fits your network:
none— trusted home network, no authshared— everyone uses one key (PROXY_API_KEY)multi— per-person API keys with individual usage tracking (recommended)
- Per-key usage tracking — SQLite-backed request logging (model, chars, latency, success)
- Web dashboard — real-time monitoring at
http://<ip>:3456/dashboard(dark theme, auto-refresh) - CLI key management —
ocp keys add/revoke,ocp lan,ocp usage --by-key - LAN bind —
CLAUDE_BIND=0.0.0.0exposes to local network - Zero external dependencies — switched from better-sqlite3 to Node.js built-in
node:sqlite
Security
- Timing-safe key comparison for all auth modes
- Admin key required for key management API
- Keys stored locally in
~/.ocp/ocp.db, never sent externally /healthand/dashboardalways public; all other endpoints respect auth mode
Quick Start (LAN)
# On the host machine
node setup.mjs --bind 0.0.0.0 --auth-mode multi
ocp keys add wife-laptop
ocp keys add son-ipad
ocp lan # shows your IP and ready-to-share instructionsNew CLI Commands
ocp keys List all API keys
ocp keys add <name> Create a new key
ocp keys revoke <name> Revoke a key
ocp lan Show LAN connection info
ocp usage --by-key Per-key usage breakdown
New API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/dashboard
| GET | Web dashboard |
/api/keys
| GET/POST | List or create API keys (admin) |
/api/keys/:id
| DELETE | Revoke a key (admin) |
/api/usage
| GET | Per-key usage stats |
New Environment Variables
| Variable | Default | Description |
|---|---|---|
CLAUDE_BIND
| 127.0.0.1
| Bind address (0.0.0.0 for LAN)
|
CLAUDE_AUTH_MODE
| none
| none / shared / multi
|
OCP_ADMIN_KEY
| (unset) | Admin key for key management |
Full Changelog: v3.3.1-stable...v3.4.0