引擎概览

GolemBot 支持四种 Coding Agent 引擎。四者对外暴露相同的 StreamEvent 接口 — 切换引擎只需改一行配置。

对比

	Cursor	Claude Code	OpenCode	Codex
二进制	agent	claude	opencode	codex
输出格式	stream-json	stream-json	NDJSON	NDJSON
技能注入	.cursor/skills/	.claude/skills/ + CLAUDE.md	.opencode/skills/ + opencode.json	AGENTS.md
会话恢复	--resume <id>	--resume <id>	--session <id>	resume <thread_id>
API Key	CURSOR_API_KEY	ANTHROPIC_API_KEY	取决于 Provider	CODEX_API_KEY
权限跳过	--force --trust --sandbox disabled	--dangerously-skip-permissions	opencode.json 权限配置	默认 unrestricted；safe 时使用 --full-auto
费用追踪	—	costUsd、numTurns	costUsd（累计）	—

统一的 StreamEvent

无论使用哪个引擎，assistant.chat() 都产出相同的事件类型：

type StreamEvent =
  | { type: 'text'; content: string }
  | { type: 'tool_call'; name: string; args: string }
  | { type: 'tool_result'; content: string }
  | { type: 'warning'; message: string }
  | { type: 'error'; message: string }
  | { type: 'done'; sessionId?: string; durationMs?: number;
      costUsd?: number; numTurns?: number };

一行切换

切换引擎只需修改 golem.yaml 中的 engine 字段。所有引擎暴露相同的 StreamEvent 接口——你的代码无需任何改动。

如何选择

不确定选哪个？

从 Claude Code 开始——综合体验最好，支持费用追踪，搭配 Anthropic 最新模型。随时可以切换。

• Cursor — 如果你已经在用 Cursor IDE 并有订阅
• Claude Code — 综合体验最佳；提供费用和轮次追踪
• OpenCode — 开源，支持多 LLM Provider（Anthropic、OpenAI、OpenRouter 等）
• Codex — OpenAI 官方 CLI agent（@openai/codex），使用 CODEX_API_KEY，默认 codex.mode: unrestricted

下一步

• Cursor — 安装、鉴权、模型列表
• Claude Code — 安装、鉴权、费用追踪
• OpenCode — 安装、多 Provider 配置
• Codex — 安装、API Key 模式
• 配置说明 — 完整 golem.yaml 参考