github dtzp555-max/ocp v3.4.0
v3.4.0 — LAN Mode

latest releases: v3.16.4, v3.16.3, v3.16.2...
one month ago

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 auth
    • shared — 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 managementocp keys add/revoke, ocp lan, ocp usage --by-key
  • LAN bindCLAUDE_BIND=0.0.0.0 exposes 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
  • /health and /dashboard always 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 instructions

New 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

Don't miss a new ocp release

NewReleases is sending notifications on new releases.