# How SaneCode works (SaneCode docs)

> SaneCode is a Windows app that runs several Claude desktop accounts in one window. Each account is the official, unmodified Claude desktop app with its own data folder; SaneCode starts one per account and docks their windows beside its sidebar, so every account stays signed in. Free for 2 accounts; Pro ($29 once) for more. Not affiliated with Anthropic.

Page: https://sanecode.co/docs/how-sanecode-runs-multiple-claude-instances/
Markdown: https://sanecode.co/docs/how-sanecode-runs-multiple-claude-instances.md

## All SaneCode docs pages
- [Let Claude use SaneCode (MCP) and failover](https://sanecode.co/docs/let-claude-use-sanecode-mcp-failover/): SaneCode's own MCP server lets Claude see your accounts and their usage limits, carry a conversation on in another account when one runs out, schedule Continue after the reset, and report what happened while you were away. (Markdown: https://sanecode.co/docs/let-claude-use-sanecode-mcp-failover.md)
- [Use SaneCode from ChatGPT, Claude.ai and other AI apps](https://sanecode.co/docs/use-sanecode-from-chatgpt-claude-and-other-ai-apps/): Connect SaneCode's remote MCP server (mcp.sanecode.co) to ChatGPT, Claude.ai, Claude Code, Cursor, VS Code and other AI apps, so they can check your Claude accounts and move or schedule work on your PC. (Markdown: https://sanecode.co/docs/use-sanecode-from-chatgpt-claude-and-other-ai-apps.md)
- [Overview](https://sanecode.co/docs/): What SaneCode is and how it fits with Claude desktop. (Markdown: https://sanecode.co/docs/index.md)
- [How SaneCode works](https://sanecode.co/docs/how-sanecode-runs-multiple-claude-instances/): How SaneCode runs several Claude desktop accounts at once on Windows, where each account's data lives, what every account shares, what SaneCode changes on your PC, and how its settings connect. (Markdown: https://sanecode.co/docs/how-sanecode-runs-multiple-claude-instances.md)
- [Install and first run](https://sanecode.co/docs/install-sanecode-on-windows/): Install SaneCode and bring in the Claude you already use. (Markdown: https://sanecode.co/docs/install-sanecode-on-windows.md)
- [Add Claude accounts and sign in](https://sanecode.co/docs/add-claude-accounts-and-sign-in/): Add a second (or fifth) Claude account to SaneCode, sign in once with the built-in guide, and fix sign-ins that land in your other Claude. (Markdown: https://sanecode.co/docs/add-claude-accounts-and-sign-in.md)
- [Switching and windows](https://sanecode.co/docs/switch-claude-accounts-without-signing-out/): Shortcuts, popping out, chat tabs, and what happens when SaneCode closes. (Markdown: https://sanecode.co/docs/switch-claude-accounts-without-signing-out.md)
- [Layouts: Split, Grid and Canvas](https://sanecode.co/docs/claude-desktop-side-by-side-layouts/): See several Claude accounts or chats at once in SaneCode. Split and Grid are free, Canvas is Pro. Every control, what it does, and the limits. (Markdown: https://sanecode.co/docs/claude-desktop-side-by-side-layouts.md)
- [Continue a Claude conversation in another account after a usage limit](https://sanecode.co/docs/continue-claude-session-in-another-account/): When a Claude account hits its usage limit, move the Claude Code conversation to another of your accounts and keep going with the full context, no new chat, no re-explaining. (Markdown: https://sanecode.co/docs/continue-claude-session-in-another-account.md)
- [Continue after reset (Automations)](https://sanecode.co/docs/continue-claude-after-usage-limit-resets/): Send “Continue” or your own prompt to any Claude account's window, or to Codex, when its usage limit resets. Several at once, logged, without keeping the window in front. (Markdown: https://sanecode.co/docs/continue-claude-after-usage-limit-resets.md)
- [Shared MCP servers](https://sanecode.co/docs/share-mcp-servers-across-claude-accounts/): Set up an MCP server once in SaneCode and every Claude account gets it, instead of configuring it in each account. (Markdown: https://sanecode.co/docs/share-mcp-servers-across-claude-accounts.md)
- [Claude in Chrome for every account](https://sanecode.co/docs/claude-in-chrome-for-every-account/): Use Claude in Chrome from every Claude desktop account in one Chrome profile, without signing the extension out and in when you switch. (Markdown: https://sanecode.co/docs/claude-in-chrome-for-every-account.md)
- [Claude desktop and Claude Code themes](https://sanecode.co/docs/claude-desktop-and-claude-code-themes/): Change the theme of Claude desktop's Code tab in every account at once. SaneCode applies a Claude Code theme (colours and a background) with one setting, in light or dark mode, without modifying Claude. (Markdown: https://sanecode.co/docs/claude-desktop-and-claude-code-themes.md)
- [Claude Code plugins, skills, mods and MCP with several accounts](https://sanecode.co/docs/claude-code-plugins-and-skills-in-every-account/): Plugins and skills added in Claude desktop belong to one account; Claude Code's own .claude folder is one per PC. Which extensions every account shares, which stay per account, and how to set them up. (Markdown: https://sanecode.co/docs/claude-code-plugins-and-skills-in-every-account.md)
- [Settings](https://sanecode.co/docs/sanecode-settings/): Every setting and exactly what it changes. (Markdown: https://sanecode.co/docs/sanecode-settings.md)
- [Invite friends: $5 off Pro each](https://sanecode.co/docs/invite-friends-get-pro-discount/): Share your SaneCode referral link. Every friend who signs up and signs in from SaneCode takes $5 off your Pro, and gets $5 off theirs. Six friends make Pro free. (Markdown: https://sanecode.co/docs/invite-friends-get-pro-discount.md)
- [Claude updates and repair](https://sanecode.co/docs/claude-desktop-updates-and-repair/): What happens when Claude desktop updates, resets or is reinstalled. (Markdown: https://sanecode.co/docs/claude-desktop-updates-and-repair.md)
- [FAQ and troubleshooting](https://sanecode.co/docs/sanecode-faq-and-troubleshooting/): Common questions and fixes. (Markdown: https://sanecode.co/docs/sanecode-faq-and-troubleshooting.md)

## Questions people ask
- How do I add a second Claude account?
- How do I continue a Claude Code session in another account after a usage limit?
- How do I share my MCP servers with every Claude account?
- Does SaneCode change the Claude app or my sign-ins?

---

# How SaneCode works

**SaneCode runs the official [Claude desktop](https://claude.com/download) app once per account, all at the same time, and docks
each one's window into a single window.** Claude is installed once; each account gets its own copy
running with its own data folder. Switching accounts only changes which window you see. Nothing is
signed out, closed or swapped.

## What runs when SaneCode is open?

- **SaneCode** itself: the sidebar, title bar, settings and the blue screen.
- **One Claude desktop per running account.** They're the official app (from claude.com or the [Microsoft Store](https://support.claude.com/en/articles/10065433-installing-claude-for-desktop)),
  unmodified. SaneCode starts them with Claude's own data-folder option and two standard Chromium
  switches that keep a docked window drawing (`--disable-features=CalculateNativeWinOcclusion`,
  `--disable-backgrounding-occluded-windows`).
- Each Claude's window is moved into SaneCode's window (docked). When you close SaneCode, each
  window goes back on your desktop where it was, the same size, still running, unless you turned
  off **Settings → Keep Claude open when SaneCode closes**.

An account you haven't started isn't running at all, and shows SaneCode's blue screen until you
click **Start**.

## Where does each account's data live?

| Folder | What's in it |
| --- | --- |
| `%LOCALAPPDATA%\Claude-Profiles\<account>` | That account's Claude data: sign-in, settings, chats, Code session list |
| `%LOCALAPPDATA%\Claude-Profiles\_shared` | Claude's large virtual-machine files, stored once for all accounts |
| `%LOCALAPPDATA%\Claude-Data` | Links (Windows junctions) to the folders above, one per account |

Why the links: Claude desktop is a packaged Windows app that only writes real files inside its own folder,
`Claude-Data`. So each account starts from a link there that leads to its folder in
`Claude-Profiles`. The link named `claude_pzs8sxrjxfjjc` is the one Claude itself uses, so Claude
opened from the Start menu is your **main account**. More in
[Accounts](https://sanecode.co/docs/add-claude-accounts-and-sign-in/#how-does-sanecode-run-several-claude-accounts-at-once).

## What do all accounts share, and what stays separate?

| Shared by every account | Separate per account |
| --- | --- |
| The installed Claude desktop | Sign-in and plan |
| [Claude Code's settings](https://code.claude.com/docs/en/settings) in `%USERPROFILE%\.claude` | Chats and Code session list |
| SaneCode's [Claude theme](https://sanecode.co/docs/claude-desktop-and-claude-code-themes/) and other mods | Claude's own settings |
| | [Plugins and skills](https://sanecode.co/docs/claude-code-plugins-and-skills-in-every-account/) added in Claude desktop |
| | Connectors you add inside Claude |
| Code session conversations on disk ([continue one elsewhere](https://sanecode.co/docs/continue-claude-session-in-another-account/)) | Chat-side [MCP servers](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) (SaneCode's [Shared MCP](https://sanecode.co/docs/share-mcp-servers-across-claude-accounts/) list fills them in) |

## How do SaneCode's look settings connect to Claude?

Some settings change only SaneCode; some reach into every Claude. The connections:

| Setting | Changes in SaneCode | Changes in Claude |
| --- | --- | --- |
| **SaneCode window** (System / Light / Dark) | SaneCode's light or dark look | The **Ocean** and **Ocean colours** Claude themes follow it, so they always match |
| **Animate the blue screen** | The "sanecode" letters on SaneCode's blue screen drift, glow and ripple | The letters in the **Ocean** Claude theme drift too; off, they stay still in both |
| **Claude theme, in every account** | Nothing | Claude Code's look in every account ([themes](https://sanecode.co/docs/claude-desktop-and-claude-code-themes/)) |
| **Plain theme** (Pro) | White or dark sidebar and title bar instead of the blue | Nothing |
| **See-through buttons and tabs** | Buttons and tabs take on what's behind them | Nothing |
| **Size**, **Font** | SaneCode's own UI | Nothing: Claude keeps its own size and font |

Windows' own **Animation effects** setting (Settings → Accessibility → Visual effects), when off,
also keeps the letters in the Ocean Claude theme still, whatever SaneCode's setting says.

## Does anything animate while I work?

No. SaneCode's blue screen only animates while no Claude is on screen, and it stops entirely when
a Claude covers it. The logo animates once when SaneCode starts and when a window is opening.
The Ocean Claude theme's letters drift slowly behind the conversation if
**Animate the blue screen** is on; turn it off for a completely still Claude.

If SaneCode ever feels slow, **Plain theme** (Pro) is the lightest look, but the blue one is
built to cost little: its background is drawn once and reused.

## What does SaneCode change on my PC?

Everything it writes, and nothing else:

| Where | What | When |
| --- | --- | --- |
| `%APPDATA%\SaneCode\settings.json` | SaneCode's settings | When you change one |
| `%APPDATA%\SaneCode\logs\sanecode.log` | The [diagnostic log](https://sanecode.co/docs/sanecode-settings/#help), under ~4 MB, never sent | While it's on |
| `%APPDATA%\SaneCode\mcp.json` | Your shared MCP server list | When you edit it |
| `%APPDATA%\SaneCode\claude-look\` | The Claude theme (a [Claude Code mod](https://code.claude.com/docs/en/plugins)) | While a Claude theme is picked |
| `%LOCALAPPDATA%\Claude-Profiles\`, `Claude-Data\` | Account folders and their links | When you add or bring in an account |
| `%USERPROFILE%\.claude\settings.json` | Adds the theme folder to `CLAUDE_CODE_PLUGIN_DIRS` and turns on `CLAUDE_CODE_PLUGIN_DIR_WATCH`; leaves everything else as it was | When you pick a Claude theme; picking **Claude's own** takes the folder back out |
| Each account's `claude_desktop_config.json` | Adds the servers from your shared MCP list; your own servers stay | At start, and when you press **Apply** |

SaneCode never deletes anything inside an account's folder, writes every file in one step (write
beside, then rename). Over the network it only checks your plan and for updates at sanecode.co,
and, with Pro, syncs SaneCode's own settings ([what exactly](https://sanecode.co/docs/sanecode-faq-and-troubleshooting/#does-sanecode-collect-data-or-send-telemetry)). Links it opens (the website, the
Microsoft Store, Upgrade to Pro) open in your browser or the Store.

## What happens when Claude updates?

Claude updates itself as usual; SaneCode doesn't touch the app. If an update
or a reset replaces Claude's data folder link, SaneCode notices and offers **Repair**. See
[Claude updates and repair](https://sanecode.co/docs/claude-desktop-updates-and-repair/).

Related: [Accounts](https://sanecode.co/docs/add-claude-accounts-and-sign-in/) · [Settings](https://sanecode.co/docs/sanecode-settings/) · [FAQ](https://sanecode.co/docs/sanecode-faq-and-troubleshooting/)
