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 会话时顶上。

以下是插件合照