OpenCode: полное руководство по открытому coding-агенту

OpenCode — это open-source AI-агент для кодинга, который работает везде: десктопное приложение (macOS/Windows/Linux), терминал (TUI), мобильное приложение (iOS/Android) и через SDK в ваших скриптах/CI. Разработан командой Anomaly, 227k+ звёзд на GitHub.

1. Установка и быстрый старт

# Самый простой способ (все платформы)
curl -fsSL https://opencode.ai/v2/install | bash

# Или через пакетные менеджеры
npm install -g @opencode/cli          # Node.js
bun install -g --trust @opencode/cli  # Bun
brew install anomalyco/tap/opencode-v2 # macOS (Homebrew)
paru -S opencode-beta                 # Arch Linux

После установки:

opencode              # Запуск TUI в терминале
opencode serve        # Запуск API сервера для SDK/десктопа
opencode auth login   # Авторизация (опционально, для платных моделей)

2. Ключевые концепции

Any Model — 200+ провайдеров

OpenCode использует Models.dev для доступа к 200+ LLM: OpenAI, Anthropic, Google, OpenRouter, Ollama, LM Studio, vLLM, локальные модели. Бесплатные модели доступны сразу без ключей.

Any Device — 4 интерфейса

  • Desktop App — нативное приложение с вкладками, сессиями, diffs, встроенным браузером, расширениями
  • Terminal (TUI) — быстрый интерфейс в любом шелле, редакторе, на удалённом сервере
  • Mobile — iOS (TestFlight) / Android (Play Store) — управление сессиями с телефона
  • SDK — управление OpenCode из своих скриптов, CI, инструментов (docs)

Multi-Session

Можно запускать несколько агентов параллельно над одним проектом — каждый в своей сессии с собственным контекстом.

3. Продвинутые фишки

Плагины (Plugins)

Хукаются в события OpenCode, расширяют логику. Пишутся на TypeScript/JS.

// .opencode/plugins/my-plugin.ts
export default {
  name: "my-plugin",
  hooks: {
    "session:start": async (ctx) => {
      console.log("Session started:", ctx.session.id);
    },
    "tool:call": async (ctx, tool, args) => {
      if (tool === "write") {
        // авто-форматирование после записи
        await ctx.runCommand("prettier --write", args.path);
      }
    }
  }
};

MCP Серверы

Подключение внешних инструментов через Model Context Protocol:

# .opencode/mcp.json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "$DATABASE_URL"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}

Кастомные агенты (Custom Agents)

Создание специализированных агентов с собственными промптами, моделями, инструментами:

# .opencode/agents/backend-expert.md
---
name: backend-expert
description: "Use for backend development: APIs, databases, architecture."
model: "anthropic/claude-3.5-sonnet"
tools: [read, write, edit, bash, grep, mcp:postgres]
---

You are a backend expert. Focus on:
- Clean architecture, SOLID principles
- Database design, migrations
- API security, rate limiting
- Performance optimization
- Observability (logs, metrics, traces)

Agent Skills (SKILL.md)

Обучение агентов повторяющимся рабочим процессам:

# .opencode/skills/deploy.md
---
name: deploy
description: "Use when deploying to production. Runs full pipeline."
tools: [bash, read, write, mcp:github]
---

Deploy procedure:
1. Run tests: npm run test
2. Build: npm run build
3. Check bundle size: npm run analyze
4. Create GitHub release
5. Deploy to Vercel/AWS
6. Verify health endpoint
7. Notify team

Custom Commands (Slash Commands)

Превращение рутины в переиспользуемые команды:

# .opencode/commands/refactor.md
---
name: refactor
description: "Refactor code with safety checks"
args: ["target", "goal"]
---
Refactor $ARG_TARGET to $ARG_GOAL.
Steps:
1. Read file and understand context
2. Write tests if missing
3. Refactor incrementally
4. Run tests after each step
5. Update documentation

Вызов: /refactor src/api/users.ts "extract service layer"

Permissions — контроль действий

Настройка, какие действия выполняются автоматически, а какие требуют подтверждения:

# .opencode/permissions.json
{
  "allow": ["read", "grep", "glob", "list"],
  "ask": ["write", "edit", "bash"],
  "deny": ["bash(rm -rf*)", "bash(sudo*)"]
}

Undo / Redo — откат изменений

Команда /undo откатывает недавние изменения файлов и разговора. /redo — возвращает обратно.

4. Конфигурация

Основной конфиг: .opencode.json в корне проекта или ~/.config/opencode/config.json глобально.

{
  "model": "anthropic/claude-3.5-sonnet",
  "theme": "dark",
  "permissions": {
    "allow": ["read", "grep"],
    "ask": ["write", "bash"]
  },
  "mcpServers": { ... },
  "agents": {
    "backend-expert": { "model": "claude-3.5-sonnet" }
  }
}

5. Бесплатные модели и OpenCode Go

  • Free models — встроенный набор бесплатных моделей (через Models.dev), без аккаунта
  • OpenCode Go — $10/мес за доступ к курированным моделям без лимитов
  • BYOK — Bring Your Own Key: подключаете свои подписки (ChatGPT Plus, GitHub Copilot, Anthropic, OpenRouter)

6. Сравнение с конкурентами

ФичаOpenCodeClaude CodeCodex
Open Source✅ MIT❌ Proprietary✅ Apache-2.0
Desktop App✅ Нативное❌ Только терминал❌ Только терминал
Mobile App✅ iOS/Android❌❌
Multi-Session✅❌❌
Plugins✅ TypeScript/JS❌❌
Custom Agents✅✅ Subagents❌
Skills✅ SKILL.md❌❌
MCP✅✅❌
Undo/Redo✅❌❌
200+ Models✅Только AnthropicТолько OpenAI
Free Tier✅ ВстроенныеТолько с подпискойТолько с API ключом

7. Полезные ссылки

Чек-лист первого запуска

  1. curl -fsSL https://opencode.ai/v2/install | bash
  2. opencode — запуск TUI
  3. Выберите модель (бесплатная или BYOK)
  4. Включите MCP серверы под свои инструменты
  5. Создайте 1-2 кастомных агента под свои задачи
  6. Настройте permissions под свой уровень доверия
  7. Попробуйте multi-session: несколько вкладок над одним проектом