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. Сравнение с конкурентами
| Фича | OpenCode | Claude Code | Codex |
|---|---|---|---|
| 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. Полезные ссылки
- Сайт: opencode.ai
- Документация: opencode.ai/docs
- GitHub (новый): anomalyco/opencode (227k★)
- Старый репозиторий (архив): opencode-ai/opencode → продолжен как Crush
- Desktop Downloads: opencode.ai/desktop
- Mobile: iOS TestFlight | Android Play Store
- SDK Docs: opencode.ai/docs/build/sdk
- Discord: discord.gg/opencode
Чек-лист первого запуска
curl -fsSL https://opencode.ai/v2/install | bashopencode— запуск TUI- Выберите модель (бесплатная или BYOK)
- Включите MCP серверы под свои инструменты
- Создайте 1-2 кастомных агента под свои задачи
- Настройте permissions под свой уровень доверия
- Попробуйте multi-session: несколько вкладок над одним проектом
