multi-claude-cli 0.14.0__tar.gz → 0.16.0__tar.gz

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-claude-cli
-Version: 0.14.0
+Version: 0.16.0
 Summary: Run several Claude Code accounts side by side: separate CLAUDE_CONFIG_DIR directories, launchers, proxies, environment variables and arguments.
 License: MIT
 Project-URL: Homepage, https://github.com/jakoes-wu/multi-claude
@@ -11,6 +11,7 @@ Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -27,17 +28,18 @@ Dynamic: license-file
 
 # multi-claude
 
-**English** | [简体中文](README.zh-CN.md)
+**English** | [简体中文](https://github.com/jakoes-wu/multi-claude/blob/main/README.zh-CN.md)
 
 [![Release](https://img.shields.io/github/v/release/jakoes-wu/multi-claude)](https://github.com/jakoes-wu/multi-claude/releases)
 [![CI](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/multi-claude-cli)](https://pypi.org/project/multi-claude-cli/)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)
 
 Use several [Claude Code](https://code.claude.com/docs) accounts on one machine, at the same time. Each account keeps its own login, settings and history and, if you like, its own proxy. No more logging out and in again.
 
-It never copies or exports your login and never edits your shell startup files. Only `list` reads an account's access token and goes online, to ask Anthropic for the current plan (renewing the token first if it has expired); `list --offline` skips all of that.
+It never copies or exports your login and never edits your shell startup files. Only `list` reads an account's access token and goes online, to ask Anthropic for the current plan (renewing the token first if it has expired); `list --offline` skips all of that. `doctor --network` also goes online, but only when you ask for it and without any login.
 
 ```sh
 claude-work        # Claude Code with your work account
@@ -65,7 +67,7 @@ The launchers are plain shell scripts. They keep working even if you uninstall m
 ## Features
 
 - **Your login stays yours** — logins are never copied or exported. One command touches them: `list` takes each account's access token (from the keychain, or `.credentials.json` on Linux) to ask Anthropic which plan the account is on, and when that token has expired it renews it the way Claude Code does and saves the new one in the same place. Tokens stay in memory and go only to Anthropic (`api.anthropic.com`, and `platform.claude.com` for a renewal), through that account's proxy. `list --no-refresh` never writes, `list --offline` reads nothing. Every other command only checks whether a login exists. `migrate-default` and `restore` move whole account directories, and on Linux the credentials file moves with its directory without being opened.
-- **Only `list` goes online** — its plan lookup (one request per account, plus one to renew an expired token) is the only connection multi-claude makes: no telemetry, no usage reporting, no update checks. `list --offline` makes none. Only the installer, pipx or Homebrew download the package.
+- **Only `list` and `doctor --network` go online** — the plan lookup of `list` (one request per account, plus one to renew an expired token) and the connection check of `doctor --network` (one `HEAD /` without credentials to `api.anthropic.com` and `platform.claude.com` per proxy, repeated once if it fails) are the only connections multi-claude makes: no telemetry, no usage reporting, no update checks. `list --offline` makes none. Only the installer, pipx or Homebrew download the package.
 - **Leaves your shell alone** — when `PATH` needs a change, it prints the line to add instead of editing `~/.zshrc` or `~/.bashrc`.
 - **Changes only what you ask** — it writes its own configuration and state, the launchers, account directories (including the VS Code data that `code` keeps in `<root>/.apps`) and shared links. A Claude Code settings file is changed only by `statusline install` (the file you name, with a backup) and `add --config-from` (the new account's `settings.json`).
 - **Migrate the default account** — move your existing `~/.claude` into the account root without logging out. `claude` keeps working exactly as before.
@@ -78,13 +80,13 @@ The launchers are plain shell scripts. They keep working even if you uninstall m
 
 ## Prerequisites
 
-**Servers.** None. multi-claude runs only on your own computer; its only network requests are the plan lookups and token renewals of `list`, sent to Anthropic.
+**Servers.** None. multi-claude runs only on your own computer; its only network requests are the plan lookups and token renewals of `list` and the connection check of `doctor --network`, all sent to Anthropic.
 
 **Your computer.**
 
 | | Needed | Optional |
 | ---- | ---- | ---- |
-| Operating system | macOS or Linux (WSL counts as Linux) | — |
+| Operating system | macOS, Linux (WSL counts as Linux) or Windows | — |
 | Tools | Python 3.8+ (`python3`, standard library only); Claude Code (`claude`); `curl` or `wget`, and `tar`, for the installer | `pipx` or Homebrew, to install from PyPI or the tap; `lsof`, so that `migrate-default` and `restore` can find processes using `~/.claude` (Linux falls back to `/proc`); VS Code's `code` command, for `multi-claude code` |
 
 Install what is missing:
@@ -100,7 +102,16 @@ sudo apt install -y python3 curl tar lsof
 curl -fsSL https://claude.ai/install.sh | bash    # Claude Code, if you do not have it yet
 ```
 
-Windows itself is not supported yet; use WSL. Other ways to install Claude Code: https://code.claude.com/docs/en/setup
+On Windows, install Python 3.8+ from https://www.python.org/downloads/windows/ or the Microsoft Store, then in
+PowerShell:
+
+```powershell
+irm https://claude.ai/install.ps1 | iex    # Claude Code, if you do not have it yet
+python -m pip install --user pipx
+python -m pipx ensurepath                  # then open a new terminal
+```
+
+Other ways to install Claude Code: https://code.claude.com/docs/en/setup
 
 ## Installation
 
@@ -130,6 +141,49 @@ With Homebrew: `brew install jakoes-wu/tap/multi-claude` (upgrade with `brew upg
 
 Run `./install.sh --help` for all options.
 
+### Windows
+
+Windows support is new. Install it with pipx; the installer script is for macOS and Linux only. If `pipx` is not
+installed yet, run these in cmd or PowerShell (with Python 3.8 or later; use `python` instead of `py` if you do not
+have the Python launcher):
+
+```
+py -m pip install --user pipx
+py -m pipx ensurepath
+py -m pipx install multi-claude-cli
+```
+
+Then open a new terminal so the `PATH` change takes effect, and check with `multi-claude --version`. With pipx
+already on `PATH`, `pipx install multi-claude-cli` is enough. Everything above works the same way, with these
+differences:
+
+- Launchers are `claude-<name>.cmd` and `claude-auto.cmd` in `%USERPROFILE%\.local\bin` (the directory
+  `pipx ensurepath` adds to `PATH`), so they run from PowerShell and cmd alike. They read the proxy, variables
+  and arguments from the configuration each time they start, so a change takes effect without `apply`.
+- Account directories are in `%USERPROFILE%\.cc` and the configuration in `%APPDATA%\multi-claude`.
+- Shared directories are linked with directory junctions, which need no special rights. Sharing a single file
+  (such as `CLAUDE.md`) needs a file symbolic link, which needs Developer Mode (Settings > System > For
+  developers) or an administrator terminal; without it, `add` and `apply` stop and say so. Exclude the file
+  with `--shared-exclude` to share the rest.
+- `migrate-default` refuses while any Claude process is running: Windows does not let it see which account
+  another process uses. Close every Claude window, terminal and IDE first.
+- `statusline` needs Git for Windows, whose Git Bash is what Claude Code uses to run the status line. A
+  `statusLine` setting with `"shell": "powershell"` cannot be wrapped.
+- Paths containing `"`, `%` or `!` cannot be written into a `.cmd` launcher; `apply` reports such an account as
+  a conflict.
+- cmd reads a `.cmd` file in the console code page, so a launcher never contains non-ASCII characters. When the
+  Python or package path has them (for example a Chinese user name), the launcher writes it as
+  `%USERPROFILE%\...` (or `%LOCALAPPDATA%`, `%APPDATA%`), or else as its 8.3 short name. A non-ASCII path
+  that cannot be written with a variable and has no short name is reported as a conflict.
+- When Claude exits (Ctrl+C or `/exit`), cmd may flash "Terminate batch job (Y/N)?" for a moment: the launcher is
+  a batch file. It closes by itself; Claude has already exited and nothing is lost.
+- `multi-claude completion powershell | Add-Content $PROFILE` adds tab completion to PowerShell. Do not use `>>`:
+  Windows PowerShell 5.1 writes it as UTF-16 and breaks an existing profile. If the profile's directory does not
+  exist yet, create it first with `New-Item -ItemType Directory -Force (Split-Path $PROFILE)`.
+
+Continuous integration runs the Windows-specific tests on Windows (`tests/test_windows.py`); the rest of the test
+suite runs on macOS and Linux only.
+
 ## Quick start
 
 ### 1. Create one account per login
@@ -452,10 +506,13 @@ Notes:
 
 `multi-claude doctor` checks, without changing anything: the configuration and any unfinished migration, whether `claude` and the launcher directory are on `PATH`, whether each launcher is up to date and not hidden by another file of the same name, whether each account directory exists and is private (`0700`), the default account's link, broken shared links, whether a login exists, and variables such as `ANTHROPIC_API_KEY` that override the accounts' logins. Every problem comes with the command that fixes it. It exits with 1 when there is an error; `--json` prints the results for scripts.
 
+`multi-claude doctor --network` also checks that each account can reach `api.anthropic.com` and `platform.claude.com` through the proxy it starts with (including the `env` of its `settings.json`). It connects step by step and says where it stopped: the proxy is not running, the proxy cannot get through, a name does not resolve, the secure connection was cut, the certificate could not be verified, a timeout, or `NO_PROXY` sends the account around its proxy. SOCKS and malformed proxy URLs, which Claude Code cannot use, are reported without connecting; https proxies are not checked. It sends one `HEAD /` per address and proxy (a second one if the first fails), with no login or token; addresses covered by `NO_PROXY` are checked directly.
+
 ```sh
 multi-claude completion bash > ~/.local/share/bash-completion/completions/multi-claude
 multi-claude completion zsh > "${fpath[1]}/_multi-claude"   # or any directory on your fpath
 multi-claude completion fish > ~/.config/fish/completions/multi-claude.fish
+multi-claude completion powershell | Add-Content $PROFILE         # Windows PowerShell
 ```
 
 ## Migrating `~/.claude`
@@ -554,7 +611,7 @@ Every command's `--help` ends with examples you can copy, covering its options,
 | `multi-claude list [--verbose \| --json \| --names] [--no-refresh] [--offline]` | Show accounts, launchers, login state and the plan and billing channel looked up from Anthropic. `--json` adds usage and is meant for scripts; `--names` prints only the names; `--no-refresh` does not renew expired access tokens (never writes to a login); `--offline` skips the plan lookup (no token read, no network). A `RENEWS` column (and a `renews` key in `--json`) shows the renewal dates you recorded. |
 | `multi-claude usage [NAME] [--json]` | Show the last known 5-hour and 7-day usage of each account. |
 | `multi-claude usage --history [NAME] [--days N] [--by day\|model] [--json]` | Token usage per day or model, counted from the session files on this machine (default: 7 days). |
-| `multi-claude doctor [--json] [--verbose]` | Check the configuration, launchers, account directories, shared links, logins and environment. |
+| `multi-claude doctor [--json] [--verbose] [--network]` | Check the configuration, launchers, account directories, shared links, logins and environment; `--network` also checks each account's connection to Anthropic. |
 | `multi-claude route DIR NAME`, `route DIR --remove`, `route --default NAME`, `route --no-default` | Choose an account by directory for `claude-auto`. |
 | `multi-claude which [DIR]` | Show which account `claude-auto` would use in `DIR` (default: the current directory). |
 | `multi-claude rename OLD NEW` | Rename an account and its launcher. The directory and the login stay. |
@@ -577,13 +634,13 @@ Every write command accepts `--dry-run`, and prints only what changes; add `--ve
 | ---- | ---- |
 | Account directories | `~/.cc/<name>` |
 | Launchers | `~/.local/bin/claude-<name>` |
-| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`) |
+| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`); on Windows `%APPDATA%\multi-claude\config.json` |
 
 Account names may contain letters, digits and `._@+-`, must start with a letter or digit, and are case-insensitive (`Work` and `work` are the same account). An email address works as a name. Entries starting with `.` in the root directory are never treated as accounts.
 
 ### Declarative setup with `apply`
 
-See [`examples/config.example.json`](examples/config.example.json):
+See [`examples/config.example.json`](https://github.com/jakoes-wu/multi-claude/blob/main/examples/config.example.json):
 
 ```json
 {
@@ -644,7 +701,7 @@ This removes the tool only. Your configuration, account directories (including t
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md). Run the tests with:
+See [CONTRIBUTING.md](https://github.com/jakoes-wu/multi-claude/blob/main/CONTRIBUTING.md). Run the tests with:
 
 ```sh
 python3 -m unittest discover -s tests -t tests
@@ -652,4 +709,4 @@ python3 -m unittest discover -s tests -t tests
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/README.md

@@ -1,16 +1,17 @@
 # multi-claude
 
-**English** | [简体中文](README.zh-CN.md)
+**English** | [简体中文](https://github.com/jakoes-wu/multi-claude/blob/main/README.zh-CN.md)
 
 [![Release](https://img.shields.io/github/v/release/jakoes-wu/multi-claude)](https://github.com/jakoes-wu/multi-claude/releases)
 [![CI](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml/badge.svg)](https://github.com/jakoes-wu/multi-claude/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/multi-claude-cli)](https://pypi.org/project/multi-claude-cli/)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)
+![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)
 
 Use several [Claude Code](https://code.claude.com/docs) accounts on one machine, at the same time. Each account keeps its own login, settings and history and, if you like, its own proxy. No more logging out and in again.
 
-It never copies or exports your login and never edits your shell startup files. Only `list` reads an account's access token and goes online, to ask Anthropic for the current plan (renewing the token first if it has expired); `list --offline` skips all of that.
+It never copies or exports your login and never edits your shell startup files. Only `list` reads an account's access token and goes online, to ask Anthropic for the current plan (renewing the token first if it has expired); `list --offline` skips all of that. `doctor --network` also goes online, but only when you ask for it and without any login.
 
 ```sh
 claude-work        # Claude Code with your work account
@@ -38,7 +39,7 @@ The launchers are plain shell scripts. They keep working even if you uninstall m
 ## Features
 
 - **Your login stays yours** — logins are never copied or exported. One command touches them: `list` takes each account's access token (from the keychain, or `.credentials.json` on Linux) to ask Anthropic which plan the account is on, and when that token has expired it renews it the way Claude Code does and saves the new one in the same place. Tokens stay in memory and go only to Anthropic (`api.anthropic.com`, and `platform.claude.com` for a renewal), through that account's proxy. `list --no-refresh` never writes, `list --offline` reads nothing. Every other command only checks whether a login exists. `migrate-default` and `restore` move whole account directories, and on Linux the credentials file moves with its directory without being opened.
-- **Only `list` goes online** — its plan lookup (one request per account, plus one to renew an expired token) is the only connection multi-claude makes: no telemetry, no usage reporting, no update checks. `list --offline` makes none. Only the installer, pipx or Homebrew download the package.
+- **Only `list` and `doctor --network` go online** — the plan lookup of `list` (one request per account, plus one to renew an expired token) and the connection check of `doctor --network` (one `HEAD /` without credentials to `api.anthropic.com` and `platform.claude.com` per proxy, repeated once if it fails) are the only connections multi-claude makes: no telemetry, no usage reporting, no update checks. `list --offline` makes none. Only the installer, pipx or Homebrew download the package.
 - **Leaves your shell alone** — when `PATH` needs a change, it prints the line to add instead of editing `~/.zshrc` or `~/.bashrc`.
 - **Changes only what you ask** — it writes its own configuration and state, the launchers, account directories (including the VS Code data that `code` keeps in `<root>/.apps`) and shared links. A Claude Code settings file is changed only by `statusline install` (the file you name, with a backup) and `add --config-from` (the new account's `settings.json`).
 - **Migrate the default account** — move your existing `~/.claude` into the account root without logging out. `claude` keeps working exactly as before.
@@ -51,13 +52,13 @@ The launchers are plain shell scripts. They keep working even if you uninstall m
 
 ## Prerequisites
 
-**Servers.** None. multi-claude runs only on your own computer; its only network requests are the plan lookups and token renewals of `list`, sent to Anthropic.
+**Servers.** None. multi-claude runs only on your own computer; its only network requests are the plan lookups and token renewals of `list` and the connection check of `doctor --network`, all sent to Anthropic.
 
 **Your computer.**
 
 | | Needed | Optional |
 | ---- | ---- | ---- |
-| Operating system | macOS or Linux (WSL counts as Linux) | — |
+| Operating system | macOS, Linux (WSL counts as Linux) or Windows | — |
 | Tools | Python 3.8+ (`python3`, standard library only); Claude Code (`claude`); `curl` or `wget`, and `tar`, for the installer | `pipx` or Homebrew, to install from PyPI or the tap; `lsof`, so that `migrate-default` and `restore` can find processes using `~/.claude` (Linux falls back to `/proc`); VS Code's `code` command, for `multi-claude code` |
 
 Install what is missing:
@@ -73,7 +74,16 @@ sudo apt install -y python3 curl tar lsof
 curl -fsSL https://claude.ai/install.sh | bash    # Claude Code, if you do not have it yet
 ```
 
-Windows itself is not supported yet; use WSL. Other ways to install Claude Code: https://code.claude.com/docs/en/setup
+On Windows, install Python 3.8+ from https://www.python.org/downloads/windows/ or the Microsoft Store, then in
+PowerShell:
+
+```powershell
+irm https://claude.ai/install.ps1 | iex    # Claude Code, if you do not have it yet
+python -m pip install --user pipx
+python -m pipx ensurepath                  # then open a new terminal
+```
+
+Other ways to install Claude Code: https://code.claude.com/docs/en/setup
 
 ## Installation
 
@@ -103,6 +113,49 @@ With Homebrew: `brew install jakoes-wu/tap/multi-claude` (upgrade with `brew upg
 
 Run `./install.sh --help` for all options.
 
+### Windows
+
+Windows support is new. Install it with pipx; the installer script is for macOS and Linux only. If `pipx` is not
+installed yet, run these in cmd or PowerShell (with Python 3.8 or later; use `python` instead of `py` if you do not
+have the Python launcher):
+
+```
+py -m pip install --user pipx
+py -m pipx ensurepath
+py -m pipx install multi-claude-cli
+```
+
+Then open a new terminal so the `PATH` change takes effect, and check with `multi-claude --version`. With pipx
+already on `PATH`, `pipx install multi-claude-cli` is enough. Everything above works the same way, with these
+differences:
+
+- Launchers are `claude-<name>.cmd` and `claude-auto.cmd` in `%USERPROFILE%\.local\bin` (the directory
+  `pipx ensurepath` adds to `PATH`), so they run from PowerShell and cmd alike. They read the proxy, variables
+  and arguments from the configuration each time they start, so a change takes effect without `apply`.
+- Account directories are in `%USERPROFILE%\.cc` and the configuration in `%APPDATA%\multi-claude`.
+- Shared directories are linked with directory junctions, which need no special rights. Sharing a single file
+  (such as `CLAUDE.md`) needs a file symbolic link, which needs Developer Mode (Settings > System > For
+  developers) or an administrator terminal; without it, `add` and `apply` stop and say so. Exclude the file
+  with `--shared-exclude` to share the rest.
+- `migrate-default` refuses while any Claude process is running: Windows does not let it see which account
+  another process uses. Close every Claude window, terminal and IDE first.
+- `statusline` needs Git for Windows, whose Git Bash is what Claude Code uses to run the status line. A
+  `statusLine` setting with `"shell": "powershell"` cannot be wrapped.
+- Paths containing `"`, `%` or `!` cannot be written into a `.cmd` launcher; `apply` reports such an account as
+  a conflict.
+- cmd reads a `.cmd` file in the console code page, so a launcher never contains non-ASCII characters. When the
+  Python or package path has them (for example a Chinese user name), the launcher writes it as
+  `%USERPROFILE%\...` (or `%LOCALAPPDATA%`, `%APPDATA%`), or else as its 8.3 short name. A non-ASCII path
+  that cannot be written with a variable and has no short name is reported as a conflict.
+- When Claude exits (Ctrl+C or `/exit`), cmd may flash "Terminate batch job (Y/N)?" for a moment: the launcher is
+  a batch file. It closes by itself; Claude has already exited and nothing is lost.
+- `multi-claude completion powershell | Add-Content $PROFILE` adds tab completion to PowerShell. Do not use `>>`:
+  Windows PowerShell 5.1 writes it as UTF-16 and breaks an existing profile. If the profile's directory does not
+  exist yet, create it first with `New-Item -ItemType Directory -Force (Split-Path $PROFILE)`.
+
+Continuous integration runs the Windows-specific tests on Windows (`tests/test_windows.py`); the rest of the test
+suite runs on macOS and Linux only.
+
 ## Quick start
 
 ### 1. Create one account per login
@@ -425,10 +478,13 @@ Notes:
 
 `multi-claude doctor` checks, without changing anything: the configuration and any unfinished migration, whether `claude` and the launcher directory are on `PATH`, whether each launcher is up to date and not hidden by another file of the same name, whether each account directory exists and is private (`0700`), the default account's link, broken shared links, whether a login exists, and variables such as `ANTHROPIC_API_KEY` that override the accounts' logins. Every problem comes with the command that fixes it. It exits with 1 when there is an error; `--json` prints the results for scripts.
 
+`multi-claude doctor --network` also checks that each account can reach `api.anthropic.com` and `platform.claude.com` through the proxy it starts with (including the `env` of its `settings.json`). It connects step by step and says where it stopped: the proxy is not running, the proxy cannot get through, a name does not resolve, the secure connection was cut, the certificate could not be verified, a timeout, or `NO_PROXY` sends the account around its proxy. SOCKS and malformed proxy URLs, which Claude Code cannot use, are reported without connecting; https proxies are not checked. It sends one `HEAD /` per address and proxy (a second one if the first fails), with no login or token; addresses covered by `NO_PROXY` are checked directly.
+
 ```sh
 multi-claude completion bash > ~/.local/share/bash-completion/completions/multi-claude
 multi-claude completion zsh > "${fpath[1]}/_multi-claude"   # or any directory on your fpath
 multi-claude completion fish > ~/.config/fish/completions/multi-claude.fish
+multi-claude completion powershell | Add-Content $PROFILE         # Windows PowerShell
 ```
 
 ## Migrating `~/.claude`
@@ -527,7 +583,7 @@ Every command's `--help` ends with examples you can copy, covering its options,
 | `multi-claude list [--verbose \| --json \| --names] [--no-refresh] [--offline]` | Show accounts, launchers, login state and the plan and billing channel looked up from Anthropic. `--json` adds usage and is meant for scripts; `--names` prints only the names; `--no-refresh` does not renew expired access tokens (never writes to a login); `--offline` skips the plan lookup (no token read, no network). A `RENEWS` column (and a `renews` key in `--json`) shows the renewal dates you recorded. |
 | `multi-claude usage [NAME] [--json]` | Show the last known 5-hour and 7-day usage of each account. |
 | `multi-claude usage --history [NAME] [--days N] [--by day\|model] [--json]` | Token usage per day or model, counted from the session files on this machine (default: 7 days). |
-| `multi-claude doctor [--json] [--verbose]` | Check the configuration, launchers, account directories, shared links, logins and environment. |
+| `multi-claude doctor [--json] [--verbose] [--network]` | Check the configuration, launchers, account directories, shared links, logins and environment; `--network` also checks each account's connection to Anthropic. |
 | `multi-claude route DIR NAME`, `route DIR --remove`, `route --default NAME`, `route --no-default` | Choose an account by directory for `claude-auto`. |
 | `multi-claude which [DIR]` | Show which account `claude-auto` would use in `DIR` (default: the current directory). |
 | `multi-claude rename OLD NEW` | Rename an account and its launcher. The directory and the login stay. |
@@ -550,13 +606,13 @@ Every write command accepts `--dry-run`, and prints only what changes; add `--ve
 | ---- | ---- |
 | Account directories | `~/.cc/<name>` |
 | Launchers | `~/.local/bin/claude-<name>` |
-| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`) |
+| Configuration | `~/.config/multi-claude/config.json` (honours `XDG_CONFIG_HOME`); on Windows `%APPDATA%\multi-claude\config.json` |
 
 Account names may contain letters, digits and `._@+-`, must start with a letter or digit, and are case-insensitive (`Work` and `work` are the same account). An email address works as a name. Entries starting with `.` in the root directory are never treated as accounts.
 
 ### Declarative setup with `apply`
 
-See [`examples/config.example.json`](examples/config.example.json):
+See [`examples/config.example.json`](https://github.com/jakoes-wu/multi-claude/blob/main/examples/config.example.json):
 
 ```json
 {
@@ -617,7 +673,7 @@ This removes the tool only. Your configuration, account directories (including t
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md). Run the tests with:
+See [CONTRIBUTING.md](https://github.com/jakoes-wu/multi-claude/blob/main/CONTRIBUTING.md). Run the tests with:
 
 ```sh
 python3 -m unittest discover -s tests -t tests
@@ -625,4 +681,4 @@ python3 -m unittest discover -s tests -t tests
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/jakoes-wu/multi-claude/blob/main/LICENSE)

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/pyproject.toml

@@ -16,6 +16,7 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX :: Linux",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.8",

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/src/multi_claude/__init__.py

@@ -1,3 +1,3 @@
 """multi-claude：管理多个 Claude Code 账号的配置目录、启动命令、代理与启动参数。"""
 
-__version__ = "0.14.0"
+__version__ = "0.16.0"

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/src/multi_claude/__main__.py

@@ -7,6 +7,13 @@ if sys.argv[1:2] == ["statusline-hook"]:
     from .hook import main as hook_main
     sys.exit(hook_main(sys.argv[2:]))
 
+from . import platform  # noqa: E402
+
+# 闸门放在导入 cli 之前：不支持的平台上 cli 依赖的模块可能根本加载不了，要先给出一句能看懂的报错
+if not platform.is_supported():
+    sys.stderr.write("multi-claude: unsupported platform {}\n".format(sys.platform))
+    sys.exit(1)
+
 from .cli import main  # noqa: E402
 
 sys.exit(main())

multi_claude_cli-0.16.0/src/multi_claude/_entry.py

@@ -0,0 +1,43 @@
+"""Windows 启动命令（claude-<名称>.cmd、claude-auto.cmd）与状态栏后台进程的入口脚本。
+
+调用方式固定为 `"<python>" -I "<包目录>\\_entry.py" ...`（方案 feature-windows-support §5.1 D2）：
+- 用 `-I` 而不用 `-m`：`-m` 会把当前目录放进模块搜索路径，用户项目里的 json.py 之类文件会顶替标准库；
+  `-I` 也让脚本所在的包目录不进搜索路径，包里的 platform.py 等就不会顶替同名标准库模块。
+- `-I` 同时忽略 PYTHONPATH，源码检出里运行时解释器找不到本包，所以这里把包的上一级目录追加到搜索路径末尾。
+
+本文件只能用标准库，且必须在导入本包之前完成搜索路径的设置。
+"""
+
+import os
+import runpy
+import sys
+
+
+def _same_dir(a: str, b: str) -> bool:
+    # 启动命令里的路径可能是 8.3 短名（MULTI_~1），而包从解释器原有的长路径加载：
+    # 只比 normcase 会把同一目录判成两个。realpath 在 Windows 上会展开短名与链接。
+    if os.path.normcase(os.path.realpath(a)) == os.path.normcase(os.path.realpath(b)):
+        return True
+    try:
+        return os.path.samefile(a, b)
+    except OSError:
+        return False
+
+
+def _main() -> None:
+    package_dir = os.path.dirname(os.path.abspath(__file__))
+    parent = os.path.dirname(package_dir)
+    # 追加到末尾而不是插到最前：已安装的同名标准库模块仍优先于包目录之外的任何东西
+    if parent not in sys.path:
+        sys.path.append(parent)
+    import multi_claude
+    loaded = os.path.dirname(os.path.abspath(multi_claude.__file__))
+    if not _same_dir(loaded, package_dir):
+        # 解释器的 site-packages 里另装了一份 multi_claude：继续运行就是在用另一个版本
+        sys.stderr.write("multi-claude: loaded the package from {} instead of {}; reinstall multi-claude\n".format(
+            loaded, package_dir))
+        sys.exit(1)
+    runpy.run_module("multi_claude", run_name="__main__", alter_sys=True)
+
+
+_main()

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/src/multi_claude/accounts.py

@@ -53,6 +53,9 @@ def default_dir() -> str:
 
 
 def render_launcher(config: Config, account: Account) -> str:
+    if platform.IS_WINDOWS:
+        python, entry = launcher.windows_command_paths()
+        return launcher.render_windows(account.name, account_dir(config, account.name), python, entry)
     return launcher.render(account.name, account.identity, account_dir(config, account.name), default_dir(),
                            account.proxy, config.effective_env(account), config.effective_args(account))
 
@@ -169,6 +172,11 @@ def _plan_router(old: Config, new: Config) -> List[Action]:
         actions.append(Action(CONFLICT, "router", new_path, "claude-auto is the directory router; an account "
                                                              "named 'auto' cannot coexist with routes"))
 
+    if platform.IS_WINDOWS:
+        unsafe = launcher.cmd_unsafe_reason([], launcher.windows_command_paths())
+        if unsafe is not None:
+            actions.append(Action(CONFLICT, "router", new_path, unsafe))
+            return actions
     content = routes.render_router(new)
     kind = entry_kind(new_path)
     if kind == KIND_MISSING:
@@ -230,12 +238,18 @@ def _make_private_dir(directory: str) -> None:
     if not os.path.isdir(parent):
         os.makedirs(parent, mode=0o700)
     os.mkdir(directory, 0o700)
-    os.chmod(directory, 0o700)
+    # Windows 上 chmod 只能改只读属性，访问控制靠用户目录的 ACL
+    if not platform.IS_WINDOWS:
+        os.chmod(directory, 0o700)
 
 
 def _plan_launcher(bin_dir: str, config: Config, account: Account) -> List[Action]:
     name = account.name
     path = launcher.launcher_path(bin_dir, name)
+    if platform.IS_WINDOWS:
+        unsafe = launcher.cmd_unsafe_reason([account_dir(config, name)], launcher.windows_command_paths())
+        if unsafe is not None:
+            return [Action(CONFLICT, "launcher", path, unsafe)]
     content = render_launcher(config, account)
     kind = entry_kind(path)
     if kind == KIND_MISSING:
@@ -296,6 +310,12 @@ def execute(old: Config, new: Config, actions: List[Action], *, dry_run: bool, v
         return EXIT_CONFLICT
     if dry_run:
         return EXIT_OK
+    # Windows 上没有权限建文件链接时，在写配置之前就停下，免得配置已写、链接只建了一半（方案 C4）
+    file_links = shared.file_links_needed(actions) if platform.IS_WINDOWS else []
+    if file_links and not platform.can_create_file_link():
+        error(shared.file_link_message("the file links " + ", ".join(file_links),
+                                       sorted({os.path.basename(path) for path in file_links})), phase="shared-link")
+        return EXIT_ERROR
     config_action = actions[0]
     if config_action.changes:
         try:

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/src/multi_claude/artifacts.py

@@ -10,7 +10,6 @@ assistant 记录，结果写一行带 `tool_result` 块的 user 记录，发布
 这段字节的 SHA-256），查询时据此把副本里交接前的记录归回来源账号（§5.1.3）。
 """
 
-import fcntl
 import hashlib
 import json
 import os
@@ -244,13 +243,13 @@ def record_handoff(handoff: "sessions.Plan", source_account_dir: str, target_acc
     data = (json.dumps(entry, ensure_ascii=False, sort_keys=True) + "\n").encode("utf-8")
     path = log_path()
     os.makedirs(os.path.dirname(path), exist_ok=True)
-    fd = os.open(path, os.O_RDWR | os.O_APPEND | os.O_CREAT, 0o600)
+    fd = os.open(path, os.O_RDWR | os.O_APPEND | os.O_CREAT | getattr(os, "O_BINARY", 0), 0o600)
     try:
         # 阻塞等待：两个 handoff 同时追加时排队，不交错。锁的是本文件，不是工具的写锁（handoff 不拿写锁）
-        fcntl.flock(fd, fcntl.LOCK_EX)
+        platform.lock_fd(fd, blocking=True)
         # 只写描述符读不了末字节，所以上面用 O_RDWR 打开
         size = os.fstat(fd).st_size
-        if size and os.pread(fd, 1, size - 1) != b"\n":
+        if size and platform.read_at(fd, 1, size - 1) != b"\n":
             data = b"\n" + data
         view = memoryview(data)
         while view:
@@ -258,7 +257,7 @@ def record_handoff(handoff: "sessions.Plan", source_account_dir: str, target_acc
             view = view[written:]
         os.fsync(fd)
     finally:
-        # 关闭即释放 flock
+        # 关闭即释放锁（flock 与 msvcrt 字节锁都如此）
         os.close(fd)
 
 

{multi_claude_cli-0.14.0 → multi_claude_cli-0.16.0}/src/multi_claude/bundle.py

@@ -22,7 +22,7 @@ import time
 from datetime import datetime, timezone
 from typing import Dict, List, Optional, Tuple
 
-from . import __version__, accounts, usage
+from . import __version__, accounts, platform, usage
 from .actions import error, info, warn
 from .config import Account, Config
 from .fsutil import KIND_DIR, KIND_FILE, KIND_LINK, KIND_MISSING, atomic_write, entry_kind
@@ -114,10 +114,12 @@ def _create_temp(parent: str):
     for _attempt in range(100):
         path = os.path.join(parent, ".multi-claude-export.{}.tar.gz".format(os.urandom(6).hex()))
         try:
-            fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
+            fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL | getattr(os, "O_BINARY", 0), 0o600)
         except FileExistsError:
             continue
-        os.fchmod(fd, 0o600)  # 不受 umask 影响：包里可能有密钥，只给本人读
+        # 不受 umask 影响：包里可能有密钥，只给本人读。Windows 没有 fchmod，权限由用户目录的 ACL 保证
+        if hasattr(os, "fchmod"):
+            os.fchmod(fd, 0o600)
         return path, fd
     raise OSError("cannot create a temporary file in {}".format(parent))
 
@@ -132,7 +134,7 @@ def _publish(tmp_path: str, out_path: str) -> None:
         # 不支持硬链接的文件系统（如 exFAT）：再检查一次后改名
         if os.path.lexists(out_path):
             raise OSError("{} appeared while exporting; nothing was written".format(out_path))
-        os.replace(tmp_path, out_path)
+        platform.retry_on_sharing_violation(os.replace, tmp_path, out_path)
         return
     os.unlink(tmp_path)
 
@@ -350,7 +352,9 @@ def _check_item_types(members: List[tarfile.TarInfo]) -> None:
 def _check_member(member: tarfile.TarInfo) -> None:
     name = member.name
     parts = name.split("/")
-    if name.startswith("/") or "\\" in name or "\x00" in name or any(part in ("", ".", "..") for part in parts):
+    # Windows 上成员名里的冒号会被解析成盘符（C:x）或 NTFS 备用数据流（a:b），一律拒绝；POSIX 上冒号是普通字符
+    if (name.startswith("/") or "\\" in name or "\x00" in name or (platform.IS_WINDOWS and ":" in name)
+            or any(part in ("", ".", "..") for part in parts)):
         raise BundleError("unsafe path in bundle: {!r}".format(name))
     if not (member.isfile() or member.isdir()):
         raise BundleError("unsupported entry in bundle (only files and directories): {!r}".format(name))
@@ -453,9 +457,9 @@ def _apply(plan: _Plan, directory: str, staging: str, state_path: str) -> None:
         target = os.path.join(directory, item)
         if action == "replace":
             backup = _backup_name(target, stamp)
-            os.rename(target, backup)
+            platform.retry_on_sharing_violation(os.rename, target, backup)
             info("backup: {}".format(backup))
-        os.replace(os.path.join(staging, ITEMS_DIR, item), target)
+        platform.retry_on_sharing_violation(os.replace, os.path.join(staging, ITEMS_DIR, item), target)
     if data is None:
         return
     warn("Claude sessions of this account that are running keep their own copy of {} and may overwrite "