窗口级操作: Restart / Copy Session ID / Open Session Log / Inject Group Prompt
Preflight: 提醒 claude 不在 PATH 或 node-pty 加载失败
Resume retry: --resume <id> 3s 内退出会自动 fresh 重启
IME 输入支持: webview 终端兼容中文 / 日文 / 韩文输入法 composition
Requirements
VS Code 1.100+
claude CLI on your PATH (or set claudeWindows.claudeCommand to an absolute path)
macOS, Linux, or Windows (PTY backed by node-pty)
Settings
key
default
meaning
claudeWindows.defaultArgs
[]
args passed to every spawn
claudeWindows.claudeCommand
claude
binary path or command name
claudeWindows.shell
auto
auto / zsh / bash / powershell
claudeWindows.initialPromptDelay
2000
ms before injecting the group prompt
claudeWindows.killTimeoutMs
3000
SIGTERM → SIGKILL window on close
claudeWindows.tokenWatchEnabled
true
watch ~/.claude/projects/ for usage
claudeWindows.defaultNamePrefix
Window
prefix for auto-generated names
Commands
All commands are prefixed Claude Windows: in the palette.
New Window, Open Window, Rename Window, Close Window, Move Window to Group
Restart Window, Copy Session ID, Open Session Log, Inject Group Prompt
New Group, Rename Group, Edit Group Prompt, Delete Group, Move Group Up/Down
Refresh, Show Output Log
Build / Develop
npm install
npm run build # esbuild dual bundle: extension.cjs + webview.iife
npm run test:unit # data-layer suites (no electron)
npm run test # unit + integration via @vscode/test-electron
npm run package # produces a .vsix via vsce
Press F5 in VS Code to launch the extension host.
Known Limitations
Linux + fcitx IME: Chinese / CJK input via fcitx may still race with xterm's
helper textarea on some distros. macOS Pinyin and Windows IME have been
validated; fcitx feedback is welcome.
