Claude Ref Sender

在 VSCode 编辑器中选中代码，按一个快捷键，就把形如 @path/to/file.go#L10-20 的引用直接「打字」进正在运行 Claude Code CLI 的终端。

无需安装官方的 Claude Code for VSCode 插件，尤其适合 VSCode 远程开发 + 远程机器上跑 claude 命令行 的工作流。

为什么需要它

Claude Code CLI 是一个跑在终端里的交互式程序，你可以用 @文件#L起始-结束 的语法把某段代码喂给它。但手动敲文件路径和行号又慢又容易错。

VSCode 原生其实做不到「选中代码 → 一键生成带行号范围的引用 → 发送到正在运行的终端」：

• keybindings.json 里的 workbench.action.terminal.sendSequence 只能发送静态字符串，无法替换文件名、行号等变量；
• tasks.json 虽支持变量，但它会另开一个 shell，无法注入到已经在跑 claude 的交互式终端；而且预定义变量里没有选区的起止行。

所以最干净的做法就是这样一个仅几十行的轻量扩展。

功能特性

• 选中代码后一键生成 @相对路径#L起始-结束 引用并发送到终端
• 支持单行选中（生成 @file#L10）与未选中时按光标行生成
• 支持多光标 / 多选区，自动拼接并去重
• 在左侧资源管理器中选中文件，一键生成整文件引用 @相对路径（不含行号）发送到终端
• 选中代码后在选区上方显示「💬 将选中引用添加到终端」CodeLens 气泡，单击即可发送
• 可把光标放在函数/类上一键生成其完整行范围引用 @file#Lstart-end，无需手动拖选（基于 DocumentSymbol API）
• 可把光标所在行的诊断（错误/警告等）连同引用一起发送，支持诊断灯泡（快速修复）「💬 让 Claude 修复此问题」、右键菜单与命令面板
• 可一条命令把所有 Git 改动文件构造成 @file 引用发送，并支持自定义 prompt 模板、用 {{refs}} 注入引用位置（「review 我这些改动」）
• 可在发送前 quick-pick 一个提示词模板（如「解释」「重构」「写测试」）拼在引用前面，模板列表完全由 claudeRef.promptTemplates 自定义
• 可配置相对 / 绝对路径
• 可配置发送后是否自动回车提交
• 可配置发送后是否把焦点切换到终端
• 可配置「仅在 Claude Code 运行时发送」，并自定义识别命令名（支持 claude-other 等）
• 可在 Claude Code 每轮对话结束时弹出系统级桌面通知（基于 Claude Code 的 Stop hook，提供一键安装命令；亦可切换为 IDE 内部提示）
• 可在 IDE 内逐块 Review Claude 的改动：每轮改完后用内置 diff 呈现「改动前（红）/ 改动后（绿）」，逐块「接受（保留）/ 拒绝（回退原代码）」，或对当前文件「接受全部 / 拒绝全部」未确认改动，配 Alt+A/D/Z、Alt+Shift+A/D 快捷键与底部 ↑/↓、「下一个文件」导航（基于一键安装的 Review Hook）
• 在 VSCode 内置 Git diff 视图中支持「转到定义」「查看引用」等符号跳转：diff 里的原始/历史版本本是只读虚拟文档，语言服务默认不对其生效；现桥接到磁盘上的真实文件，使 F12、右键「转到定义 / 查看引用」、Ctrl/Cmd+Click 及悬停提示在 diff 视图内也能正常工作
• Go 接口方法智能跳转到定义：在 Go 文件中按 F12（或 Ctrl/Cmd + 点击）跳转到接口方法时，自动弹出 Peek 视图同时展示接口定义与所有实现，避免先跳到接口、再手动查找实现的繁琐步骤。支持按 glob 模式排除/包含实现文件（如排除 *_test.go、**/mock）
• 提供快捷键、编辑器右键菜单、资源管理器右键菜单、CodeLens 气泡多种触发方式

安装

方式一：打包成 vsix 安装（推荐）

cd claude-ref-ext
npx --yes @vscode/vsce package          # 生成 claude-ref-sender-1.5.0.vsix
code --install-extension claude-ref-sender-1.5.0.vsix

然后 Ctrl/Cmd + Shift + P → Developer: Reload Window。

远程开发提示：远程终端里的 code 命令由 vscode-server 提供，--install-extension 会把扩展安装到远程侧，从而能访问远程文件与远程终端。

方式二：开发 / 调试模式

用 VSCode 单独打开本项目文件夹，按 F5 启动「扩展开发宿主」窗口，在新窗口里即可测试。

使用

1. 在终端里正常启动 claude；

2. 在编辑器中选中一段代码（保持焦点在编辑器内）；

3. 按快捷键，或右键选择 Claude Ref: 发送选区引用到终端；

4. 终端里会出现类似：

   @src/utils/example.go#L10-20 
   

5. 继续输入你的问题，回车发送给 Claude。

发送整个文件引用

在左侧资源管理器中选中一个（或多个）文件后：

• 按快捷键 Ctrl/Cmd + Alt/Option + K（保持焦点在资源管理器），或
• 右键选择 Claude Ref: 发送文件引用到终端

终端里会出现整文件引用（不含行号），例如：

@src/utils/example.go 

快捷键触发依赖内置的复制路径命令读取选中项，会短暂占用并随即还原系统剪贴板；右键菜单则直接读取选中项，更可靠。

选区 CodeLens 气泡

在编辑器中选中一段代码后，选区起始行上方会出现可单击的 「💬 将选中引用添加到终端」，单击即把选区引用发送到终端，无需记快捷键。

发送光标所在符号引用

不想手动拖选整个函数？把光标放进某个函数/类/方法体内，右键选择 Claude Ref: 发送光标所在符号引用到终端（或在命令面板执行同名命令）。它会用 DocumentSymbol API 取该符号的完整行范围，生成形如：

@src/utils/example.go#L10-42 

说明：

• 取的是包含光标的最内层符号——光标在类里某个方法上时，引用的是那个方法而非整个类。
• 光标不在任何符号内（或该语言没有符号提供者）时，自动退回为当前选区/光标行引用，并提示。
• 行号规则与选区引用一致（单行符号生成 @file#L10）。
• 默认未绑定快捷键；可自行为 claudeRef.sendSymbol 绑定。

发送诊断/报错

当某行有报错或警告时，把它连同引用一起丢给 Claude 修是最高频的场景。把光标放到出问题的那一行，通过任一方式触发：

• 诊断灯泡：点行首的灯泡（快速修复），选择 「💬 让 Claude 修复此问题」；
• 右键菜单：选择 Claude Ref: 发送诊断/报错到终端；
• 命令面板：Ctrl/Cmd + Shift + P → Claude Ref: 发送诊断/报错到终端。

终端里会出现引用 + 该行的报错信息，例如：

@src/foo.ts#L42
[error] Cannot find name 'fooo'. (ts 2304)

随后补一句「帮我修一下」回车即可。说明：

• 只发送光标/选区所在行的诊断；选中多行则覆盖范围内的诊断都会带上（各条前标注所在行号）。
• 报错文本含严重级别（error/warn/info/hint）、消息以及来源与错误码（如 ts2304、eslint no-undef）。
• 多行内容通过终端「括号粘贴」一次性送入，内部换行不会被 claude 当成多次回车提交（submitOnSend 仍只在最后追加一次回车）。
• 默认未绑定快捷键；需要的话可在键盘快捷方式中为 claudeRef.sendDiagnostics 自行绑定（例如 Ctrl/Cmd + Alt/Option + J）。

发送 Git 变更引用

想让 Claude 一次性 review 你当前的所有改动？Ctrl/Cmd + Shift + P → Claude Ref: 发送 Git 变更引用到终端。它会通过 VSCode 内置 Git 扩展枚举所有仓库的改动文件，构造成多个 @file 引用一并发送。

默认只发送引用本身：

@src/foo.ts @src/bar.ts @README.md 

自定义 prompt 模板：在设置里写 claudeRef.gitChangesPrompt，用 {{refs}} 标记引用注入位置。例如：

"claudeRef.gitChangesPrompt": "请 review 以下改动，重点关注错误处理与边界条件：\n{{refs}}\n如有问题请直接给出修改建议。"

发送后终端里就会是完整的 prompt，{{refs}} 处替换为全部文件引用。说明：

• 模板里没有 {{refs}} 时，文件引用会追加到模板末尾。
• 默认包含未跟踪的新文件；可用 claudeRef.gitIncludeUntracked: false 只发已跟踪文件的改动。已删除的文件始终排除（引用不存在的文件没有意义）。
• 多工作区/多仓库都会被纳入，去重后空格拼接，与「源代码管理」视图所见一致。
• 模板可含换行，通过终端「括号粘贴」一次性送入，内部换行不会被当成多次提交。

选模板发送（提示词前缀）

常用的提问方式（解释这段代码、帮我重构、写测试……）可以存成模板，发送时选一个、拼在引用前面，省得每次手敲。

开箱即带「解释」「重构」「写测试」「审查改动」四个默认模板，直接用即可；也可在设置 claudeRef.promptTemplates 里增删改，例如：

"claudeRef.promptTemplates": [
  { "label": "解释",   "prompt": "请解释以下代码的作用：" },
  { "label": "重构",   "prompt": "请重构以下代码，提升可读性，保持行为不变：" },
  { "label": "写测试", "prompt": "请为以下代码写单元测试：" },
  { "label": "审查",   "prompt": "请审查以下改动，重点看错误处理：\n{{refs}}\n并给出修改建议。" }
]

然后：

• 在编辑器中选中代码（或在资源管理器中选中文件）；
• 右键选择 Claude Ref: 选模板发送引用到终端，或在命令面板执行同名命令；
• 在弹出的列表里选一个模板，引用就会拼在该模板后面发送。

说明：

• 模板的 prompt 默认拼在引用前面；若 prompt 中含占位符 {{refs}}，引用则注入到该位置（与「发送 Git 变更引用」一致）。
• 把 claudeRef.promptTemplates 设为空数组 [] 即可关闭所有模板（届时会提示去设置里添加）。
• 模板可含换行，通过终端「括号粘贴」一次性送入，内部换行不会被当成多次提交。
• 默认未绑定快捷键；可自行为 claudeRef.sendWithTemplate 绑定。

在 Git diff 中转到定义 / 查看引用

VSCode 内置 Git diff 视图（源代码管理面板中点开一个改动文件时看到的左右对比）里，原始版本 / 历史版本那一侧是只读虚拟文档，VSCode 的语言服务只对磁盘上的真实文件生效，所以直接在 diff 里对符号按 F12 通常没有反应。

本扩展会把 diff 视图里的导航请求桥接到磁盘上的真实文件再求解，因此在 diff 视图内也可以正常使用：

• 转到定义（F12 / 右键「转到定义」/ Ctrl/Cmd + 点击）
• 查看引用 / 转到引用（Shift+F12 / 右键「查看引用」）
• 转到类型定义、转到实现
• 悬停提示（鼠标悬停显示类型/文档）

跳转结果始终落在真实文件上（与在普通编辑器中的体验一致）。由于 diff 里的历史版本内容可能与磁盘当前内容存在差异，扩展会优先按原文本就近匹配对应行，找不到时退回到同一行列，尽量保证跳转准确。

不需要该功能时，可将 claudeRef.enableDiffNavigation 设为 false 关闭（无需重启，改动即时生效）。

Go 接口方法智能跳转到定义

在 Go 项目中，对接口方法的调用按 F12（或 Ctrl/Cmd + 点击）时，默认会直接跳转到接口定义——而不是具体实现。想找到所有实现，还需要手动「转到实现」，步骤繁琐。

开启本功能后（默认开启）：

1. 把光标放在某个接口方法的调用上，按 F12 或 Ctrl/Cmd + 点击；
2. VSCode 会自动弹出 Peek 视图（编辑器内部的内联列表），同时展示：
   • 接口定义（标注 interface）
   • 所有实现了该接口方法的具体类型（标注 implementation）
3. 在列表中直接选择目标跳转，或按 ESC 取消。

功能说明：

• 非接口方法不受影响：如果跳转目标是普通函数或结构体方法，行为与默认完全一致，直接跳转。
• 文件过滤：用 claudeRef.smartGoToDefinitionExclude 排除不需要的实现文件（默认排除 *_test.go），或用 claudeRef.smartGoToDefinitionInclude 只保留特定路径下的实现。接口定义自身始终不受过滤影响。

  // 示例：排除测试文件和 mock 目录，仅包含 go/app/setting 下的实现
  "claudeRef.smartGoToDefinitionExclude": ["*_test.go", "*.md", "**/mock"],
  "claudeRef.smartGoToDefinitionInclude": ["go/app/setting"]
  

• 关闭方法：将 claudeRef.smartGoToDefinition 设为 false 即可恢复默认行为。

对话结束提示

希望 Claude Code 答完一轮就在 IDE 弹个提示？由于 VSCode 无法读取交互式终端内部的单轮结束信号，本功能借道 Claude Code 自身的 Stop hook：

1. Ctrl/Cmd + Shift + P → 执行 Claude Ref: 安装对话结束提示 Hook。它会把一条 Stop hook 幂等地写入工作区的 .claude/settings.json（已存在则不重复）；
2. 在 settings.json 中开启 "claudeRef.notifyOnTurnEnd": true；
3. 重新启动（或重载）正在运行的 claude 会话，使新 hook 生效。

此后 Claude 每答完一轮，就会弹出系统级桌面通知（默认；即便 IDE 窗口最小化或失焦也能看到）。文案可用 claudeRef.turnEndMessage 自定义；若想改回 IDE 右下角的内部提示，把 claudeRef.notifyStyle 设为 "ide"。

系统通知按平台调用系统自带工具实现，无第三方依赖：macOS 用 osascript、Linux 用 notify-send（libnotify）、Windows 用 PowerShell Toast。对应命令缺失或出错时会自动降级为 IDE 内提示。

远程开发例外：在 Remote-SSH / Dev Container / WSL 下，扩展宿主跑在「远端」机器上，系统命令只会在远端执行，本地（如你的 Mac）看不到。因此远程环境会自动改用 IDE 内提示——这是唯一能送达本地窗口的通道。受 VSCode 架构限制，远程扩展无法在你的本地机器弹出真正的系统通知。

不想要了？执行 Claude Ref: 移除对话结束提示 Hook 即可从 .claude/settings.json 移除该 hook（按信号文件名识别，旧版本写入的命令变体也会一并清除）。

原理：Stop hook 在每轮回复结束时用 node 向 .claude/.claude-ref-stop 写入一个时间戳（跨平台一致，不依赖 date/printf），扩展用文件监听器捕获该变化后弹出提示。hook 命令不读取、不外发任何对话内容。

默认快捷键

如有冲突，可在 VSCode 的「键盘快捷方式」中为命令 claudeRef.sendSelection 重新绑定。

配置项

在 settings.json 中可配置：

示例：

{
  "claudeRef.pathStyle": "relative",
  "claudeRef.submitOnSend": false,
  "claudeRef.focusTerminalOnSend": false,
  "claudeRef.showSelectionCodeLens": true,
  "claudeRef.requireClaudeRunning": false,
  "claudeRef.claudeCommandPattern": "claude",
  "claudeRef.notifyOnTurnEnd": false,
  "claudeRef.turnEndMessage": "✅ Claude Code 本轮回复已完成",
  "claudeRef.notifyStyle": "system",
  "claudeRef.gitChangesPrompt": "",
  "claudeRef.gitIncludeUntracked": true,
  "claudeRef.enableDiffNavigation": true,
  "claudeRef.smartGoToDefinition": true,
  "claudeRef.smartGoToDefinitionInclude": [],
  "claudeRef.smartGoToDefinitionExclude": ["*_test.go"]
  // claudeRef.promptTemplates 默认已预置「解释/重构/写测试/审查改动」，需要时再覆盖
}

工作原理

扩展注册了命令 claudeRef.sendSelection，触发时：

1. 读取当前编辑器的所有选区；
2. 计算每个选区的起止行号与（相对/绝对）文件路径，拼成 @path#Lstart-end；
3. 通过 terminal.sendText() 把文本写入当前活动终端（默认不追加换行）。

核心实现见 extension.js。

目录结构

claude-ref-ext/
├── .vscode/
│   └── launch.json      # F5 调试配置
├── extension.js         # 扩展主逻辑
├── package.json         # 扩展清单（命令 / 快捷键 / 菜单 / 配置）
├── README.md
├── CHANGELOG.md
├── LICENSE
├── .gitignore
└── .vscodeignore

贡献

欢迎提 Issue 与 PR。本项目刻意保持精简，新增功能请尽量通过配置项实现，避免破坏开箱即用的体验。

许可证

MIT