第 02 模块 · 2 节

选择与启动 Agent:Claude Code、Codex、Cursor CLI

《Orca 基础入门》02 第一次多 Agent 会话 · 本节时长 26 分钟

核心机制Orca 的 Agent 选择器(combobox)本质上只是「在正确的工作目录里启动一个 CLI 进程」——所以几乎任何 CLI Agent 都能跑,预配置的那批则带一键启动、状态检测、用量追踪等深度集成。

启动入口

在工作树的终端标签里,顶部有一个 agent combobox。点开它:

  • 列出全部预配置 Agent(一键启动 / 自动 setup)
  • 选择后,Orca 以该工作树为工作目录启动 Agent CLI,并转发你本地的订阅凭据(读取 ~/.claude~/.codex 等)
  • 也可以选 Blank Terminal,先空终端,之后再从终端手动启动

预配置的 Agent 列表(节选)

Agent 集成深度 说明
Claude Code 深度:用量、热切换、hooks 读取 ~/.claude,自动识别登录
Codex 深度:用量、热切换 读取 ~/.codex,支持多账号
Cursor CLI 深度集成 自动检测 PATH 上的 cursor CLI
Gemini / Grok / Copilot CLI 自动 setup 启动时引导配置
OpenCode / Pi / OMP 自动 setup + hooks + 状态 状态检测齐全
Aider / Goose / Cline 等 自动 setup 覆盖社区主流 CLI

完整清单见官方文档 Supported agents 页。只要你的 Agent 是 CLI,就大概率能用——combobox 之外的也可以手动输入命令启动,只是少了状态检测等深度集成。


免权限标志:为什么默认全开

Orca 启动每个受支持的 Agent 时,会预填其免权限标志

  • Claude Code:--dangerously-skip-permissions
  • Codex:--dangerously-bypass-approvals-and-sandbox
  • Gemini / Cursor / Grok / Kimi 等:--yolo
设计理由工作树就是沙箱:Agent 在自己的 checkout 里随便实验,不会碰到别的任务的文件。省掉每个工具调用都要点「允许」的打断,流式体验才能成立。你可以在合并前审 diff、挑拣或整个丢弃。

想改默认? Settings → Agents → 展开该 Agent 行,编辑它的 launch arguments,Orca 会记住覆盖并应用到之后的每次启动;旁边 Reset 按钮可还原官方默认。


深度集成:Claude Code / Codex 示例

Claude Code:装好 CLI 并登录一次(npm i -g @anthropic-ai/claude-code),Orca 自动读取 ~/.claude。启动后状态行 hook 输出 OSC 事件,Orca 用它渲染状态点。子 Agent / Agent Teams 队友会显示为主 Agent 下的可展开子行。

Codex:按官方文档安装并登录,Orca 读取 ~/.codex。支持账号热切换(不用重新登录)与用量/限流显示。Windows 上还能把 Codex 跑在 WSL distro 里,账号 home 独立隔离。

对接 DeepSeek 等国内大模型:完全沿用本站 Claude Code / Codex 课程里的 provider 配置方式——Orca 不参与模型层,你配在 Agent CLI 的配置里,它照常启动。


落地练习:启动一个 Agent

  1. 打开上节课的 hello-orca 工作树
  2. 在 agent combobox 里选择 Claude Code(或你已装好的任一 Agent)
  3. 观察它是否以正确的工作目录启动、能否读取到已有登录
  4. 输入一句「告诉我当前分支名和仓库状态」,验证 Agent 在工作树里干活
  5. 打开 Settings → Agents,看一下默认 Agent 与 launch arguments 设置

怎么判断做对了?——Agent 正常启动且回答能看到当前 worktree 的文件状态;状态栏出现该 Agent 的用量/状态指示。

卡住了怎么办? combobox 里没有你的 Agent:先确认 CLI 装好且在 PATH;深度集成依赖本地登录,claude / codex 在普通终端里能跑 Orca 里才能用。


小结

  1. Agent combobox = 在正确目录启动 CLI 进程 + 转发本地凭据
  2. 内置数十款预配置 Agent,任意 CLI 也基本可用
  3. 默认给 Agent 加免权限标志,工作树本身即沙箱
  4. launch arguments 可在 Settings → Agents 覆盖
  5. 模型配置跟随 Agent CLI 本身,Orca 不介入

下一节,让三个 Agent 并行赛跑。