Перейти к содержимому
Прогресс курса
0 из 8 модулей

Модуль 1

Установка и первый диалог

Установишь OpenCode через npm, подключишь бесплатную модель, запустишь учебный orders-api и получишь первый ответ агента о коде проекта.

20 мин

Чему научишься

  • установить OpenCode на Windows через npm и проверить фоновый сервер
  • подключить бесплатную модель провайдера OpenCode и выбрать её в /models
  • запустить учебный сервис orders-api и проверить его curl'ом
  • получить ответ агента на вопрос о коде с @-ссылками на файлы

Установка через npm

Курс идёт на нативном Windows в Windows Terminal. Проверь Node.js командой node -v: нужна версия 18.20 или новее, при отсутствии поставь LTS-сборку с nodejs.org. Windows Terminal работает; в списке рекомендованных у OpenCode также Ghostty, WezTerm, Alacritty и Kitty.

Установка сводится к глобальному npm-пакету. Пакетные менеджеры Windows (choco, scoop, winget) в v2 не поддерживаются, curl-скрипт и brew рассчитаны на Linux и macOS.

OpenCode v2 устроен клиент-серверно. При первом запуске поднимается общий фоновый сервер на пользователя: он хранит сессии, конфигурацию и инструменты, а каждое окно терминала работает клиентом. Статус сервера показывает opencode service status; флаг --standalone поднимает приватный сервер на один запуск.

bashУстановка OpenCode v2
npm install -g @opencode/cli
После установки команда opencode появится в PATH.

Бесплатная модель

OpenCode работает с 75+ провайдерами и локальными моделями. Подключение выполняется в TUI командой /connect: методы API key, OAuth, Command и Environment. Путь курса простой: выбери провайдера OpenCode и его бесплатные модели. На октябрь 2026 среди Free-моделей LongCat, MiniMax M3.1 Flash Free, Beam и MiMo.

Конкретную модель выбирает /models (Ctrl+X M, недавние по F2). Идентификатор имеет формат provider/model, например openai/gpt-5.2#high, где суффикс после # задаёт уровень reasoning. Модель по умолчанию фиксируется в конфиге проекта, займёшься этим в модуле 3.

bashПровайдеры и модели v2
/connect
/models
Состав бесплатных моделей меняется: актуальный список смотри в /models и в доке провайдера.

Учебный проект orders-api

orders-api это REST-сервис заказов кофейни: Express + TypeScript, база в JSON-файле data/db.json, порт 3000, без Docker. В коде посажены дефекты для следующих модулей, поэтому проходи курс именно на нём.

Скачай orders-api.zip со страницы этого модуля и распакуй, например, в C:\projects\orders-api.

bash
cd C:\projects\orders-api
npm install
npm run dev
# сервер занял этот таб; проверь его во втором:
curl http://localhost:3000/health
curl ответит {"ok":true}. curl встроен в Windows 10+; если PowerShell подставляет Invoke-WebRequest, вызывай curl.exe. Сервер не останавливай: в модуле 2 агент будет проверять правки запросами к API.

Агент внутри проекта

Открой второй таб Windows Terminal в папке проекта и запусти там opencode: текущий каталог станет рабочей областью агента. Ввод: Enter отправляет сообщение, Shift+Enter или Ctrl+Enter переносят строку, Ctrl+P открывает палитру команд.

Первая полезная команда это /init: OpenCode сканирует репозиторий и предлагает AGENTS.md, файл инструкций проекта. Для orders-api черновик получится с командами npm run dev, npm test, npm run typecheck, структурой routes/services/db и списком статусов заказа. Сохрани файл, в модуле 3 доведёшь его до рабочего состояния.

bashЗапуск opencode v2
# второй таб терминала, в папке проекта
opencode
# затем в TUI:
/init
Команды вида /init вводятся в строке ввода OpenCode, а не в shell.

@-ссылка кладёт файл прямо в контекст сообщения: @README.md @src/index.ts Что делает этот проект?. Диапазон строк задаётся после решётки: @src/routes/orders.ts#23-44 отправит только обработчик POST. Задай агенту первый вопрос.

Первый вопрос: что это за проект

@README.md @src/index.ts Что делает этот проект? Перечисли эндпоинты.

Прочитал README.md и src/index.ts. Это REST-сервис заказов кофейни: Express + TypeScript, порт 3000, данные в JSON-файле data/db.json. В src/index.ts монтируются четыре роутера: /api/menu, /api/orders, /api/stats и /api/v1/report. В README упомянуты только два эндпоинта, файл отстал от кода.

Какие параметры принимает POST /api/orders?

Посмотрел src/routes/orders.ts. Обязательные поля: customer (строка) и items (непустой массив с menuId и quantity). Успешный ответ это 201 с созданным заказом: id вида ord-001, статус new, total считается в src/services/pricing.ts. Могу разобрать расчёт total построчно.

Сделай сам

  1. npm install -g @opencode/cli
    Установка
  3. cd C:\projects\orders-api
  4. npm install
  5. npm run dev
# второй таб:
curl http://localhost:3000/health
  6. opencode
    Запуск
  7. /connect
/models
    Провайдеры
  8. /init
    AGENTS.md и /init
  9. @README.md @src/index.ts Что делает этот проект? Перечисли эндпоинты.

Отмечено 0 из 9

Проверь себя

Вопрос 1 из 5

Какой способ установки OpenCode v2 на Windows не сработает?

Шпаргалка модуля

Установка и запуск

npm install -g @opencode/cli
установка OpenCode глобально на Windows
opencode
запуск агента в текущем каталоге проекта
opencode service status
статус общего фонового сервера

Модель

/connect
подключение провайдера: API key, OAuth, Command, Environment
/models
выбор модели; Ctrl+X M, недавние по F2
provider/model
формат ID; reasoning задаётся через #, например #high

Первые шаги в проекте

/init
черновик AGENTS.md по кодовой базе
@файл
файл в контекст сообщения; @файл#20-45 диапазон строк
Ctrl+P
палитра команд TUI

Ссылки модуля