claude-share

Product Introduction

1. Definition: Claude-share is an open-source Command Line Interface (CLI) tool and local proxy server designed for the secure, controlled sharing of an Anthropic Claude Code subscription. It falls under the technical categories of subscription sharing utilities and secure proxy applications.
2. Core Value Proposition: This product exists to solve the problem of Claude Code usage limits by enabling a primary account holder to securely share their subscription quota with trusted individuals, maintaining full control and without exposing their sensitive API token. Its primary keywords are: Claude Code sharing, secure subscription sharing, CLI proxy for AI, and bypass Claude limits.

Main Features

1. Three-Command Simplicity: The entire workflow is executed through three terminal commands: npm install -g @0xpv/claude-share for installation, claude-share to generate a pairing link on the host machine, and claude-connect for the client to establish a connection. This minimalist CLI design ensures a low barrier to entry for technical users.
2. Secure Token Isolation Architecture: The core technical feature is a server-side MITM (Man-in-the-Middle) proxy that runs on the sharer's machine. It intercepts HTTPS traffic from the client's Claude CLI, terminates the TLS connection, and injects the sharer's legitimate Bearer token before forwarding the request to api.anthropic.com. This architecture ensures the client's machine never sees or handles the actual API token, providing critical security.
3. Flexible Connectivity Modes: The tool supports optimal performance on a Local Area Network (LAN) and offers an experimental public tunneling mode via bore.pub for remote connections. It includes a port detector and sniffer to route traffic correctly and enforces TLS connections, rejecting plain HTTP/CONNECT requests with a 426 status code to maintain security.

Problems Solved

1. Pain Point: It directly addresses the frustration of hitting the Claude Code subscription's usage limit ("You've hit your limit · resets 11:59pm"), allowing teams or friends to pool resources from a single paid account without constant context switching or access denial.
2. Target Audience: Primary users are software developers, engineers, and technical teams who are heavy users of Claude Code for programming assistance, are comfortable with CLI tools, and wish to share a subscription within a trusted circle. Secondary users are students or researchers collaborating on technical projects.
3. Use Cases: Essential for a development team sharing a single organizational Claude Code subscription to reduce costs. Critical for a mentor sharing their Claude Code access with a mentee for real-time coding guidance. Useful for friends collaborating on a coding project who want to use a single, higher-tier subscription for consistent performance.

Unique Advantages

1. Differentiation: Unlike simple token sharing (which is insecure and violates terms of service) or using a shared account, claude-share provides a technical proxy layer that keeps the credential on the owner's machine. It offers more control than informal sharing methods, as the owner can instantly revoke access by shutting down the local proxy process.
2. Key Innovation: The specific innovation is the client-side TLS termination and server-side token injection model. This approach is superior to forwarding a token because it allows the host to maintain a whitelist, implement rate limiting per client, and theoretically audit usage—all while the client uses the standard claude CLI without modification.

Frequently Asked Questions (FAQ)

1. Is claude-share safe to use with my Claude API token? The architecture is designed for security by ensuring your API token never leaves your host machine; it is injected server-side by the local proxy. However, you must trust the individuals you share with, as the proxy on your machine can technically intercept all chat traffic.
2. Does using claude-share violate Anthropic's Terms of Service? The tool is an independent open-source project and is not affiliated with Anthropic. Sharing a subscription likely violates the Claude Code terms of service. Users assume all risk regarding their account status when using this utility.
3. What are the system requirements for claude-share? The CLI tool requires Node.js/npm and is compatible with macOS, Linux, and Windows Subsystem for Linux (WSL). The host machine must remain awake and online to act as the proxy server for connected clients.
4. How do I stop someone from using my shared Claude access? Access control is immediate and manual. You simply quit the claude-share process on your host machine. This shuts down the proxy server and instantly disconnects all clients, as their traffic can no longer be routed and authenticated.
5. Can I use claude-share to share access with someone not on my local network? Yes, through an experimental public tunnel feature powered by bore.pub. This creates a public URL that forwards traffic to your local proxy, allowing remote connections, though with potential latency and the experimental caveat.