它到底是什么

claude attach <session-id> 是 Claude Code CLI 后台会话管理子命令组的成员之一。它将一个在后台持续运行的 Claude Code 会话带入当前终端的前台，进入完整的交互对话界面——效果等同于在 claude agents（Agent View）中对某一行按下 Enter 或 →。

后台会话体系由多个子命令协同工作，claude attach 是其中"重新接入"这一步的 CLI 入口：

官方文档（code.claude.com）在 Agent View 页面中记录了此命令体系；claude attach 未单独收录于截至本文检索时的官方 CLI reference 页面的可见部分（该页面因内容过大无法完整读取）。

用法 / 语法

claude attach <session-id>

目前官方文档未记录该子命令有额外的具名 flag；<session-id> 是唯一的必填参数。

会话 ID 的来源

• 执行 claude --bg "<task>" 或在会话内运行 /bg 启动后台会话后,可从 claude agents(Agent View)取得其会话 ID;据第三方来源,该 ID 形似 git 短哈希(如 7c5dcf5d)。官方文档未明确描述 --bg//bg 是否把 ID 直接打印到终端这一具体动作
• 在 claude agents 界面中浏览各后台会话,据第三方来源每行带一行式摘要,可据此定位目标会话 ID

Shell 集成 / 自动化

claude attach 的最大优势是无需进入 Agent View，可在任何 shell 提示符下直接运行，也可以写入脚本：

# 启动后台会话；Claude Code 会打印短 ID 到终端
claude --bg "重构 auth 模块，不要修改测试文件"

# 若已知 ID，在任意时刻（另一个终端、SSH 会话、脚本中）直接附加
claude attach 7c5dcf5d

在 Agent View 中确认 ID 后，退出 View 再在另一个终端附加：

# 终端 A：浏览所有会话，找到目标会话 ID
claude agents

# 终端 B（如另一 SSH 窗口）：直接附加，不需要打开 Agent View
claude attach 7c5dcf5d

脚本化查看状态的典型组合：

SESSION_ID="7c5dcf5d"

# 先看日志，确认需要介入再附加
claude logs "$SESSION_ID"
claude attach "$SESSION_ID"

# 确认完成后停止
claude stop "$SESSION_ID"

与会话内同名命令的差异

CLI 中无 /attach slash 命令，因此不存在同名冲突。附近功能的对应关系如下：

在 Agent View 内部，按 Enter 或 → 附加到选中会话；按 ←（在空输入框时）从已附加的会话退回 Agent View 表格。claude attach 是这一"附加"动作在 Agent View 之外的 CLI 等价物。

经典使用场景

多任务并行切换：同时用 claude --bg 派发多个任务（测试、生成、重构各一个会话），根据输出用 claude attach 按需切入需要人工输入的那个。

远程服务器 / SSH 环境：后台会话不依附于 TTY，SSH 断开重连后，用 claude attach <id> 即可回到同一个会话，任务不中断。

定时检查 + 定点介入：CI 流程或 cron 脚本定期调用 claude logs <id> 检查进展，触发"需要人工干预"条件时再调用 claude attach，其余时间不占用前台终端。

来源

• Manage multiple agents with agent view — Claude Code Docs
• Manage sessions — Claude Code Docs
• CLI reference — Claude Code Docs
• Claude Code Agent View: the CLI Dashboard That Unifies All Sessions (2026)