Основные выводы

• Несколько путей установки: npm, Homebrew, curl script, Go install, Docker и сборка из исходного кода — выбирайте тот, который подходит для вашего инструментария.
• Пять минут до первого запуска: Самый быстрый путь (скрипт установки curl) позволяет запустить OpenCode менее чем за пять минут на любой системе Unix.
• Независимость от провайдера: OpenCode работает с OpenAI, Google Gemini, локальными моделями Ollama и другими — вы не привязаны к одному провайдеру AI.
• Минимальная конфигурация: Один файл config.toml и одна переменная окружения — это все, что вам нужно, чтобы начать писать код с помощью AI в вашем терминале.

Как установить OpenCode: пошаговое руководство по настройке (2026)

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

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

---

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

Перед установкой OpenCode убедитесь, что ваша система соответствует следующим требованиям.

Операционная система

OpenCode работает на macOS, Linux и Windows. Для пользователей Windows настоятельно рекомендуется WSL (Windows Subsystem for Linux). Также доступна нативная поддержка Windows через Scoop.

Требования к среде выполнения (зависят от метода установки)

Способ установки	Требование
npm	Node.js 18 или выше
Homebrew	macOS или Linux с установленным Homebrew
Curl script	bash, curl
Go install	Go 1.22 или выше
Docker	Docker Engine 20+
Сборка из исходного кода	Go 1.22+, Git

Требования к терминалу

OpenCode предоставляет TUI (Terminal User Interface), поэтому ваш эмулятор терминала должен поддерживать true color и корректный рендеринг Unicode. Большинство современных терминалов (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) работают из коробки. Старые терминалы, такие как стандартный Terminal.app в macOS, могут иметь проблемы с рендерингом.

Проверьте вашу версию Node.js:

node --version

Проверьте вашу версию Go (если используете метод Go install):

go version

---

Способ 1: Скрипт установки (самый быстрый)

Официальный скрипт установки — это самый быстрый способ запустить OpenCode. Он определяет вашу ОС и архитектуру, загружает нужный бинарный файл и помещает его в ваш PATH.

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

эта единственная команда берет все на себя. После завершения проверьте установку:

opencode --version

Этот метод работает на macOS и Linux. Он не требует Node.js или Go.

---

Способ 2: Установка через npm

Если в вашем рабочем процессе уже есть Node.js, npm — самый привычный вариант.

npm install -g opencode-ai@latest

Название пакета в npm — opencode-ai, а не opencode. Это частая причина путаницы.

Для проверки:

opencode --version

Если вы столкнулись с ошибками прав доступа, либо исправьте права доступа к вашей глобальной директории npm, либо используйте npx для запуска без глобальной установки:

npx opencode-ai@latest

---

Способ 3: Homebrew (macOS и Linux)

Пользователи Homebrew могут установить OpenCode из официального tap:

brew install anomalyco/tap/opencode

Это установит последний стабильный релиз и обеспечит обновления через brew upgrade.

Для проверки:

opencode --version

---

Способ 4: Установка через Go

Если у вас установлен Go 1.22+, вы можете установить программу напрямую из исходного кода через go install:

go install github.com/opencode-ai/opencode@latest

Убедитесь, что $GOPATH/bin (или $HOME/go/bin по умолчанию) находится в вашем PATH. Добавьте его в профиль вашей оболочки, если это еще не сделано:

export PATH="$PATH:$(go env GOPATH)/bin"

Проверьте:

opencode --version

---

Способ 5: Docker

Запуск OpenCode в Docker полезен для CI/CD конвейеров или когда вам нужна изолированная среда.

docker pull ghcr.io/opencode-ai/opencode:latest

Запустите его с примонтированной директорией вашего проекта:

docker run -it --rm \
  -v "$(pwd)":/workspace \
  -w /workspace \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  ghcr.io/opencode-ai/opencode:latest

Флаги -it обязательны, так как OpenCode использует интерактивный TUI. Флаг -v монтирует текущую директорию проекта, чтобы OpenCode мог читать и изменять ваши файлы.

---

Способ 6: Сборка из исходного кода

Для контрибьюторов или тех, кто хочет использовать самую свежую версию:

git clone https://github.com/opencode-ai/opencode.git
cd opencode
go build -o opencode .

Переместите бинарный файл в директорию, которая находится в вашем PATH:

sudo mv opencode /usr/local/bin/

Сборка из исходного кода требует Go 1.22+ и Git. Это дает вам доступ к невыпущенным функциям и позволяет модифицировать инструмент под собственные нужды.

---

Способ 7: Scoop (Windows)

Пользователи Windows, которые предпочитают нативный опыт вместо WSL, могут использовать Scoop:

scoop install opencode

Scoop автоматически настраивает PATH.

---

Первый запуск и конфигурация

Установив OpenCode, перейдите в любую директорию проекта и запустите его:

cd your-project
opencode

При первом запуске OpenCode открывает TUI и предлагает подключить AI провайдера. Вы можете использовать интерактивную команду /connect, чтобы добавить свой API key:

/connect

Это проведет вас через выбор провайдера (OpenAI, Google, Anthropic и т. д.) и ввод вашего API key. Учетные данные хранятся в ~/.local/share/opencode/auth.json.

Для более быстрого старта вы также можете инициализировать свой проект с помощью:

/init

Это проанализирует структуру вашего репозитория и создаст файл agents.md с контекстом вашей кодовой базы, что поможет AI давать более точные ответы с самого начала.

---

Настройка провайдеров AI

OpenCode поддерживает несколько AI провайдеров. Вот как настроить каждого из них.

OpenAI (GPT-5.4, GPT-4.1, o3)

Установите API key как переменную окружения:

export OPENAI_API_KEY="sk-your-key-here"

Или добавьте ее в профиль вашей оболочки (~/.zshrc, ~/.bashrc) для постоянного хранения.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

export GOOGLE_API_KEY="your-google-api-key"

Вы можете получить Google API key в Google AI Studio.

Ollama (Локальные модели — бесплатно, конфиденциально)

Ollama позволяет запускать модели локально без какого-либо API key. Сначала установите Ollama, скачайте модель, затем настройте OpenCode:

# Установите Ollama (если еще не установлено)
curl -fsSL https://ollama.com/install.sh | sh

# Скачайте модель для кодинга
ollama pull qwen2.5-coder:32b

# OpenCode автоматически обнаруживает Ollama при запуске на localhost:11434

Для Ollama не требуется API key. OpenCode автоматически обнаруживает его при локальном запуске.

Anthropic (Claude — ограниченный доступ)

Anthropic ограничила доступ к Claude в сторонних инструментах, включая OpenCode. Если у вас есть API key, который все еще работает:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

Тем не менее, большинство пользователей в 2026 году используют OpenAI или Gemini в качестве основного провайдера в OpenCode из-за этих ограничений.

---

Важная конфигурация: обзор config.toml

OpenCode использует конфигурационный файл TOML для детального контроля. Конфигурационный файл находится по адресу ~/.config/opencode/config.toml (или в корне вашего проекта как opencode.json для настроек конкретного проекта).

Вот практический пример config.toml:

# Provider configuration
[provider.openai]
apiKey = "{env:OPENAI_API_KEY}"

[provider.openai.models.gpt]
id = "gpt-5.4"

[provider.google]
apiKey = "{env:GOOGLE_API_KEY}"

[provider.google.models.gemini]
id = "gemini-2.5-pro"

# Disable providers you do not use
disabled_providers = ["anthropic"]

Основные моменты:

• Подстановка переменных: Используйте {env:VARIABLE_NAME} для ссылки на переменные окружения вместо жесткого прописывания ключей.
• Выбор модели: Вы можете точно указать, какую модель использовать для каждого провайдера.
• Отключенные провайдеры: Запретите OpenCode загружать провайдеров, для которых у вас нет учетных данных, чтобы избежать предупреждений при запуске.
• Переопределение Base URL: Если вы используете прокси или кастомную конечную точку, добавьте baseURL = "https://your-proxy.com/v1" в раздел провайдера.

Для конфигурации на уровне проекта создайте opencode.json в корне вашего проекта:

{
  "provider": "openai",
  "model": "gpt-5.4"
}

Это переопределяет глобальные настройки для этого конкретного проекта.

---

Проверка установки

Пройдите по этому чек-листу, чтобы подтвердить, что все работает правильно.

1. Проверьте версию

opencode --version

Вы должны увидеть номер версии. По состоянию на март 2026 года последняя стабильная версия находится в диапазоне 0.x.

2. Запустите TUI

cd any-project-directory
opencode

Вы должны увидеть терминальный интерфейс OpenCode с командной строкой внизу.

3. Протестируйте простой запрос

В TUI OpenCode введите простой запрос:

Explain what this project does based on the file structure.

Если вы получили ответ от AI, конфигурация вашего провайдера работает.

4. Протестируйте операции с файлами

Попросите OpenCode создать небольшой тестовый файл:

Create a file called test-opencode.txt with the text "OpenCode is working"

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

---

Устранение распространенных проблем

"command not found: opencode"

Бинарный файл отсутствует в вашем PATH. Решение зависит от метода установки:

• npm: Запустите npm list -g opencode-ai, чтобы подтвердить установку. Если пакет установлен, проверьте, что глобальная директория bin от npm находится в вашем PATH: выполните npm config get prefix и добавьте /bin к этому пути.
• Go: Добавьте $(go env GOPATH)/bin в ваш PATH.
• Curl script: Повторно запустите скрипт установки или вручную переместите бинарный файл в /usr/local/bin/.

Ошибки прав доступа при установке через npm

Не используйте sudo npm install -g. Вместо этого исправьте директорию npm по умолчанию:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g opencode-ai@latest

"Error: Node.js version too old"

npm-пакет OpenCode требует Node.js 18+. Проверьте вашу версию:

node --version

Если у вас старая версия, обновитесь с помощью nvm:

nvm install 18
nvm use 18

Сетевые ошибки за корпоративным файрволом

Если установка npm зависает или завершается ошибкой из-за сетевых ограничений:

npm install -g opencode-ai@latest --registry https://registry.npmmirror.com

Или скачайте бинарный файл напрямую со страницы релизов GitHub и поместите его в свой PATH вручную.

"API key not found" или "No provider configured"

Убедитесь, что переменная окружения вашего API key экспортирована в той же сессии оболочки:

echo $OPENAI_API_KEY

Если ничего не выводится, установите ее снова:

export OPENAI_API_KEY="sk-your-key-here"

Для постоянного сохранения добавьте строку экспорта в ваш ~/.zshrc или ~/.bashrc и выполните source ~/.zshrc.

Проблемы с рендерингом TUI (искаженный текст, отсутствие рамок)

Переключитесь на современный эмулятор терминала, поддерживающий true color. Рекомендуемые варианты: iTerm2 (macOS), Alacritty (кроссплатформенный), WezTerm (кроссплатформенный) или Windows Terminal (Windows).

Go install: "go: command not found"

Go не установлен или отсутствует в вашем PATH. Установите Go с go.dev/dl и убедитесь, что он есть в вашем PATH:

export PATH="$PATH:/usr/local/go/bin"

---

Обновление OpenCode

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

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Curl script: Повторно запустите команду установки:

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

Go install: Повторно запустите с @latest:

go install github.com/opencode-ai/opencode@latest

---

Следующие шаги

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

• Изучите команды: Ознакомьтесь с нашим OpenCode Tutorial 2026 для полного обзора команд, рабочих процессов и расширенных функций.
• Настройте интеграцию с GitHub: Установите OpenCode GitHub App, чтобы использовать AI для код-ревью и ответов на issues непосредственно в ваших репозиториях.
• Изучите команду /init: Запустите /init в своем проекте, чтобы сгенерировать файл agents.md, который даст OpenCode глубокий контекст архитектуры вашей кодовой базы.
• Попробуйте несколько провайдеров: Настройте двух или трех провайдеров и переключайтесь между ними, чтобы найти, какая модель лучше всего подходит для ваших задач по программированию.

OpenCode — один из самых быстрорастущих AI-инструментов с открытым исходным кодом в 2026 году, потому что он встречает разработчиков там, где они уже работают: в терминале. Поскольку установка занимает менее пяти минут, а настройка требует всего один API key, нет причин не попробовать его сегодня.