Введение

Начните работу с OpenCode.

OpenCode — это AI-агент для программирования с открытым исходным кодом. Он доступен как терминальный интерфейс, десктопное приложение или расширение для IDE.

Давайте начнём.

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

Для использования OpenCode в терминале вам понадобятся:

• Современный эмулятор терминала, например:
  • WezTerm (opens in a new tab), кроссплатформенный
  • Alacritty (opens in a new tab), кроссплатформенный
  • Ghostty (opens in a new tab), Linux и macOS
  • Kitty (opens in a new tab), Linux и macOS
• API-ключи для LLM-провайдеров, которые вы хотите использовать.

Установка

Самый простой способ установить OpenCode — через скрипт установки.

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

Вы также можете установить его следующими командами:

• Используя Node.js

npm install -g opencode-ai

• Используя Homebrew на macOS и Linux

brew install anomalyco/tap/opencode

Мы рекомендуем использовать tap OpenCode для получения самых актуальных версий. Официальная формула brew install opencode поддерживается командой Homebrew и обновляется реже.

• Используя Paru на Arch Linux

paru -S opencode-bin

Windows

• Используя Chocolatey

choco install opencode

• Используя Scoop

scoop install opencode

• Используя NPM

npm install -g opencode-ai

• Используя Mise

mise use -g github:anomalyco/opencode

• Используя Docker

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

Поддержка установки OpenCode в Windows с помощью Bun находится в разработке.

Вы также можете скачать бинарный файл из Releases (opens in a new tab).

Настройка

С OpenCode вы можете использовать любого LLM-провайдера, настроив их API-ключи.

Если вы новичок в использовании LLM-провайдеров, мы рекомендуем использовать OpenCode Zen. Это курируемый список моделей, которые были протестированы и проверены командой OpenCode.

1. Выполните команду /connect в TUI, выберите opencode и перейдите на opencode.ai/auth (opens in a new tab).

/connect

2. Войдите в систему, добавьте платёжные данные и скопируйте ваш API-ключ.

3. Вставьте ваш API-ключ.

┌ API key
│
│
└ enter

Альтернативно вы можете выбрать одного из других провайдеров. Узнать больше.

Инициализация

Теперь, когда вы настроили провайдера, вы можете перейти к проекту, над которым хотите работать.

cd /path/to/project

И запустите OpenCode.

opencode

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

/init

Это заставит OpenCode проанализировать ваш проект и создать файл AGENTS.md в корне проекта.

Это помогает OpenCode понять структуру проекта и используемые паттерны кодирования.

Использование

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

Если вы новичок в использовании AI-агента для программирования, вот несколько примеров, которые могут помочь.

Задавайте вопросы

Вы можете попросить OpenCode объяснить вам кодовую базу.

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

Это полезно, если есть часть кодовой базы, над которой вы не работали.

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

Вы можете попросить OpenCode добавить новые функции в ваш проект. Однако сначала мы рекомендуем попросить его создать план.

1. Создайте план

   OpenCode имеет режим Plan, который отключает его способность вносить изменения и вместо этого предлагает, как он реализует функцию.

   Переключитесь на него с помощью клавиши Tab. Вы увидите индикатор этого в правом нижнем углу.

   <TAB>

   Теперь давайте опишем, что мы хотим, чтобы он сделал.

   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.

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

   Совет

   Дайте OpenCode достаточно контекста и примеров, чтобы помочь ему понять, что вы хотите.

2. Итерируйте план

   Как только он даст вам план, вы можете дать обратную связь или добавить больше деталей.

   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 может сканировать любые изображения, которые вы ему даёте, и добавлять их в промпт. Вы можете сделать это, перетащив изображение в терминал.

3. Создайте функцию

   Когда вы будете довольны планом, переключитесь обратно в режим Build, нажав клавишу Tab снова.

   <TAB>

   И попросите его внести изменения.

   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

Убедитесь, что вы предоставляете достаточно деталей, чтобы OpenCode внёс правильные изменения.

Отменяйте изменения

Допустим, вы попросили OpenCode внести некоторые изменения.

Can you refactor the function in @packages/functions/src/api/index.ts?

Но вы понимаете, что это не то, что вы хотели. Вы можете отменить изменения с помощью команды /undo.

/undo

OpenCode теперь отменит сделанные изменения и снова покажет ваше исходное сообщение.

Can you refactor the function in @packages/functions/src/api/index.ts?

Отсюда вы можете изменить промпт и попросить OpenCode попробовать снова.

Или вы можете повторить изменения с помощью команды /redo.

/redo

Поделиться

Разговоры, которые вы ведёте с OpenCode, можно поделиться с вашей командой.

/share

Это создаст ссылку на текущий разговор и скопирует её в буфер обмена.

Вот пример разговора (opens in a new tab) с OpenCode.

Настройка под себя

Вот и всё! Теперь вы профессионал в использовании OpenCode.

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