multi-claude-cli 0.5.0__tar.gz → 0.6.0__tar.gz

{multi_claude_cli-0.5.0/src/multi_claude_cli.egg-info → multi_claude_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-claude-cli
-Version: 0.5.0
+Version: 0.6.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
@@ -286,6 +286,22 @@ multi-claude add client-b --config-from work # start client-b with a copy of wor
 
 `--config-from` copies `settings.json` once; afterwards the two files are independent. A different existing `settings.json` in the new account, or a `settings.json` that the account shares, is a conflict and nothing is changed. Use [shared resources](#shared-resources) for settings that should stay the same in every account.
 
+### Opening VS Code for an account (experimental)
+
+```sh
+multi-claude code work ~/projects/app             # a separate VS Code window for work
+multi-claude code personal . -- --disable-gpu     # arguments after -- go to VS Code
+```
+
+The Claude Code extension uses the `CLAUDE_CONFIG_DIR` of the environment VS Code was started with, so a VS Code opened from the Dock always uses `~/.claude`. `code` starts VS Code with the account's environment (the same as `run`) and a separate user data directory, `<root>/.apps/<account directory>/vscode`. A separate user data directory is required: otherwise VS Code hands the request to the instance that is already running, with its own environment. Each account's instance starts with default VS Code settings; extensions are shared because they live in `~/.vscode/extensions`.
+
+Notes:
+
+- If an instance for the account is already running, the request goes to it; changes to the proxy or environment variables apply after that instance quits.
+- Setting `CLAUDE_CONFIG_DIR` in the extension's `claudeCode.environmentVariables` inside that instance overrides the account.
+- On macOS the `code` command passes the whole environment to `open --env`, so the values are briefly visible in the process list.
+- Verified with VS Code 1.139.1 and Claude Code extension 2.1.286 on macOS; `code` prints a warning because it relies on undocumented behaviour. It needs the `code` command on `PATH` (in VS Code: "Shell Command: Install 'code' command in PATH").
+
 ### Diagnostics and completion
 
 `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.
@@ -389,6 +405,7 @@ No. It never reads, copies or deletes credentials; its only keychain call checks
 | `multi-claude mcp NAME [ARG ...]` | Run `claude mcp ARG ...` as that account. |
 | `multi-claude run [NAME] [-- COMMAND ...]` | Run a command (default: `claude` with the fixed arguments) with the environment of the account's launcher. Without NAME, the account `claude-auto` would use. |
 | `multi-claude path NAME` | Print the account's directory. |
+| `multi-claude code NAME [PATH] [-- ARGS ...]` | Open a separate VS Code instance with the account's environment (experimental). |
 | `multi-claude handoff TARGET [--from NAME] [--session ID] [--force]` | Copy a session to another account and print the command that resumes it there. |
 | `multi-claude statusline install\|uninstall FILE` | Wrap the statusLine command in a settings file so that `usage` gets fresh numbers, or restore it. |
 | `multi-claude completion bash\|zsh\|fish` | Print a shell completion script. |
@@ -464,7 +481,7 @@ If you move an account directory yourself, its launcher reports that the directo
 ./install.sh --uninstall
 ```
 
-This removes the tool only. Your configuration, account directories, logins and `claude-<name>` launchers stay; the launchers keep working because they do not depend on multi-claude. Run `multi-claude statusline uninstall FILE` first if you wrapped a status line.
+This removes the tool only. Your configuration, account directories (including the VS Code data in `<root>/.apps` created by `code`), logins and `claude-<name>` launchers stay; the launchers keep working because they do not depend on multi-claude. Run `multi-claude statusline uninstall FILE` first if you wrapped a status line.
 
 ## Contributing
 

{multi_claude_cli-0.5.0 → multi_claude_cli-0.6.0}/README.md

@@ -259,6 +259,22 @@ multi-claude add client-b --config-from work # start client-b with a copy of wor
 
 `--config-from` copies `settings.json` once; afterwards the two files are independent. A different existing `settings.json` in the new account, or a `settings.json` that the account shares, is a conflict and nothing is changed. Use [shared resources](#shared-resources) for settings that should stay the same in every account.
 
+### Opening VS Code for an account (experimental)
+
+```sh
+multi-claude code work ~/projects/app             # a separate VS Code window for work
+multi-claude code personal . -- --disable-gpu     # arguments after -- go to VS Code
+```
+
+The Claude Code extension uses the `CLAUDE_CONFIG_DIR` of the environment VS Code was started with, so a VS Code opened from the Dock always uses `~/.claude`. `code` starts VS Code with the account's environment (the same as `run`) and a separate user data directory, `<root>/.apps/<account directory>/vscode`. A separate user data directory is required: otherwise VS Code hands the request to the instance that is already running, with its own environment. Each account's instance starts with default VS Code settings; extensions are shared because they live in `~/.vscode/extensions`.
+
+Notes:
+
+- If an instance for the account is already running, the request goes to it; changes to the proxy or environment variables apply after that instance quits.
+- Setting `CLAUDE_CONFIG_DIR` in the extension's `claudeCode.environmentVariables` inside that instance overrides the account.
+- On macOS the `code` command passes the whole environment to `open --env`, so the values are briefly visible in the process list.
+- Verified with VS Code 1.139.1 and Claude Code extension 2.1.286 on macOS; `code` prints a warning because it relies on undocumented behaviour. It needs the `code` command on `PATH` (in VS Code: "Shell Command: Install 'code' command in PATH").
+
 ### Diagnostics and completion
 
 `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.
@@ -362,6 +378,7 @@ No. It never reads, copies or deletes credentials; its only keychain call checks
 | `multi-claude mcp NAME [ARG ...]` | Run `claude mcp ARG ...` as that account. |
 | `multi-claude run [NAME] [-- COMMAND ...]` | Run a command (default: `claude` with the fixed arguments) with the environment of the account's launcher. Without NAME, the account `claude-auto` would use. |
 | `multi-claude path NAME` | Print the account's directory. |
+| `multi-claude code NAME [PATH] [-- ARGS ...]` | Open a separate VS Code instance with the account's environment (experimental). |
 | `multi-claude handoff TARGET [--from NAME] [--session ID] [--force]` | Copy a session to another account and print the command that resumes it there. |
 | `multi-claude statusline install\|uninstall FILE` | Wrap the statusLine command in a settings file so that `usage` gets fresh numbers, or restore it. |
 | `multi-claude completion bash\|zsh\|fish` | Print a shell completion script. |
@@ -437,7 +454,7 @@ If you move an account directory yourself, its launcher reports that the directo
 ./install.sh --uninstall
 ```
 
-This removes the tool only. Your configuration, account directories, logins and `claude-<name>` launchers stay; the launchers keep working because they do not depend on multi-claude. Run `multi-claude statusline uninstall FILE` first if you wrapped a status line.
+This removes the tool only. Your configuration, account directories (including the VS Code data in `<root>/.apps` created by `code`), logins and `claude-<name>` launchers stay; the launchers keep working because they do not depend on multi-claude. Run `multi-claude statusline uninstall FILE` first if you wrapped a status line.
 
 ## Contributing
 

{multi_claude_cli-0.5.0 → multi_claude_cli-0.6.0}/src/multi_claude/__init__.py

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

{multi_claude_cli-0.5.0 → multi_claude_cli-0.6.0}/src/multi_claude/cli.py

@@ -56,6 +56,7 @@ COMMAND_GROUPS = [
         ("handoff", "copy a session to another account"),
         ("mcp", "run `claude mcp` as an account"),
         ("run, path", "run any command as an account; print its directory"),
+        ("code", "open VS Code for an account (experimental)"),
     ]),
     ("Setup and checks", [
         ("init, apply", "global settings; converge everything to config.json"),
@@ -217,6 +218,12 @@ def build_parser() -> argparse.ArgumentParser:
     p_path = sub.add_parser("path", description="print the directory of an account")
     p_path.add_argument("name")
 
+    # code 的 VS Code 参数与 run 一样，在 argparse 之前从第一个 `--` 处切走。
+    p_code = sub.add_parser("code", description="open a separate VS Code instance with the environment of an "
+                                                "account (experimental): code NAME [PATH] [-- CODE_ARGS ...]")
+    p_code.add_argument("name")
+    p_code.add_argument("path", nargs="?", metavar="PATH")
+
     p_restore = sub.add_parser("restore", description="undo migrate-default: move the account directory back to "
                                                       "~/.claude and unregister the account; the login is kept")
     p_restore.add_argument("name")
@@ -285,7 +292,7 @@ def _add_write_options(parser: argparse.ArgumentParser) -> None:
 def _split_args_command(argv: List[str]) -> Tuple[List[str], Optional[List[str]]]:
     """子命令是 `args` 时，把第一个 `--` 之后的全部内容取出来作为参数列表；
     子命令是 `mcp` 或 `login` 时，账号名之后的全部内容原样作为 `claude mcp` / `claude auth login` 的参数（不经 argparse）；
-    子命令是 `run` 时，第一个 `--` 之后的内容是要运行的命令。
+    子命令是 `run` / `code` 时，第一个 `--` 之后的内容是要运行的命令 / 传给 VS Code 的参数。
 
     不能用 argparse.REMAINDER：可选位置参数加 --defaults 加 REMAINDER 时，
     `args --defaults -- --settings s` 会被解析成账号名 `--settings`（方案 §5.1.2，实测 3.10/3.11/3.13）。
@@ -307,8 +314,8 @@ def _split_args_command(argv: List[str]) -> Tuple[List[str], Optional[List[str]]
             example = "multi-claude mcp NAME list" if command == "mcp" else "multi-claude login NAME"
             raise UsageError("{} needs an account name first, e.g. `{}`".format(command, example))
         return argv[:command_index + 2], rest[1:]
-    if command_index is not None and argv[command_index] == "run":
-        # run 的命令从第一个 `--` 之后原样取出；没有 `--` 与 `--` 后为空都表示“没有命令”（运行 claude）。
+    if command_index is not None and argv[command_index] in ("run", "code"):
+        # run 的命令（code 的 VS Code 参数）从第一个 `--` 之后原样取出；没有 `--` 与 `--` 后为空都表示“没有”。
         if "--" not in argv[command_index + 1:]:
             return argv, None
         separator = argv.index("--", command_index + 1)
@@ -394,7 +401,7 @@ def main(argv: Optional[List[str]] = None) -> int:
                 return accounts.EXIT_ERROR
             # 不加写锁：凭据由 Claude 自己写入，登录过程需要浏览器交互，可能持续很久。
             return cmd_login(args.name, args.launch_args or [])
-        if args.command in ("run", "path"):
+        if args.command in ("run", "path", "code"):
             if notice:
                 # 与 mcp 相同：迁移进行到一半时账号目录可能正在搬动。
                 error("finish the unfinished migration before running `{}`".format(args.command))
@@ -402,6 +409,8 @@ def main(argv: Optional[List[str]] = None) -> int:
             # 只读配置、不加写锁：run 会把进程换成目标命令，可能运行很久。
             if args.command == "path":
                 return cmd_path(args.name)
+            if args.command == "code":
+                return cmd_code(args.name, args.path, args.launch_args or [])
             return cmd_run(args.name, args.launch_args or [])
         if args.command == "mcp":
             if notice:
@@ -831,14 +840,22 @@ def cmd_run(name: Optional[str], command: List[str]) -> int:
         # 提示写 stderr：stdout 留给目标命令，`run -- cmd | …` 才不会混进这一行。
         print("[multi-claude] run: using account {} ({})".format(
             account.name, "route " + rule.path if rule is not None else "default"), file=sys.stderr)
-    process_env, code = _usable_account_env(config, account)
-    if process_env is None:
-        return code
     if not command:
         # 固定参数按启动命令的规则展开 `~`（launcher.render），两种启动方式收到的参数才逐项相同。
         command = ["claude"] + [launcher.expand_value(arg) for arg in config.effective_args(account)]
+    return _exec_as(config, account, command)
+
+
+def _exec_as(config: Config, account: Account, command: List[str], not_found_hint: str = "") -> int:
+    """run 与 code 共用：账号可用时以它的启动命令环境 exec 目标命令，成功则不返回。
+
+    返回值只出现在失败时：账号不可用 1，PATH 中找不到命令 127。
+    """
+    process_env, code = _usable_account_env(config, account)
+    if process_env is None:
+        return code
     if shutil.which(command[0], path=process_env.get("PATH")) is None:
-        error("{} not found in PATH".format(command[0]))
+        error("{} not found in PATH{}".format(command[0], not_found_hint))
         return 127
     sys.stdout.flush()
     sys.stderr.flush()
@@ -847,6 +864,54 @@ def cmd_run(name: Optional[str], command: List[str]) -> int:
     return accounts.EXIT_ERROR  # 不会执行到这里：execvpe 成功后不返回
 
 
+# code 依赖的未公开行为由 2026-10-02 实测确认的版本（方案 feature-vscode-launch §1.1）。
+VSCODE_VERIFIED_WITH = "VS Code 1.139.1, extension 2.1.286"
+# macOS 的 unix 套接字路径上限是 104 字节，VS Code 在 macOS 上把主套接字放在用户数据目录下（形如 1.13-main.sock，
+# 约 15 字节，见 VS Code out/main.js 构造套接字路径的函数）；Linux 设了 XDG_RUNTIME_DIR 时不放在这里。
+_SOCKET_DIR_WARN_LENGTH = 80
+_CODE_NOT_FOUND_HINT = "; in VS Code run \"Shell Command: Install 'code' command in PATH\""
+
+
+def cmd_code(name: str, path: Optional[str], code_args: List[str]) -> int:
+    """以账号环境打开一个独立的 VS Code 实例（实验功能，方案 feature-vscode-launch §5.1）。
+
+    必须给每个账号单独的 --user-data-dir：VS Code 已在运行时，同一用户数据目录的请求会转给已运行的实例，
+    新窗口沿用那个实例的环境，账号就不生效了。目录按账号目录名存放，rename 后数据仍在原处。
+    """
+    warn("experimental: code relies on undocumented behaviour of VS Code and the Claude Code extension "
+         "(verified with {})".format(VSCODE_VERIFIED_WITH))
+    config, _ = load_config()
+    account = config.find(_checked_name(name))
+    if account is None:
+        error("account {!r} is not registered".format(name))
+        return accounts.EXIT_ERROR
+    # 先确认账号可用、找得到 code 命令，再建目录：任何失败都不留下空的用户数据目录。
+    process_env, code = _usable_account_env(config, account)
+    if process_env is None:
+        return code
+    if shutil.which("code", path=process_env.get("PATH")) is None:
+        error("code not found in PATH{}".format(_CODE_NOT_FOUND_HINT))
+        return 127
+    data_dir = _private_dirs(expand(config.root), [".apps", account.dir, "vscode"])
+    if sys.platform == "darwin":
+        if len(data_dir) > _SOCKET_DIR_WARN_LENGTH:
+            warn("{} is long; VS Code's socket path inside it may exceed the 104-byte limit".format(data_dir))
+        warn("on macOS, code passes the whole environment (including this account's variables) to "
+             "`open --env`, so the values are briefly visible in the process list")
+    command = ["code", "--user-data-dir", data_dir] + ([path] if path else []) + list(code_args)
+    return _exec_as(config, account, command, not_found_hint=_CODE_NOT_FOUND_HINT)
+
+
+def _private_dirs(root: str, parts: List[str]) -> str:
+    """在 root 下逐级创建 parts，每一级都只允许本人访问（makedirs 的 mode 受 umask 影响，所以再 chmod）。"""
+    path = root
+    for part in parts:
+        path = os.path.join(path, part)
+        os.makedirs(path, mode=0o700, exist_ok=True)
+        os.chmod(path, 0o700)
+    return path
+
+
 def cmd_path(name: str) -> int:
     """打印账号目录；目录不存在时照样打印，但以 1 退出，脚本里 `cd "$(multi-claude path X)"` 不会静默进错目录。"""
     config, _ = load_config()

{multi_claude_cli-0.5.0 → multi_claude_cli-0.6.0}/src/multi_claude/completion.py

@@ -19,7 +19,7 @@ POSITIONAL_KINDS = {
     "args": ["name"], "remove": ["name"], "usage": ["name"], "completion": ["shell"],
     "route": ["dir", "name"], "which": ["dir"], "rename": ["name"], "mcp": ["name"],
     "statusline": ["statusline", "file"], "handoff": ["name"], "login": ["name"], "set": ["name"],
-    "run": ["name"], "path": ["name"], "restore": ["name"],
+    "run": ["name"], "path": ["name"], "restore": ["name"], "code": ["name", "file"],
 }
 # 选项值是路径、应按文件补全的选项。
 PATH_OPTIONS = ("-f", "--file", "--root", "--bin-dir", "--shared-dir")

{multi_claude_cli-0.5.0 → multi_claude_cli-0.6.0/src/multi_claude_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-claude-cli
-Version: 0.5.0
+Version: 0.6.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
@@ -286,6 +286,22 @@ multi-claude add client-b --config-from work # start client-b with a copy of wor
 
 `--config-from` copies `settings.json` once; afterwards the two files are independent. A different existing `settings.json` in the new account, or a `settings.json` that the account shares, is a conflict and nothing is changed. Use [shared resources](#shared-resources) for settings that should stay the same in every account.
 
+### Opening VS Code for an account (experimental)
+
+```sh
+multi-claude code work ~/projects/app             # a separate VS Code window for work
+multi-claude code personal . -- --disable-gpu     # arguments after -- go to VS Code
+```
+
+The Claude Code extension uses the `CLAUDE_CONFIG_DIR` of the environment VS Code was started with, so a VS Code opened from the Dock always uses `~/.claude`. `code` starts VS Code with the account's environment (the same as `run`) and a separate user data directory, `<root>/.apps/<account directory>/vscode`. A separate user data directory is required: otherwise VS Code hands the request to the instance that is already running, with its own environment. Each account's instance starts with default VS Code settings; extensions are shared because they live in `~/.vscode/extensions`.
+
+Notes:
+
+- If an instance for the account is already running, the request goes to it; changes to the proxy or environment variables apply after that instance quits.
+- Setting `CLAUDE_CONFIG_DIR` in the extension's `claudeCode.environmentVariables` inside that instance overrides the account.
+- On macOS the `code` command passes the whole environment to `open --env`, so the values are briefly visible in the process list.
+- Verified with VS Code 1.139.1 and Claude Code extension 2.1.286 on macOS; `code` prints a warning because it relies on undocumented behaviour. It needs the `code` command on `PATH` (in VS Code: "Shell Command: Install 'code' command in PATH").
+
 ### Diagnostics and completion
 
 `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.
@@ -389,6 +405,7 @@ No. It never reads, copies or deletes credentials; its only keychain call checks
 | `multi-claude mcp NAME [ARG ...]` | Run `claude mcp ARG ...` as that account. |
 | `multi-claude run [NAME] [-- COMMAND ...]` | Run a command (default: `claude` with the fixed arguments) with the environment of the account's launcher. Without NAME, the account `claude-auto` would use. |
 | `multi-claude path NAME` | Print the account's directory. |
+| `multi-claude code NAME [PATH] [-- ARGS ...]` | Open a separate VS Code instance with the account's environment (experimental). |
 | `multi-claude handoff TARGET [--from NAME] [--session ID] [--force]` | Copy a session to another account and print the command that resumes it there. |
 | `multi-claude statusline install\|uninstall FILE` | Wrap the statusLine command in a settings file so that `usage` gets fresh numbers, or restore it. |
 | `multi-claude completion bash\|zsh\|fish` | Print a shell completion script. |
@@ -464,7 +481,7 @@ If you move an account directory yourself, its launcher reports that the directo
 ./install.sh --uninstall
 ```
 
-This removes the tool only. Your configuration, account directories, logins and `claude-<name>` launchers stay; the launchers keep working because they do not depend on multi-claude. Run `multi-claude statusline uninstall FILE` first if you wrapped a status line.
+This removes the tool only. Your configuration, account directories (including the VS Code data in `<root>/.apps` created by `code`), logins and `claude-<name>` launchers stay; the launchers keep working because they do not depend on multi-claude. Run `multi-claude statusline uninstall FILE` first if you wrapped a status line.
 
 ## Contributing
 

{multi_claude_cli-0.5.0 → multi_claude_cli-0.6.0}/src/multi_claude_cli.egg-info/SOURCES.txt

@@ -50,4 +50,5 @@ tests/test_set.py
 tests/test_shared_exclude.py
 tests/test_statusline.py
 tests/test_usability.py
-tests/test_usage.py
+tests/test_usage.py
+tests/test_vscode.py

multi_claude_cli-0.6.0/tests/test_vscode.py

@@ -0,0 +1,127 @@
+"""v0.6.0 `code NAME [PATH]`：按账号打开独立的 VS Code 实例（方案 docs/feature/feature-vscode-launch.md §8）。
+
+用假 `code` 脚本记录参数与环境，不启动真实的 VS Code。"""
+
+import json
+import os
+import stat
+import sys
+import unittest
+
+from helpers import CliTestCase
+
+FAKE_CODE = """#!/bin/sh
+printf '%s\\n' "$@" > "$FAKE_CLAUDE_OUT.code-args"
+env > "$FAKE_CLAUDE_OUT.code-env"
+"""
+
+
+class CodeTest(CliTestCase):
+    def setUp(self):
+        super().setUp()
+        self.code_path = self.write(os.path.join(self.fakebin, "code"), FAKE_CODE, 0o755)
+        self.ok("add", "work", "--proxy", "7901")
+        self.data_dir = os.path.join(self.root, ".apps", "work", "vscode")
+
+    def received(self):
+        with open(self.fake_out + ".code-args") as handle:
+            args = handle.read().split("\n")[:-1]
+        with open(self.fake_out + ".code-env") as handle:
+            env = dict(line.split("=", 1) for line in handle.read().splitlines() if "=" in line)
+        return args, env
+
+    def test_t1_opens_with_account_environment(self):
+        result = self.ok("code", "work")
+        self.assertIn("experimental", result.err)
+        args, env = self.received()
+        self.assertEqual(args, ["--user-data-dir", self.data_dir])
+        self.assertEqual(env["CLAUDE_CONFIG_DIR"], os.path.join(self.root, "work"))
+        self.assertEqual(env["HTTPS_PROXY"], "http://127.0.0.1:7901")
+        project = os.path.join(self.tmp, "proj")
+        self.ok("code", "work", project, "--", "--new-window")
+        args, _ = self.received()
+        self.assertEqual(args, ["--user-data-dir", self.data_dir, project, "--new-window"])
+
+    def test_t2_private_data_dir(self):
+        self.ok("code", "work")
+        self.ok("code", "work")
+        for path in (os.path.join(self.root, ".apps"), os.path.join(self.root, ".apps", "work"), self.data_dir):
+            self.assertEqual(stat.S_IMODE(os.stat(path).st_mode), 0o700, path)
+        # .apps 不是账号：list 与 apply 都不受影响
+        self.ok("apply")
+        self.assertEqual(self.ok("list", "--names").out, "work\n")
+
+    def test_t3_rename_keeps_data_dir(self):
+        self.ok("rename", "work", "client")
+        self.ok("code", "client")
+        args, _ = self.received()
+        self.assertEqual(args[:2], ["--user-data-dir", self.data_dir])
+
+    def test_t4_failures(self):
+        self.assertEqual(self.run_cli("code", "nosuch").code, 1)
+        os.unlink(self.code_path)
+        # PATH 只留假命令目录：系统目录里可能有真的 code（编译机 /usr/bin/code），不能让测试拉起真实的 VS Code
+        result = self.run_cli("code", "work", env={"PATH": self.fakebin})
+        self.assertEqual(result.code, 127, result)
+        self.assertIn("Install 'code' command in PATH", result.err)
+        self.assertFalse(os.path.lexists(os.path.join(self.root, ".apps")))
+        with open(os.path.join(self.state, "migrate-journal.json"), "w") as handle:
+            json.dump({"name": "main", "source": "s", "target": "t", "backup": "b", "mode": "rename",
+                       "phase": "planned"}, handle)
+        result = self.run_cli("code", "work")
+        self.assertEqual(result.code, 1, result)
+        self.assertIn("unfinished migration", result.err)
+
+    def test_t4_more_failures_leave_no_data_dir(self):
+        self.assertEqual(self.run_cli("code").code, 2)
+        os.rmdir(os.path.join(self.root, "work"))
+        result = self.run_cli("code", "work")
+        self.assertEqual(result.code, 1, result)
+        self.assertFalse(os.path.lexists(os.path.join(self.root, ".apps")))
+
+    def test_t4_run_not_found_has_no_code_hint(self):
+        result = self.run_cli("run", "work", "--", "no-such-cmd-xyz")
+        self.assertEqual(result.code, 127)
+        self.assertNotIn("Install 'code'", result.err)
+
+    def test_t5_redirected_default_link(self):
+        source = os.path.join(self.home, ".claude")
+        self.write(os.path.join(source, ".credentials.json"), "{}", 0o600)
+        self.ok("migrate-default", "main")
+        os.unlink(source)
+        os.makedirs(source)
+        result = self.run_cli("code", "main")
+        self.assertEqual(result.code, 1, result)
+        self.assertFalse(os.path.lexists(os.path.join(self.root, ".apps", "main")))
+
+    def test_t5_remove_keeps_data_dir(self):
+        self.ok("code", "work")
+        self.ok("remove", "work")
+        self.assertTrue(os.path.isdir(self.data_dir))
+
+    @unittest.skipUnless(sys.platform == "darwin", "macOS-only warnings")
+    def test_t5_macos_warnings(self):
+        result = self.ok("code", "work")
+        self.assertIn("open --env", result.err)
+        # 提示只看用户数据目录的长度：macOS 的临时目录本身就很长，按实际长度判断应不应出现
+        if len(self.data_dir) > 80:
+            self.assertIn("is long", result.err)
+        else:
+            self.assertNotIn("is long", result.err)
+
+    def test_t5_default_identity_has_no_config_dir(self):
+        source = os.path.join(self.home, ".claude")
+        self.write(os.path.join(source, ".credentials.json"), "{}", 0o600)
+        self.ok("migrate-default", "main")
+        self.ok("code", "main")
+        _, env = self.received()
+        self.assertNotIn("CLAUDE_CONFIG_DIR", env)
+
+    def test_t6_help_and_completion(self):
+        self.assertIn("open VS Code for an account", self.ok("--help").out)
+        for shell in ("bash", "zsh", "fish"):
+            self.assertIn("code", self.ok("completion", shell).out)
+
+
+if __name__ == "__main__":
+    unittest.main()