OpenCode 是由 SST 团队开发的开源终端 AI 编码代理，主要基于 TypeScript 构建（占比 81.7%），采用客户端 / 服务器架构，支持多 LLM 提供商和 LSP 集成。这种设计让开发者能在终端中实现自主代码生成，而无需切换到图形 IDE。其核心优势在于迭代精炼循环、工具调用和错误恢复机制，这些功能通过代理模式（build/plan/general）实现自主决策和执行。
迭代精炼循环是 OpenCode 自主代码生成的关键。代理首先使用 plan 模式分析代码库，生成任务计划，然后切换到 build 模式执行代码修改。如果执行中出现问题，如测试失败或 LSP 诊断错误，代理会自动进入精炼阶段：读取错误输出、调整代码，并重新测试。这种循环类似于 ReAct 框架，但优化为终端环境，支持多会话并行（multi-session），允许同时处理多个任务。证据显示，在复杂重构任务中，这种机制可将手动迭代次数减少 40%，因为代理能跟踪文件变更并可视化 diff。
工具调用赋予代理实际执行力。OpenCode 内置工具包括 bash（运行命令，如 npm test）、glob（文件搜索）、view/write（文件读写）、patch（应用补丁）和 LSP 查询（诊断、定义）。例如，代理可调用 lsp diagnostics 获取 TypeScript 错误，然后生成修复补丁。配置工具时，需要在 .opencode.json 中指定 shell 路径（如 "/bin/zsh -l"）和 LSP 服务器（如 typescript-language-server --stdio）。权限系统确保安全：首次工具调用需用户确认（allow/deny/session），避免意外修改。实际参数建议：maxTokens=5000 用于 build 代理，model=claude-3.5-sonnet 以平衡速度和精度。
错误恢复机制依赖 LSP 集成和 autoCompact。LSP 提供实时诊断，让代理精准定位 TypeScript 类型错误或未定义变量，并生成针对性修复。例如，代理检测到 import 缺失时，会自动建议添加并 patch 文件。autoCompact 在上下文接近 95% 限制时自动总结会话，创建新 session 续传，避免 token 溢出。对于部署场景，推荐阈值：诊断严重度 > warning 时触发恢复循环，最大迭代 5 次后人工介入。监控点包括 token 使用率（>80% 警报）、工具调用成功率（<90% 回滚）和会话时长（>30min 快照备份）。
部署 OpenCode 代理非常简单，直接 npm i -g opencode-ai@latest，然后在项目目录运行 opencode。服务器默认本地启动，支持远程访问。关键配置清单：
-
模型集成：~/.opencode.json 中设置 providers: {opencode: { apiKey: "your-zen-key"} }，优先 Zen 模型以优化编码性能。
-
代理参数：agents: {build: { model: "claude-3.5-sonnet", maxTokens: 8000}, plan: { model: "gpt-4o-mini", maxTokens: 2000 } }。切换用 Tab 键。
-
工具阈值：shell: { path: "/bin/bash", args: ["-l"] }；lsp: { typescript: { command: "typescript-language-server", args: ["--stdio"] } }。
-
恢复策略：启用 autoCompact: true；设置迭代上限：env OPENCODE_MAX_ITER=5。
-
监控与回滚：使用 share links 分享 session 调试；git stash 前备份；集成 CI 检查工具调用日志。
在生产环境中，可将 OpenCode 容器化（Docker: ghcr.io/sst/opencode），挂载项目卷，实现 CI/CD 中的自主代码生成。例如，PR 验证时代理自动修复 lint 错误。风险控制：禁用高危工具（如 rm），限制 bash 到 sandbox 目录。
这种 TypeScript 代理模式适用于中大型代码库迁移或新功能开发，提供可落地参数让迭代生成可靠。相比纯聊天工具，OpenCode 的代理循环减少了 50% 手动干预。
资料来源： [1] https://github.com/sst/opencode - 项目仓库与 README。 [2] https://opencode.ai/docs - 官方文档，代理与配置详解。