Главная / Как установить и использовать OpenCode: полное руководство

Как установить и использовать OpenCode: полное руководство

8 февраля 2026

Оглавление

  1. Что такое OpenCode
  2. Системные требования
  3. Методы установки
  4. Начальная настройка
  5. Использование терминального пользовательского интерфейса (TUI)
  6. Команды CLI
  7. Конфигурация
  8. Продвинутые возможности
  9. Лучшие практики
  10. Устранение неполадок
  11. Встраивание OpenCode в ваш рабочий процесс
  12. Заключение

1. Что такое OpenCode

OpenCode — AI-ассистент для программирования, который помогает вам:

Он поддерживает множество провайдеров LLM, включая Anthropic, OpenAI, Google и других, давая вам свободу выбора моделей, которые лучше всего подходят под ваши задачи.

2. Системные требования

Предварительные требования

Перед установкой OpenCode убедитесь, что у вас есть:

3. Методы установки

Метод 1: Скрипт установки (рекомендуется)

Самый быстрый способ установить OpenCode — использовать официальный скрипт установки:

curl -fsSL https://opencode.ai/install | bash

Этот метод работает на macOS, Linux и Windows (с Git Bash или WSL).

Метод 2: Использование менеджеров пакетов Node.js

Через npm:
npm install -g opencode-ai
Через Bun:
bun install -g opencode-ai
Через pnpm:
pnpm install -g opencode-ai
Через Yarn:
yarn global add opencode-ai

Метод 3: Использование Homebrew (macOS и Linux)

brew install opencode

Метод 4: Использование Paru (Arch Linux)

paru -S opencode-bin

Метод 5: Установки, специфичные для Windows

Через Chocolatey:
choco install opencode
Через Scoop:
scoop bucket add extras
scoop install extras/opencode
Через Mise:
mise use -g github:sst/opencode

Метод 6: Docker

Для работы в контейнере:

docker run -it --rm ghcr.io/sst/opencode

Метод 7: Скачивание бинарного файла

Вы можете скачать скомпилированный бинарник напрямую со страницы релизов на GitHub.

Проверка установки

После установки проверьте, что всё работает:

opencode --version

Должен отобразиться номер версии.

4. Начальная настройка

Подключение к OpenCode Zen (рекомендуется для новичков)

OpenCode Zen — это курируемый список моделей, протестированных и подтверждённых командой OpenCode. Это самый простой способ начать работу.

cd /path/to/your/project
opencode
/connect

Подключение к другим провайдерам

Вы также можете подключить OpenCode к другим провайдерам LLM:

Используя команду /connect:
/connect

Выберите предпочитаемого провайдера (Anthropic, OpenAI, Google и т. д.) и следуйте шагам аутентификации.

Через CLI аутентификацию:
opencode auth login

Этот процесс поможет настроить API-ключи для любого провайдера на Models.dev.

Просмотр списка настроенных провайдеров:
opencode auth list

или коротко:

opencode auth ls
Выход из учётной записи провайдера:
opencode auth logout

Настройка контекста проекта

После настройки провайдера инициализируйте OpenCode для вашего проекта:

cd /path/to/your/project
opencode
/init

Это проанализирует структуру вашего проекта и создаст файл AGENTS.md в корне проекта. Этот файл помогает OpenCode лучше понять ваши шаблоны кодирования, фреймворки и архитектуру.

Совет: Добавьте AGENTS.md в Git. Это поможет поддерживать консистентность команды и улучшит понимание проекта OpenCode со временем.

5. Использование терминального пользовательского интерфейса (TUI)

TUI OpenCode предлагает интерактивный опыт прямо в терминале.

Запуск TUI

Просто запустите:

opencode

Или с дополнительными параметрами:

# Продолжить последнюю сессию
opencode --continue

# Продолжить определённую сессию
opencode --session 

# Запустить с подсказкой
opencode --prompt "Explain this codebase"

# Использовать конкретную модель
opencode --model anthropic/claude-sonnet-4-5

# Использовать определённого агента
opencode --agent plan

Основы навигации в TUI

Задание вопросов

Вы можете задавать OpenCode вопросы о вашем коде:

How is authentication handled in @packages/functions/src/api/index.ts

Используйте символ @, чтобы ссылаться на конкретные файлы. OpenCode анализирует эти файлы и предоставляет подробные объяснения.

Добавление функционала

OpenCode отлично подходит для добавления новых функций через двухрежимный рабочий процесс:

Шаг 1: Режим Планирования 
When a user deletes a note, we'd like to flag it as deleted in the database.
Then create a screen that shows all the recently deleted notes.
From this screen, the user can undelete a note or permanently delete it.
We'd like to design this new screen using a design I've used before.
[Image #1] Take a look at this image and use it as a reference.
Совет: Вы можете перетаскивать изображения в терминал — OpenCode отсканирует и проанализирует их. Шаг 2: Режим Создания 
Sounds good! Go ahead and make the changes.

OpenCode реализует функцию, создавая и изменяя файлы по необходимости.

Прямые изменения

Для простых изменений можно пропустить планирование:

We need to add authentication to the /settings route.
Take a look at how this is handled in the /notes route
in @packages/functions/src/notes.ts and implement the same logic
in @packages/functions/src/settings.ts

Отмена и повтор изменений

Сделали ошибку? Используйте команду отмены:

/undo

Она отменит последние изменения и позволит уточнить запрос.

Чтобы повторить отменённые изменения:

/redo

Команду /undo можно использовать несколько раз для отмены множества изменений.

6. Команды CLI

OpenCode предоставляет мощный CLI для программного доступа и автоматизации.

Выполнение запросов напрямую

Запускайте OpenCode без интерактива:

opencode run "Explain how closures work in JavaScript"

Полезно для скриптов, автоматизации или быстрых ответов без запуска TUI.

Управление моделями

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

opencode models

Фильтрация по провайдеру:

opencode models anthropic

Обновить кэш моделей (полезно при добавлении новых моделей):

opencode models --refresh

Показать подробную информацию о моделях, включая стоимость:

opencode models --verbose

Запуск безголового сервера

Поднять HTTP-сервер для API доступа:

opencode serve

С указанием порта:

opencode serve --port 3000

Это удобно для интеграции OpenCode в веб-приложения или для ускорения откликов в скриптах (без «холодного» старта MCP сервера).

Подключение к серверу

В одном терминале запустите сервер:

opencode serve

В другом терминале подключитесь к нему для быстрого выполнения:

opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Управление агентами

Создать нового кастомного агента:

opencode agent create

Пошаговая инструкция для создания агента с кастомными системными подсказками и настройками инструментов.

Интеграция с GitHub

Установить агента GitHub для автоматизации репозитория:

opencode github install

Настроит workflows GitHub Actions для автоматического ревью кода и управления issue.

Обновление OpenCode

Обновиться до последней версии:

opencode upgrade

Или до конкретной версии:

opencode upgrade v0.1.48

Указать метод установки при необходимости:

opencode upgrade --method brew

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

OpenCode поддерживает гибкую конфигурацию через JSON-файлы.

Расположение конфигураций

Файлы конфигураций объединяются (не заменяются), что позволяет иметь глобальные, проектные и пользовательские настройки.

Пример базовой конфигурации

Создайте конфиг с такой структурой:

{
  "$schema": "https://opencode.ai/config.json",

  "theme": "opencode",

  "model": "anthropic/claude-sonnet-4-5",

  "small_model": "anthropic/claude-haiku-4-5",

  "autoupdate": true
}

Настройка провайдеров

Конфигурируйте API-ключи напрямую в конфиге:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}"
      }
    },
    "openai": {
      "options": {
        "apiKey": "{env:OPENAI_API_KEY}"
      }
    }
  }
}

Рекомендуется использовать переменные окружения для безопасности. Синтаксис: {env:ИМЯ_ПЕРЕМЕННОЙ}.

Использование ссылок на файлы

Можно указывать файлы с чувствительными данными:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "apiKey": "{file:~/.secrets/openai-key}"
      }
    }
  }
}

Кастомные команды

Определяйте повторяющиеся задачи через пользовательские команды:

{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    "test": {
      "template": "Run full test suite with coverage report and show any failures.\nFocus on failing tests and suggest fixes.",
      "description": "Run tests with coverage",
      "agent": "build",
      "model": "anthropic/claude-haiku-4-5"
    },
    "component": {
      "template": "Create a new React component named $ARGUMENTS with TypeScript support.\nInclude proper typing and basic structure.",
      "description": "Create a new component"
    }
  }
}

Используйте их в TUI, вводя /test или /component MyComponent.

Кастомные агенты

Создавайте специализированных агентов:

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "model": "anthropic/claude-sonnet-4-5",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Настройка прав доступа

Контролируйте, что OpenCode может делать без запроса:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

Потребуется подтверждение пользователя для операций редактирования и выполнения bash.

Форматтеры кода

Настройте автоматическое форматирование кода:

{
  "$schema": "https://opencode.ai/config.json",
  "formatter": {
    "prettier": {
      "disabled": false
    },
    "custom-prettier": {
      "command": ["npx", "prettier", "--write", "$FILE"],
      "environment": {
        "NODE_ENV": "development"
      },
      "extensions": [".js", ".ts", ".jsx", ".tsx"]
    }
  }
}

Настройки TUI

Настройте интерфейс терминала:

{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
": 3,
    "scroll_acceleration": {
      "enabled": true    "scroll_speed
    }
  }
}

8. Продвинутые возможности

Совместное использование разговоров

Делитесь диалогами с командой:

/share

Создаёт ссылку для общего доступа и копирует её в буфер обмена. Разговоры по умолчанию не публикуются.

Настройка поведения шаринга:

{
  "share": "manual"
}

Значение может быть manual, auto или disabled.

MCP-серверы

Протокол Model Context Protocol (MCP) расширяет возможности OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/files"]
    }
  }
}

Инструкции и правила

Задавайте проектно-специфичные инструкции:

{
  "$schema": "https://opencode.ai/config.json",
  "instructions": [
    "CONTRIBUTING.md",
    "docs/guidelines.md",
    ".cursor/rules/*.md"
  ]
}

OpenCode будет использовать эти файлы для понимания стандартов и соглашений по проекту.

Переменные окружения

Настраивайте OpenCode через переменные окружения:

# Автоматически делиться сессиями
export OPENCODE_AUTO_SHARE=true

# Путь к конфигу
export OPENCODE_CONFIG=/path/to/config.json

# Путь к директории конфигов
export OPENCODE_CONFIG_DIR=/path/to/config-dir

# Отключить автообновление
export OPENCODE_DISABLE_AUTOUPDATE=true

# Отключить стандартные плагины
export OPENCODE_DISABLE_DEFAULT_PLUGINS=true

# Включить экспериментальные модели
export OPENCODE_ENABLE_EXPERIMENTAL_MODELS=true

# Включить веб-поиск Exa
export OPENCODE_ENABLE_EXA=true

Экспериментальные функции

Включить экспериментальные функции:

export OPENCODE_EXPERIMENTAL=true

Конкретные экспериментальные возможности:

# Включить обнаружение иконок
export OPENCODE_EXPERIMENTAL_ICON_DISCOVERY=true

# Отключить копирование по выделению в TUI
export OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT=true

# Максимальная длина вывода для bash-команд
export OPENCODE_EXPERIMENTAL_BASH_MAX_OUTPUT_LENGTH=10000

# Таймаут по умолчанию для bash-команд (мс)
export OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS=30000

9. Лучшие практики

Эффективное составление запросов (prompt)

Работа с большими проектами

Оптимизация затрат

Рекомендации по безопасности

10. Устранение неполадок

Проблемы с установкой

Проблема: Команда не найдена после установки Решение:

Проблемы с аутентификацией

Проблема: API-ключ не распознаётся Решение:

Проблемы с производительностью

Проблема: Медленные отклики Решение:

Проблемы с TUI

Проблема: Ошибки отображения в терминале Решение:

Проблемы с моделями

Проблема: Модель не найдена Решение:

11. Встраивание OpenCode в ваш рабочий процесс

Ежедневная разработка

Совместная работа в команде

Интеграция CI/CD

12. Заключение

OpenCode представляет новый подход к разработке с помощью AI, предоставляя мощные AI-возможности прямо в вашем терминале. Благодаря гибкой настройке, поддержке множества LLM провайдеров и интуитивному интерфейсу TUI он создан для повышения вашей продуктивности без нарушения привычного процесса работы.

Основные выводы: Дальнейшие шаги: Готовы прокачать ваш процесс разработки?

Установка OpenCode на сервер улучшает процесс разработки, поэтому мы рекомендуем использовать надёжный VPS-хостинг для развёртывания AI-приложений на выделенных GPU инстансах с масштабируемой инфраструктурой.

Дата: 8 февраля 2026

Дата: 8 февраля 2026