OpenCode - API易文档中心

Обзор

OpenCode — полностью open-source AI coding agent, созданный на TypeScript и AI SDK, с поддержкой терминального TUI, интеграции с IDE и настольных приложений. У проекта более 94,9 тыс.+ звезд на GitHub и активное сообщество. Настроив сервис APIYI, вы получите:

🖥️ Поддержка нескольких платформ

Терминальный TUI, расширение для VS Code и настольные приложения

🔌 Поддержка 75+ моделей

Поддерживает 75+ провайдеров LLM через Models.dev

🛠️ Встроенный LSP

Поддержка Language Server Protocol для интеллектуального понимания кода

🔄 Параллельная работа нескольких сессий

Параллельная обработка сессий и совместное использование сессий

Информация о проекте: OpenCode — активно поддерживаемый open-source проект. Веб-сайт: opencode.ai, репозиторий: github.com/anomalyco/opencode.

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

Установите OpenCode

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

npm i -g opencode-ai@latest

brew install anomalyco/tap/opencode

Scoop:

scoop install opencode

Chocolatey:

choco install opencode

paru -S opencode-bin

Скачайте настольное приложение для вашей системы с opencode.ai:

macOS (Apple Silicon / Intel)
Windows
Linux (AppImage / deb)

Проверьте установку:

opencode --version

Быстрая конфигурация

OpenCode использует JSON-файлы конфигурации с несколькими расположениями конфигурации (приоритет от низкого к высокому):

Удаленная конфигурация (.well-known/opencode)
Глобальная конфигурация: ~/.config/opencode/opencode.json
Пользовательская конфигурация: путь, указанный переменной окружения OPENCODE_CONFIG
Конфигурация проекта: opencode.json в корне проекта
Конфигурация каталога .opencode
Встроенная конфигурация: переменная окружения OPENCODE_CONFIG_CONTENT

Метод 1: Пользовательский провайдер (рекомендуется)

Создайте или отредактируйте файл конфигурации ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": { "context": 200000, "output": 8192 }
        },
        "gpt-4.1": {
          "name": "GPT-4.1",
          "limit": { "context": 1047576, "output": 32768 }
        },
        "deepseek-chat": {
          "name": "DeepSeek V3",
          "limit": { "context": 65536, "output": 8192 }
        },
        "gemini-2.5-pro-preview-05-06": {
          "name": "Gemini 2.5 Pro",
          "limit": { "context": 1048576, "output": 65536 }
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

Затем задайте переменную окружения:

macOS/Linux
Windows

# zsh
echo 'export APIYI_API_KEY="sk-your-apiyi-key"' >> ~/.zshrc
source ~/.zshrc

# bash
echo 'export APIYI_API_KEY="sk-your-apiyi-key"' >> ~/.bashrc
source ~/.bashrc

PowerShell:

[System.Environment]::SetEnvironmentVariable('APIYI_API_KEY', 'sk-your-apiyi-key', 'User')

Или добавьте APIYI_API_KEY в системные переменные окружения.

Метод 2: Аутентификация через команду /connect

OpenCode предоставляет команду /connect для быстрого подключения новых провайдеров:

После запуска OpenCode введите /connect
Выберите «Другое»
Введите ID провайдера (например, apiyi)
Введите API key

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

Метод 3: Переопределение существующего провайдера

Для быстрой настройки переопределите baseURL встроенного провайдера OpenAI:

{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      }
    }
  }
}

Метод 4: Конфигурация на уровне проекта

Создайте opencode.json в корне проекта для настроек, относящихся к проекту:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

Система агентов

В OpenCode есть три встроенных агента, каждый со своим назначением:

Агент	Описание	Использование
build	Агент по умолчанию с полным доступом, отвечает за генерацию и изменение кода	Прямое общение
plan	Агент только для чтения, предназначен для анализа кода и планирования, не изменяет файлы	Команда `/plan`
general	Подагент для сложного поиска и многошагового извлечения информации	Вызов `@general`

Конфигурация моделей агентов

Настройте разные модели для разных агентов:

{
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": { "context": 200000, "output": 8192 }
        },
        "deepseek-chat": {
          "name": "DeepSeek V3",
          "limit": { "context": 65536, "output": 8192 }
        },
        "gpt-4.1-mini": {
          "name": "GPT-4.1 Mini",
          "limit": { "context": 1047576, "output": 32768 }
        }
      }
    }
  },
  "agents": {
    "build": {
      "model": "apiyi/claude-sonnet-4-20250514"
    },
    "plan": {
      "model": "apiyi/deepseek-chat"
    },
    "general": {
      "model": "apiyi/gpt-4.1-mini"
    }
  }
}

Посмотреть рекомендации по моделям для программирования

Ознакомьтесь с последними рекомендациями по моделям для программирования, сравнениями производительности и советами по использованию. Включает модели высшего уровня, экономичные варианты и модели с улучшенным рассуждением.

Агент	Назначение	Рекомендуемая модель
build	Генерация и модификация кода	Claude Sonnet 4, GPT-4.1
plan	Планирование и анализ задач	DeepSeek V3, Gemini 2.5 Pro
general	Быстрый поиск и вопросы и ответы	GPT-4.1 Mini (низкая стоимость)

Основные возможности

Интерактивный терминальный интерфейс

Запустите OpenCode, чтобы перейти в интерактивный TUI:

# Start in current directory
opencode

# Specify project directory
opencode /path/to/project

Операции с файлами

OpenCode может читать, искать и изменять файлы проекта:

> View the contents of src/index.ts

> Search for all files containing "TODO" in the project

> Refactor the calculateSum function in utils.ts to a more efficient implementation

Выполнение команд

Выполняйте команды в терминале и просматривайте результаты:

> Run npm test and analyze the failed tests

> Execute npm install and check for dependency conflicts

Управление сеансами

Параллельное выполнение нескольких сеансов: Запускайте несколько сеансов одновременно
Совместное использование сеансов: Экспортируйте и делитесь сеансами
Автосохранение: Все сеансы автоматически сохраняются
Сохранение контекста: Сохраняйте полный контекст беседы во время сеансов

Советы по использованию

1. Сочетания клавиш

Сочетание	Функция
`Ctrl+C`	Прервать текущую операцию
`Ctrl+D`	Выйти из OpenCode
`Tab`	Автодополнение
`↑/↓`	Просматривать историю команд

2. Частые команды

Команда	Функция
`/connect`	Подключить нового провайдера
`/model`	Переключить текущую модель
`/plan`	Использовать плановый агент для анализа
`/clear`	Очистить текущую сессию
`/help`	Просмотреть справочную информацию

3. Вызов подагента

Используйте @general, чтобы вызвать поискового подагента для сложных запросов:

> @general Find all files handling user authentication in the codebase and summarize their functions

4. Инкрементальная разработка

{/* Step 1: Generate basic framework */}
> Create a basic REST API structure

{/* Step 2: Add specific features */}
> Add user authentication middleware

{/* Step 3: Refine details */}
> Add request parameter validation and error handling

Устранение неполадок

Не удается подключиться к APIYI

Проверьте, что переменная окружения задана правильно:

echo $APIYI_API_KEY  # macOS/Linux
echo %APIYI_API_KEY%  # Windows

Проверьте baseURL в файле конфигурации:

"baseURL": "https://api.apiyi.com/v1"

Проверьте подключение к API:

curl -H "Authorization: Bearer $APIYI_API_KEY" \
     https://api.apiyi.com/v1/models

Ошибка: модель не найдена

Убедитесь, что идентификатор модели указан правильно. Проверьте в консоли APIYI поддерживаемые модели.Часто используемые идентификаторы моделей:

claude-sonnet-4-20250514
gpt-4.1
deepseek-chat
gemini-2.5-pro-preview-05-06

Файл конфигурации не применяется

Приоритет загрузки файла конфигурации (от низкого к высокому):

Удаленная конфигурация (.well-known/opencode)
Глобальная конфигурация: ~/.config/opencode/opencode.json
Переменная окружения OPENCODE_CONFIG
Конфигурация проекта: opencode.json
Конфигурация каталога .opencode
Переменная окружения OPENCODE_CONFIG_CONTENT

Убедитесь, что файл конфигурации находится в правильном месте и имеет допустимый формат JSON.

Медленный ответ

Попробуйте использовать более легкую модель (например, GPT-4.1 Mini)
Уменьшите длину контекстного окна, начните новую сессию
Проверьте стабильность сетевого соединения

Лучшие практики

1. Стратегия выбора модели

Тип задачи	Рекомендуемая модель	Причина
Сложная генерация кода	Claude Sonnet 4	Высокие навыки кодинга, хорошее понимание контекста
Code review	GPT-4.1	Сильные аналитические способности, хорошее внимание к деталям
Быстрые вопросы и ответы	DeepSeek V3	Быстрый ответ, экономичность
Анализ длинных документов	Gemini 2.5 Pro	Поддерживает сверхдлинное контекстное окно

2. Эффективные промпты

❌ Poor prompt: Help me write code

✅ Good prompt: Write an HTTP middleware in TypeScript that
logs requests, including request method, path,
response time, and status code, using pino for output

3. Соображения по безопасности

Не встраивайте API-ключи в код
Используйте переменные окружения для управления конфиденциальной информацией
Проверяйте код, сгенерированный AI, особенно части, связанные с безопасностью
Будьте осторожны и не позволяйте AI выполнять опасные системные команды

4. Контроль затрат

Настройте разные модели для разных агентов (сильные модели для сборки, легкие — для общих задач)
Используйте легкие модели для простых задач
Регулярно проверяйте консоль APIYI, чтобы отслеживать использование

Альтернативы

Если OpenCode не подходит вам, рассмотрите эти инструменты:

Claude Code

Официальный терминальный помощник Anthropic для программирования

Codex CLI

Официальный инструмент командной строки OpenAI

Gemini CLI

Официальный терминальный помощник Google для программирования

Roo Code

AI-расширение для программирования для VS Code

Связанные ресурсы

Консоль APIYI

Управляйте API-ключами и просматривайте использование

​Обзор

🖥️ Поддержка нескольких платформ

🔌 Поддержка 75+ моделей

🛠️ Встроенный LSP

🔄 Параллельная работа нескольких сессий

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

​Установите OpenCode

​Быстрая конфигурация

​Метод 1: Пользовательский провайдер (рекомендуется)

​Метод 2: Аутентификация через команду /connect

​Метод 3: Переопределение существующего провайдера

​Метод 4: Конфигурация на уровне проекта

​Система агентов

​Конфигурация моделей агентов

​Рекомендуемые модели

Посмотреть рекомендации по моделям для программирования

​Рекомендации по моделям в зависимости от сценария

​Основные возможности

​Интерактивный терминальный интерфейс

​Операции с файлами

​Выполнение команд

​Управление сеансами

​Советы по использованию

​1. Сочетания клавиш

​2. Частые команды

​3. Вызов подагента

​4. Инкрементальная разработка

​Устранение неполадок

​Лучшие практики

​1. Стратегия выбора модели

​2. Эффективные промпты

​3. Соображения по безопасности

​4. Контроль затрат

​Альтернативы

Claude Code

Codex CLI

Gemini CLI

Roo Code

​Связанные ресурсы

Консоль APIYI

Рекомендации по моделям

Обзор

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

Установите OpenCode

Быстрая конфигурация

Метод 1: Пользовательский провайдер (рекомендуется)

Метод 2: Аутентификация через команду /connect

Метод 3: Переопределение существующего провайдера

Метод 4: Конфигурация на уровне проекта

Система агентов

Конфигурация моделей агентов

Рекомендуемые модели

Рекомендации по моделям в зависимости от сценария

Основные возможности

Интерактивный терминальный интерфейс

Операции с файлами

Выполнение команд

Управление сеансами

Советы по использованию

1. Сочетания клавиш

2. Частые команды

3. Вызов подагента

4. Инкрементальная разработка

Устранение неполадок

Лучшие практики

1. Стратегия выбора модели

2. Эффективные промпты

3. Соображения по безопасности

4. Контроль затрат

Альтернативы

Связанные ресурсы