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

Модуль 1

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

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

25 мин

Содержание модуля
  1. Установка через npm
  2. Бесплатная модель
  3. Учебный проект orders-api
  4. Агент внутри проекта

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

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

Пререквизиты

  2. Node.js
    node -v
  3. Установка git
    git --version

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

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

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

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

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

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. Несколько дефектов оставлены в коде специально: на них построены задания следующих модулей, поэтому курс проходится именно на этом архиве.

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 после запуска TUI.

@-ссылка кладёт файл прямо в контекст сообщения: @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
  2. Фоновый сервер
    opencode service start
  4. cd C:/projects/orders-api
  5. git init && git add -A && git commit -m "baseline"
  6. npm install
  7. npm run dev
# второй таб:
curl http://localhost:3000/health
  8. Запуск
    opencode
  9. Провайдеры
    /connect
/models
  10. AGENTS.md и /init
    /init
  11. @README.md @src/index.ts Что делает этот проект? Перечисли эндпоинты.

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

Проверь себя

Вопрос 1 из 5

Прогресс квиза
Ты работаешь в WSL. Как поставить OpenCode для этого курса?

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

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

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

Модель

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

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

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

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