OpenCode 与 GitHub Copilot 计费差异及优化实践

// 检查是否是 subagent session（有父任务）
if(session.parentID) {
    // 添加特殊 header，标记为 AI 自动发起
    headers["x-initiator"] = "agent"
}

这与 VS Code 的机制一致，都是 GitHub Copilot 官方支持的标记方式。

修复效果：

• ✅ 主任务（用户发起）：正常计费
• ✅ 主任务的循环（修复前）：每次循环都计费
• ✅ 主任务的循环（修复后）：仍然计费（因为没有 parentID）
• ✅ 子任务（有 parentID）：全部不计费
• ✅ 子任务中的所有 LLM 调用：不计费

注意：修复主要针对 Subagent 功能，主任务的循环仍会计费！这意味着我们需要调整使用策略，尽量利用子任务来分摊工作。

解决方案与最佳实践

1. 立即升级

确保你的 OpenCode 版本在 v1.1.31 以上。

# 检查当前版本
opencode --version

# 升级到最新版本
npm update opencode-ai@latest
# 或 brew upgrade opencode

2. 充分利用 Subagent 功能

升级后，可以通过 @general 等 subagent 来拆分任务，这样大部分内部调用都不再计费。

# 推荐：让 AI 自动拆分子任务
opencode run "重构整个项目，使用 @general 分析最佳实践"

关键原则：尽量让 AI 自己创建子任务，而不是在主任务中做所有事情。

方法一：使用 @ 语法手动委托

# ❌ 避免：在主任务中执行多步骤操作
你：帮我重构 src 目录下的所有文件

# ✅ 推荐：让 AI 创建 subagent 处理
你：帮我重构 src 目录，使用 @general 分析并逐个文件处理

内置 Subagent 包括：

• @general：通用多步骤任务（推荐用于复杂重构）
• @explore：代码探索和分析（只读，不会修改代码）

方法二：通过配置强制使用 Subagent

可以在 opencode.json 中配置命令模板，强制某些操作作为子任务执行。

{
  "command": {
    "refactor": {
      "template": "重构 {input}，使用最佳实践",
      "subtask": true,
      "agent": "general"
    }
  }
}

使用方式：

opencode /refactor src/utils/
# 自动创建 subagent，不计费

3. 自定义 Subagent 配置

支持两种配置格式，JSON 适合简单配置，Markdown 适合复杂 Prompt。

JSON 配置示例：

{
  "agent": {
    "reviewer": {
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4-20250514",
      "description": "专门用于代码审查的子代理",
      "prompt": "你是一个专业的代码审查专家...",
      "steps": 50
    }
  }
}

Markdown 配置示例：

---
mode: subagent
model: anthropic/claude-sonnet-4-20250514
description: 专门用于代码审查的子代理
steps: 50
---
你是一个专业的代码审查专家。审查代码时：
1. 检查潜在的 bug
2. 提出性能优化建议
3. 评估代码可读性

使用方式：

你：使用 @reviewer 审查这个文件
# 自动作为 subagent 执行，不计费

4. 关键字段说明：steps vs maxSteps

在 OpenCode 配置中，推荐使用 steps 字段，maxSteps 已弃用。

// ✅ 正确写法
{
  "agent": {
    "build": {
      "steps": 10
    }
  }
}

// ⚠️ 旧写法（仍可用，但不推荐）
{
  "agent": {
    "build": {
      "maxSteps": 10
    }
  }
}

如果同时配置了两者，系统会优先使用 steps 值。

5. 调整主任务配置（辅助策略）

如果确实需要在主任务中操作，可以通过配置减少循环次数和权限风险。

{
  "agent": {
    "build": {
      "steps": 10
    }
  },
  "permission": {
    "read": "allow",
    "glob": "allow",
    "edit": "ask",
    "bash": "ask",
    "task": "allow"
  }
}

关键配置说明：

• steps: 防止无限循环
• edit: "ask": 可以在关键步骤拒绝，提前结束循环
• task: "allow": 允许 AI 自动创建 subagent，这是节省成本的关键

总结与建议

这次经历让我意识到，自动化是把双刃剑：省力但可能费钱。理解计费原理至关重要。

1. 理解架构差异：VS Code 是流式连接，OpenCode 是循环架构。Subagent 是 OpenCode 的成本优化利器。
2. 关注版本更新：v1.1.31 修复了 Subagent 计费问题，充分利用时成本可节省高达 90%。
3. 合理配置：权限 + 步数限制 + subagent 组合使用，才能在保证效率的同时控制成本。

现在，我的 Copilot 用量恢复正常了，开发效率却提升了不止一倍。希望这篇分享能帮到同样遇到问题的你。