启动入口
在工作树的终端标签里,顶部有一个 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
想改默认? 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
- 打开上节课的
hello-orca工作树 - 在 agent combobox 里选择 Claude Code(或你已装好的任一 Agent)
- 观察它是否以正确的工作目录启动、能否读取到已有登录
- 输入一句「告诉我当前分支名和仓库状态」,验证 Agent 在工作树里干活
- 打开 Settings → Agents,看一下默认 Agent 与 launch arguments 设置
怎么判断做对了?——Agent 正常启动且回答能看到当前 worktree 的文件状态;状态栏出现该 Agent 的用量/状态指示。
卡住了怎么办? combobox 里没有你的 Agent:先确认 CLI 装好且在 PATH;深度集成依赖本地登录,claude / codex 在普通终端里能跑 Orca 里才能用。
小结
- Agent combobox = 在正确目录启动 CLI 进程 + 转发本地凭据
- 内置数十款预配置 Agent,任意 CLI 也基本可用
- 默认给 Agent 加免权限标志,工作树本身即沙箱
- launch arguments 可在 Settings → Agents 覆盖
- 模型配置跟随 Agent CLI 本身,Orca 不介入
下一节,让三个 Agent 并行赛跑。