OpenCode — это открытый агент для программирования, который живёт прямо в терминале. Он умеет читать файлы проекта, править код, запускать команды и тесты, искать по репозиторию и работать с git — примерно то же, что делают Claude Code и другие консольные агенты. Главное отличие в том, что OpenCode не привязан к одному поставщику моделей: через него можно подключить десятки провайдеров, в том числе DeepSeek. В этой заметке я опишу установку агента и подключение к нему DeepSeek.
Что понадобится
Для работы нужны всего две вещи:
- Современный терминал. Подойдёт WezTerm, Alacritty, Ghostty, Kitty или любой другой.
- API-ключ провайдера. В нашем случае — DeepSeek.
Node.js не обязателен, если ставить агент штатным установочным скриптом, — binary приезжает готовым.
Установка
Самый простой способ — официальный установочный скрипт:
curl -fsSL https://opencode.ai/install | bash
Он сам определит платформу и положит исполняемый файл в PATH. После установки стоит проверить, что всё на месте:
opencode --version
Если команда отображает версию, установка прошла успешно.
Установка другими способами
Если вы предпочитаете пакетные менеджеры, вариантов несколько. Через Node.js:
npm install -g opencode-ai
То же самое умеют Bun, pnpm и Yarn:
bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai
В macOS и Linux есть Homebrew. Обратите внимание: рекомендуют именно tap от разработчиков, а не официальную формулу — она обновляется реже:
brew install anomalyco/tap/opencode
В Arch Linux:
sudo pacman -S opencode
paru -S opencode-bin
Первая команда ставит стабильную версию из репозитория, вторая — свежую из AUR.
Установка в Windows
В Windows рекомендуют работать через WSL: так и производительность выше, и совместимость с возможностями агента полная. Но есть и нативные способы. Через Chocolatey, Scoop или npm:
choco install opencode
scoop install opencode
npm install -g opencode-ai
Есть и вариант через Mise, а также контейнер Docker:
mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode
Наконец, готовый бинарник всегда можно взять со страницы релизов на GitHub.
Ключ DeepSeek
Ключ создаётся в личном кабинете DeepSeek. Заходим на platform.deepseek.com, открываем раздел с API-ключами и нажимаем создание нового ключа. Полученную строку лучше сразу сохранить: показана она будет только один раз.
Подключение DeepSeek
Дальше всё делается внутри самого агента. Запускаем OpenCode в терминале:
opencode
В интерфейсе выполняем команду подключения:
/connect
В открывшемся списке провайдеров ищем DeepSeek, выбираем его и вставляем API-ключ. Ключи, добавленные таким образом, сохраняются в файл:
~/.local/share/opencode/auth.json
После подключения остаётся выбрать модель командой:
/models
В списке будут доступны модели DeepSeek, в том числе deepseek-v4-pro, deepseek-flash и deepseek-v4-flash. Для рутинной работы в репозитории вполне хватает flash-варианта; на сложные задачи имеет смысл переключаться на pro.
Настройка через конфиг
Если не хочется хранить ключ через мастер или нужно задать свой адрес API, провайдер описывается прямо в конфигурационном файле opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"deepseek": {
"options": {
"baseURL": "https://api.deepseek.com"
}
}
}
}
Поле baseURL пригодится, если вы ходите через прокси или собственный шлюз. Сам ключ в этом случае удобно передать переменной окружения:
export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode
Такой вариант хорош для CI и одноразовых запусков: ключ не оседает в хранилище, а живёт только в окружении процесса.
Первый запуск в проекте
Переходим в каталог проекта и запускаем агента:
cd ваш_проект
opencode
Первым делом полезно инициализировать его:
/init
OpenCode проанализирует структуру проекта и создаст файл AGENTS.md — аналог инструкций для агента. Этот файл стоит закоммитить в git: он помогает агенту понимать принятые в проекте соглашения и паттерны.
Как этим пользоваться
Работа строится примерно так же, как с другими агентами. Пара приёмов, которые стоит знать сразу:
- Режим планирования. Клавиша Tab переключает агента между режимами планирования и сборки. В первом он только предлагает, как решить задачу, и ничего не меняет, — удобно проверить замысел до правок.
- Ссылки на файлы. Клавиша @ открывает нечёткий поиск по файлам проекта, чтобы передать агенту конкретный файл в контекст.
- Откат изменений. Команда /undo отменяет последние правки и возвращает исходный запрос, /redo — возвращает их обратно. Откатывать можно несколько шагов подряд.
- Обмен диалогом. Команда /share создаёт ссылку на текущую беседу и копирует её в буфер обмена. По умолчанию диалоги никуда не публикуются.
Для простых изменений можно и не переходить в режим планирования, а сразу описать, что нужно сделать, и указать файлы через @.
На что обратить внимание
Пара практических моментов. OpenCode не требует подписки: вы платите провайдеру напрямую по факту расхода токенов, поэтому длинные сессии с DeepSeek предсказуемо дешевле топовых моделей. Ключ хранится локально в auth.json — это стоит учитывать на общей машине, а для чужих окружений надёжнее переменная окружения.
И ещё: качество ответа на сложных архитектурных задачах у моделей разных классов отличается, поэтому для проектирования имеет смысл брать модель посильнее, а рутину отдавать быстрой и дешёвой.
Ссылки
https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com
Источники
https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/
Добавить комментарий