VS Code 集成 Agent CLI 的三种路径

VS Code 集成 Agent CLI 的三种路径

现在主流的 AI Coding Agent（Claude Code、Codex、CodeBuddy 等）几乎都以 CLI 形态存在——它们本就是设计给终端跑的。所以"在 VS Code 里用 Agent"本质上就是"在 VS Code 里把终端里的 Agent 跑得顺手"。

由浅入深，有三条路：

路径	需要装什么	长什么样	适合谁
① Terminal Profile	什么都不用装，改个设置	新建终端下拉里多个选项	喜欢轻量、自己掌控一切的人
② AI Agents Terminal 插件	装一个扩展	状态栏一个按钮，点开选 Agent	装了一堆 Agent、想一键切换的人
③ Agent YOLO 插件	装一个扩展	侧边常驻一个 Agent 面板	想要"面板里直接聊 + 点路径跳转"的人

下面用用户视角讲清楚每条路怎么用、体验如何。

---

路径一：Terminal Profile（纯设置，零依赖）

最朴素也最稳。VS Code 允许你在设置里把任意命令注册成一个"终端配置项"，之后在 终端 → 新建终端 的下拉里就能直接选。

配置文件路径（用户 settings.json）：

系统	路径
macOS	~/Library/Application Support/Code/User/settings.json
Windows	%APPDATA%\Code\User\settings.json
Linux	~/.config/Code/User/settings.json

也可以不手动改文件：在 VS Code 里按 Cmd/Ctrl+Shift+P → 搜 Preferences: Open User Settings (JSON) 直接打开它。配置项放在根对象下的 terminal.integrated.profiles 里即可。

比如下面这段是我本机设置里实际在用的（为 Claude Code / Codex 各建了"自动批准"和"Resume"两个入口）：

{
  "terminal": {
    "integrated": {
      "profiles": {
        "osx": {
          "Claude Code": {
            "path": "claude",
            "args": ["--dangerously-skip-permissions"],
            "icon": "robot"
          },
          "Claude Code Resume": {
            "path": "claude",
            "args": ["--dangerously-skip-permissions", "-r"],
            "icon": "history"
          },
          "Codex": {
            "path": "codex",
            "args": ["--full-auto"],
            "icon": "robot"
          },
          "Codex Resume": {
            "path": "codex",
            "args": ["--full-auto", "--resume"],
            "icon": "history"
          }
        }
      }
    }
  }
}

说明：

• path 写命令名（在 PATH 里即可），也可写绝对路径，比如 "/opt/homebrew/bin/claude"。
• args 直接把 auto‑approve / resume 这类开关固化进去，例如 Claude 的 --dangerously-skip-permissions、-r，Codex 的 --full-auto --resume。
• icon 用 VS Code 内置图标名（robot、history、package…），不用额外图片。
• osx / windows / linux 可分开写，方便一份设置跨平台同步。

体验：打开就是完整的原生终端（多标签、分屏、复制粘贴全都在）；把设置文件同步一下，多台机器直接复用。
局限：Agent 多了下拉会变长；"自动批准"、"RESUME"这些开关是写死在 args 里的，想临时切换得回去改设置；每个 Agent 该加什么标志参数得自己记。

---

路径二：AI Agents Terminal 插件（状态栏一键启动）

当 Agent 装了一堆、又想随手切换 + 随时开关"自动批准"时，纯 Profile 就不够了。装 AI Agents Terminal 这个扩展即可。

装好后在状态栏多了一个按钮 🤖 AI Agents：

• 点开是一个列表，里面只列出你机器上装了的 Agent（自动探测），选中就在新终端里拉起。
• 还有两个开关按钮：
  • Y（YOLO 模式）：拉起时自动带上该 Agent 的"跳过权限"标志，让它无需确认直接干活。快捷键 Cmd/Ctrl+Alt+Y。
  • R（Resume 模式）：拉起时自动带上"续上一次会话"的标志。快捷键 Cmd/Ctrl+Alt+R。

它同时也会在 终端 → 选择默认配置 里注册对应的终端配置项，所以这两种入口你都能用。

配置都在 VS Code 的设置界面里，关键是 aiAgentsTerminal.agents——一个覆盖/扩充内置 Agent 列表的数组，想要改哪个 Agent 就只写要改的字段：

{
  "aiAgentsTerminal.agents": [
    { "command": "claude", "skipFlag": "--dangerously-skip-permissions", "resumeFlag": "-r" },
    { "command": "codex",  "skipFlag": "--full-auto",  "resumeFlag": "--resume" },
    { "command": "some-agent", "enabled": false }   // 不想看到的 Agent 直接关掉
  ],
  "aiAgentsTerminal.yoloMode": true   // 全局默认开启自动批准
}

内置已经带了几十个常见 Agent（Claude / Codex / Cursor / CodeBuddy…）的参数，你一般只需挑要用的、按需调一下标志即可。启动参数顺序固定为 baseArgs → skipFlag → resumeFlag，所以 YOLO 和 Resume 可以叠加生效。

体验：多 Agent 切换零摩擦；YOLO / Resume 一键全局开关；没装的 Agent 不会出现在列表里，很干净。
局限：拉起来仍是 VS Code 原生集成终端（和路径一一样），没有"面板内嵌 + 链接点击"的体验。

---

路径三：Agent YOLO 插件（侧边常驻面板）

如果你想要的不是"开个终端"，而是一个常驻在侧边的 Agent 面板，装 Agent YOLO 这个扩展。

装好后 Activity Bar 多了一个 Agent YOLO 图标，点开是一个内嵌终端面板——Agent 跑在面板里，不用再占一个独立的终端标签页。

配置都在 VS Code 设置里（yolo.* 命名空间），没有面板内的设置视图——改完 yolo.agents 等之后，下一次启动 Agent 时生效。

它最实用的特性是可点击链接：终端输出里出现的文件路径，能直接点开跳到对应文件与行。对"Agent 改了一堆文件、你想直接点进去看"的场景非常顺手。

配置走 yolo.* 命名空间（和路径二的 aiAgentsTerminal.* 是分开的两套）。几个常用项：

{
  "yolo.agents": [
    { "command": "claude", "skipFlag": "--dangerously-skip-permissions", "resumeFlag": "-r" }
  ],
  "yolo.permissionRules": [
    { "agentId": "claude", "flag": "--dangerously-skip-permissions" },
    { "agentId": "codex",  "flag": "--full-auto" }
  ],
  "yolo.agentBaseArgs": { "cursor-agent": "agent", "kilo": "run" },
  "yolo.yoloMode": false,     // 面板里的 Y 按钮切换
  "yolo.resumeMode": false    // 面板里的 R 按钮切换
}

yolo.agents 的字段和路径二几乎一样（command / displayName / baseArgs / skipFlag / resumeFlag / iconFile / enabled / id），所以你只有一套心智模型；区别只是 yolo 把启动参数拆成了 permissionRules、agentBaseArgs 等几张独立列表，方便做更细的 per‑Agent 配置。

体验：Agent 常驻侧边面板、不占终端标签页；输出里的文件路径可点击跳转；配置在 VS Code 设置里（yolo.*），无面板内设置视图。
局限：比路径一/二"重"一些；与路径二是两个独立扩展，可按使用习惯二选一或并存。

---

怎么选

• 只装一两个 Agent、追求极简 → 路径一（Terminal Profile），一份设置走天下。
• 装了一堆、要频繁切换 + 一键 YOLO/Resume → 路径二（AI Agents Terminal），状态栏点一下就拉起。
• 想要面板常驻 + 点链接直接跳文件 → 路径三（Agent YOLO），把 Agent 真正嵌进编辑器工作区。

三者并非互斥：我本机就是三者并存——Profile 给我"随手开一个干净终端"的入口，AI Agents Terminal 插件给我"一键全自动拉起"的快捷方式，而Agent YOLO则在需要沉浸式、可点击的 Agent 会话时顶上。

以下是插件合照