OpenCode 简介

OpenCode 是一款基于终端用户界面（TUI）的 AI 辅助开发工具。它具备跨平台稳定性（Windows/macOS），支持鼠标交互，并能通过 LSP（语言服务器协议）深度集成开发环境。其核心优势在于能够利用 API 代理服务接入各类主流大模型（如 Gemini, GPT, Claude），并通过多智能体协作提升复杂任务的处理效率。

1. 基础安装与初始化

1.1 环境准备与安装

OpenCode 依赖 Node.js 环境，建议使用 pnpm 进行全局安装以确保依赖管理的稳定性。

pnpm install -g opencode-ai

1.2 初始化配置

首次运行 OpenCode 后，系统会在用户目录下生成配置文件 ~/.config/opencode/opencode.json。建议将文件后缀修改为 .jsonc 以支持注释功能，便于后续维护。

1.3 连接模型服务

在 OpenCode 交互界面中输入 /connect 指令，可快速配置 Anthropic 或 OpenAI 的 API Key。

2. 核心配置文件详解

针对通过 API 中转服务接入模型的需求，需对 provider 字段进行精细化配置。以下为标准配置示例，包含了对推理模型（如文中提到的 GPT-5.2）的特殊参数优化。

{
  "$schema": "https://opencode.ai/config.json",
  // MCP 工具集配置
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["pnpx", "@upstash/context7-mcp"],
      "enabled": true
    }
  },
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://您的中转服务地址/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://您的中转服务地址/v1"
      },
      "models": {
        // 针对特定推理模型的参数优化
        "gpt-5.2": {
          "options": {
            "include": ["reasoning.encrypted_content"],
            "store": false,
            "reasoningEffort": "high",
            "textVerbosity": "high",
            "reasoningSummary": "auto"
          }
        }
      }
    }
  }
}

3. 生态扩展：Oh-my-opencode

Oh-my-opencode 是 OpenCode 的异步子代理（Sub-Agent）工具包，内置了 LSP/AST 工具及精选的 MCP（Model Context Protocol）工具集，并提供 Claude Code 兼容层，是实现多智能体协作的关键组件。

3.1 部署方式

通过以下命令进行交互式安装，向导将自动处理订阅接入与插件配置：

pnpx oh-my-opencode install

3.2 多智能体（Multi-Agent）编排

安装完成后，通过 oh-my-opencode.json 文件定义不同职能的 Agent 及其调用的底层模型。这种分工机制能有效平衡成本与性能。

推荐的 Agent 角色配置：

Agent 角色 职能描述 推荐模型架构
Sisyphus 主代理，负责任务协调与简单执行 GPT-5.2 High
Oracle 处理高难度任务及 Debug GPT-5.2
Librarian 检索第三方库与文档信息 Claude Sonnet 3.5/4.5
Explore 存量代码库探索与分析 Claude Sonnet 3.5/4.5
Frontend-UI 前端交互与视觉设计 Gemini 3 Pro High
Document-Writer 技术文档撰写 Gemini 3 Flash
Multimodal-Looker 多模态内容识别与处理 Gemini 3 Flash

注：部分 Google 模型需配合 opencode-antigravity-auth 插件使用。

4. 高级功能与工作流

4.1 LSP 深度集成

OpenCode 原生支持 LSP。只要环境变量中存在对应的语言服务器指令，工具在读取文件时将自动挂载 LSP，支持重命名（Rename）、跳转定义等重构操作，无需额外复杂配置。

4.2 任务管理与交互

  • 模式切换：明确区分“计划模式”与“执行模式”，确保任务路径清晰。
  • 多任务并发：支持同时启动多个子模型异步运行。
  • 快捷键操作：
  • Ctrl+X + 方向键：在不同子任务间快速切换。
  • Ctrl+X + ↑：快速返回主任务视图。
  • 鼠标操作：TUI 界面完整支持鼠标点击、文本复制及历史消息编辑。

4.3 插件系统与个性化

  • 功能插件：推荐安装长期记忆（Long-term memory）、语音/消息提醒及时间统计插件，以增强辅助能力。
  • 协作分享：输入 /share 可生成当前会话的网页链接，便于团队协作与代码审查。
  • 视觉主题：输入 /theme 可切换界面主题（如 Catppuccin），保持与 VSCode 等编辑器一致的视觉体验。