Как установить и использовать OpenCode: CLI, TUI, API-ключ, первая задача в репозитории

Установить OpenCode CLI/TUI, подключить ключ, затем первую задачу в настоящем репозитории.

Нужен открытый агент в терминале, который читает репозиторий и правит файлы — без ещё одного чата в браузере.

Этот разбор — как установить и использовать OpenCode: поставить CLI/TUI, войти или вставить API-ключ через /connect или opencode auth login, затем первую задачу в настоящем репозитории. Шаги по Intro, Providers и CLI на opencode.ai/docs.

Кому это подходит

OpenCode — открытый терминальный агент: opencode без аргументов запускает TUI, CLI тоже есть. Десктоп и IDE описаны в документации; эта статья только про терминал. Для первого запуска нужен современный эмулятор и один рабочий ключ модели.

Установка, вход, первая задача

1. 1

   Установить CLI и открыть TUI

   На macOS/Linux/WSL: curl -fsSL https://opencode.ai/install | bash, npm install -g opencode-ai или brew install anomalyco/tap/opencode (tap anomalyco — более свежая формула в документации). Нативный Windows: Chocolatey, Scoop или npm; полная совместимость — WSL. Проверка: opencode --version, запуск: opencode.

2. 2

   Войти или добавить API-ключ

   В TUI введите /connect. Новички могут выбрать OpenCode Zen, войти на opencode.ai/auth, указать оплату и вставить ключ — или OpenAI, Anthropic, другого провайдера. CLI: opencode auth login. Проверка: opencode auth list. Также окружение или проектный .env.

3. 3

   Первая задача в репозитории

   cd в проект, opencode, затем /init для AGENTS.md. Первый запрос: «Опиши структуру тремя пунктами и предложи один маленький тест». Маленькая правка: однострочный комментарий, то же поведение. Читайте diff. /undo можно. Скрипты: opencode run.

curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai
# or: brew install anomalyco/tap/opencode

opencode --version

# Auth (pick one):
# In the TUI:  /connect   → provider or OpenCode Zen → paste API key
# CLI:         opencode auth login
# Check:       opencode auth list
# Keys live in ~/.local/share/opencode/auth.json  (do not commit)

cd /path/to/your/repo
opencode
# In the TUI:  /init     → writes AGENTS.md (ok to commit)
# First task:  Explain the repo layout in three bullets and name one small test I can add
# Small edit:  Add a one-line comment to the main entry file; do not change behavior
# Undo:        /undo

# Non-interactive alternative:
# opencode run "Explain README.md in three bullets and suggest one small test"

Что обычно ломает первый запуск

Сломанный TUI или мёртвые ярлыки

Документация просит современный эмулятор: WezTerm, Alacritty, Ghostty, Kitty. Плохой системный терминал — сначала смените его.

auth.json как записная книжка паролей

Путь по умолчанию: ~/.local/share/opencode/auth.json. Не копируйте в публичный репозиторий. Ключ уже в Git — смените в консоли поставщика.

Windows неполный

Официально для полной совместимости — WSL. Chocolatey / Scoop / npm ставят нативный бинарник. Читайте раздел Windows.

Официальное напоминание: API по тарифам поставщика или Zen. Выучите /init и /undo на дешёвой модели, затем переключитесь на ту, за которую хотите платить.

Когда diff нужно обсудить

Часто не хватает одной схемы. Короткое пространство на tidemeet или как создать пространство. Холст: общая доска. Другие гайды: Aider, Codex CLI.

Вопросы