Agent Context Bridge

Agent Context Bridge 是一个 VS Code 扩展，可将编辑器中选中的代码或文本连同项目、文件位置和行号整理成上下文，方便粘贴给 Codex、Claude、DeepSeek 等 AI Agent。

使用方法

1. 在 VS Code 中打开项目，并在编辑器里选中代码或文本。
2. 按 Shift+Alt+L 复制上下文。默认快捷键仅在编辑器有选区时生效。
3. 将剪贴板内容粘贴到 AI Agent 对话框。
4. 从命令面板运行 Agent Context Bridge: 打开中文设置，可调整复制格式、项目路径、项目名称和快捷键字母。

输出格式及适用场景

短格式

示例：src/app.ts:12-34

只包含相对路径和起止行号，内容最精简。适合把代码位置发给能够访问同一个项目目录的 Agent，例如 VS Code 内打开了同一仓库的 Codex、Claude 或 DeepSeek Agent。接收方必须能在对应项目中找到该相对路径；如果对方没有这个项目或项目目录结构不同，仅凭短格式无法读取代码。

通用路径引用

示例：src/app.ts#L12-L34

包含相对路径和行号范围，格式简单，适合跨 Agent 复制位置。它不包含代码正文，因此接收方仍需能访问同一个项目。对于不同电脑上的协作者，只有在项目路径结构一致、Agent 能读取该仓库时才方便定位。

通用上下文包

包含项目名称、相对路径、行号范围、语言和选中的代码正文。适合发给不同 Agent 或不同电脑上的协作者；即使接收方无法访问你的本地项目，也能直接看到代码内容。若启用“包含本机工作区路径”，上下文包还会带上当前电脑的项目绝对路径，供同机 Agent 定位。

Claude Code 引用

示例：@src/app.ts#12-34

适合 Claude Code 识别的文件提及格式。Claude Code 需要能够访问同一个项目；转发到不支持 @文件#行号 的 Agent 时，它可能只会被当成普通文字。

Codex 引用

示例：@src/app.ts#L12-L34

这是便于 Codex 读取的纯文本路径和行号引用。它不是 Codex 对话中显示为可点击卡片的 textBlock 文件引用；跨应用粘贴时也不保证自动变成可点击链接。接收方需要能访问对应项目。

本机 file:// 链接

示例：file:///.../src/app.ts#L12-L34

使用当前电脑上的文件绝对路径，适合在同一台电脑上、且支持 file:// 的客户端之间跳转。发给其他电脑时，本机路径通常不存在；发给无法读取文件链接的 Agent 时也只能作为普通文字参考。

设置

从命令面板运行 Agent Context Bridge: 打开中文设置。设置页面会跟随 VS Code 显示语言，修改后立即保存。

• 默认输出格式：选择上面介绍的六种格式；默认是短格式。
• 包含本机工作区路径：控制通用上下文包是否附带当前电脑的项目绝对路径。
• 项目名称：可填写团队使用的名称；留空时使用工作区目录名。
• 复制上下文快捷键：固定为 Shift + Alt + 字母；Shift 和 Alt 不可更改，第三个按键可从 A 到 Z 中选择，默认是 L。快捷键仅在编辑器有选区时触发；若所选组合键与其他命令冲突，可换一个字母。

隐私

扩展只把选中内容复制到系统剪贴板，不会把代码发送到网络服务，也不会自动切换或聚焦其他 Agent 应用。粘贴到哪个 Agent 由你决定。

英文说明另见同目录下的 README.en.md。