# Close Cc Host

> 关闭承载当前 Claude Code 会话的宿主（VSCode 窗口或其终端面板），连同 claude 一起退出。通过 close-host-window 扩展触发：先 SIGTERM claude（走完 SessionEnd hooks）再关 host，不抢焦点、不丢 hooks。--host vscode 关窗口、--host terminal（默认）只关终端面板。Use when 任务结束要随宿主退出，或需精确关闭某 claude 终端所在窗口/面板。

- Skill: `lionad-morotar/close-cc-host` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lionad-morotar/close-cc-host`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lionad-morotar/close-cc-host/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lionad-morotar (https://skillmd.com/u/lionad-morotar)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lionad-morotar/close-cc-host

---


# close-cc-host

关闭承载当前 claude 会话的**宿主**（VSCode 窗口 ⊃ 终端面板 ⊃ claude），连同 claude 一起退出。靠 **close-host-window 扩展**完成，且**先 SIGTERM claude 走完 SessionEnd hooks 再关 host** —— 直接 dispose terminal 是强杀，会丢 hooks。

## 核心原理

外部进程没法主动定位/操作 VSCode 窗口（AX 跨 Space 失明、激活抢焦点、CGS/IPC 死路）。扩展可以 —— per-window extension host + `workbench.action.closeWindow`（不抢焦点、不受 Space 限制）。

但扩展直接 `terminal.dispose()` 是强杀（SIGHUP/SIGKILL），claude 的 SessionEnd/Stop hook 会丢。正确顺序：**SIGTERM claude 进程组（优雅退出，SessionEnd hooks 跑完）→ 等退出 → 再关 host**（Docker/k8s/systemd 标准两段式终止）。

## 前置条件（缺一则静默失败）

1. 装 **close-host-window** 扩展（vsix 本地装；项目 `~/Github/Lionad-Morotar/vscode-extension-for-agent`）
2. `Cmd+Shift+P` → `Developer: Reload Window` 激活（`onStartupFinished` 只在窗口启动触发一次）
3. workspace **可信**（`/tmp` 等不可信 workspace 扩展不激活）

## 触发

```sh
bash scripts/close.sh                 # 默认 --host terminal，只关活动终端面板
bash scripts/close.sh --host vscode   # 关整个窗口（连带所有终端面板）
```

`--host` 路由（两层都先 SIGTERM claude 走 SessionEnd，再关）：

- **vscode**：socket（新终端 `$VSC_WINDOW_CLOSE_HOOK`）或哨兵 `.close-window-signal`（老终端）→ closeWindow
- **terminal**（默认）：哨兵 `.close-terminal-signal` → dispose 活动终端面板

## 隐藏语义（容器层级）

VSCode 窗口 ⊃ 终端面板 ⊃ claude。`--host vscode` 关顶层窗口（连带 terminal + claude）；`--host terminal` 只关中间层终端面板（claude 随之退出，窗口保留）。对参数路由无影响，仅交代嵌套关系。

## 关联机制（cc 怎么找到本窗口的扩展）

cc 不主动找 —— 扩展通过 `environmentVariableCollection` 把本窗口 socket 路径注入新终端的 `$VSC_WINDOW_CLOSE_HOOK`（vscode 通道）；老终端走哨兵。reload 后 sessionId 变但环境变量自动重铺。详见 [references/vscode.md](references/vscode.md)。

## 坑位（实测血泪）

- **装扩展后必须 reload**：`onStartupFinished` 只在窗口启动触发一次。
- **Workspace Trust 拦截**：`/tmp` 等不可信 workspace 扩展不激活，且无报错。
- **直接 dispose = 强杀 = 丢 hooks**：扩展已改为 SIGTERM 优雅退出，别绕过扩展直接 kill pty。
- **老终端无 `$VSC_WINDOW_CLOSE_HOOK`**：环境变量启动时定型 → 哨兵兜底。
- **哨兵通道一触即发**：`touch .close-*-signal` 在真 workspace 下立即触发关 host。验证务必在 `mktemp -d` 隔离目录跑。
- **子模块/worktree 的 `.git` 是文件不是目录**：close.sh 找 workspace 根必须用 `-e` 判 `.git`，用 `-d` 会越过子模块根把哨兵落到上层父仓（扩展只 watch `workspaceFolders[0]`，落错位置即静默失败）。
- **关闭即终止当前会话**：close.sh 必须最后一条，commit / 存盘提前做完。

## 解耦

信号分档（SIGTERM/SIGHUP/SIGKILL）+ 扩展机制（per-window host、双通道、SIGTERM 优雅退出）+ 关联机制 + 激活前置 → [references/vscode.md](references/vscode.md)