# claude-subs

Run two (or more) Claude subscriptions in Claude Code with ONE workspace. Your CLAUDE.md, skills,
commands, agents, hooks, settings, memory and chat history are shared. Only the login is different.

No proxy. Each account signs in through Anthropic's own login page, which is what Anthropic's
Claude Code terms allow. Proxies that hold your login tokens are not allowed (details in SKILL.md).

## What you get

- `claude-a`: your main account (plain `claude` still works the same)
- `claude-b`: your second account, same brain
- `claude-auto`: starts whichever account has more room left
- A status line that shows `[A]` or `[B]`, so you always know which plan you are burning
- The pivot: when a limit hits, type `/exit`, then `claude-b -c`. The same chat keeps going.

## Install (about 3 minutes)

1. Put this folder at `~/.claude/skills/claude-subs` (or anywhere, see the prompt below).
2. Open Claude Code and paste this:

```
Set up a second Claude subscription in Claude Code for me with the claude-subs skill.
The skill folder is at ~/Downloads/claude-subs (install it to ~/.claude/skills/claude-subs
if it is not there yet). Follow its SKILL.md from start to finish: preflight, install,
set up account b, walk me through the one browser sign-in, then verify everything and
show me how to use it.
```

Claude does everything except one step: you sign in to your second account in the browser.
Make sure the page shows your SECOND email (switch account, or use a private window).

You need a second Pro or Max plan on a different email first.

## By hand, without the skill

```bash
mkdir -p ~/.local/bin && cp scripts/claude-sub ~/.local/bin/ && chmod +x ~/.local/bin/claude-sub
claude-sub setup b        # links, shell commands, status line
claude-sub login b        # in a NEW terminal tab; pick the second account in the browser
claude-sub doctor         # health check
```

## Daily use

```bash
claude-auto               # start on whichever account has room
claude-b                  # or pick one
claude-sub status         # both accounts: email, 5-hour and weekly use
claude-b -c               # after /exit: continue the same chat on account b
claude-sub exec b -p "…"  # scripts and cron on account b (bills the plan, not an API key)
```

## Separate per account

claude.ai connectors (Gmail, Calendar, Drive...), Artifacts, Remote Control and the Claude app's
session list follow each login. Connect the connectors you need on claude.ai while signed in as
the second account. MCP servers with their own login need one `/mcp` sign-in on the new account.

## Undo

```bash
claude-sub uninstall b    # signs b out, moves ~/.claude-b aside, restores your shell and status line
```

## Requirements

macOS or Linux (Windows: inside WSL), Claude Code 2.x (`claude update`), Python 3.8+,
zsh or bash for the shell commands.

Tested on macOS with Claude Code 2.1.283 (Python 3.9, zsh and bash) and on Debian Linux
(Python 3.11, bash), September 2026.
