Skip to content

README.ru.md

Latest commit

 

History

History
80 lines (58 loc) · 3.58 KB

README.ru.md

File metadata and controls

80 lines (58 loc) · 3.58 KB

TunnelCode

AI-агент для программирования в терминале на базе GPTunnel.

English | Русский

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

Установка

npm i -g tunnelcode

Быстрый старт

  1. Получите API-ключ на gptunnel.ru/profile/business
  2. Запустите tunnelcode в директории вашего проекта
  3. Введите API-ключ при запросе
  4. Выберите модель и начинайте работу

Ключ также можно задать через переменную окружения:

export GPTUNNEL_API_KEY=your-key-here
tunnelcode

Возможности

  • Полноценный AI-агент: редактирование файлов, bash-команды, поиск по коду, поддержка MCP
  • Доступ ко всем моделям GPTunnel (GPT-4o, Claude, Gemini и другие)
  • Терминальный интерфейс с двумя встроенными агентами:
    • build — агент с полным доступом для разработки (по умолчанию)
    • plan — агент только для чтения, для анализа и изучения кода
  • Субагент @general для сложных поисков и многошаговых задач
  • Конфиг проекта через tunnelcode.json (с fallback на opencode.json)
  • Кастомные агенты и навыки через директорию .tunnelcode/
  • Клиент-серверная архитектура — запускайте локально, управляйте удалённо
  • Поддержка LSP из коробки

Конфигурация

TunnelCode использует tunnelcode.json для настройки проекта. Если файл не найден, используется opencode.json.

// tunnelcode.json
{
  "provider": {
    "gptunnel": {
      "name": "GPTunnel",
      "api": "https://gptunnel.ru/v1",
      "env": ["GPTUNNEL_API_KEY"]
    }
  },
  "enabled_providers": ["gptunnel"]
}

Кастомные агенты и темы хранятся в .tunnelcode/ (с fallback на .opencode/).

На базе OpenCode

TunnelCode построен на основе OpenCode — open-source AI-агента для программирования. Мы поддерживаем минимальный diff от upstream, чтобы оперативно получать новые фичи и исправления.

Ключевые отличия от OpenCode:

  • Предварительно настроен для работы с GPTunnel из коробки
  • Упрощённый онбординг — без выбора провайдера, просто введите API-ключ GPTunnel
  • Модели загружаются динамически из API GPTunnel с локальным кэшированием
  • Приоритет конфигов TunnelCode (tunnelcode.json, .tunnelcode/)

Лицензия

MIT