GitHub Copilot CLI

Терминальный агент GitHub в режиме BYOK: вместо моделей подписки Copilot он работает с моделями AITUNNEL.

GitHub Copilot CLI — агент в терминале: читает проект, правит файлы, запускает команды и работает с git. С версии 1.0.12 в нём есть режим BYOK (Bring Your Own Key), в котором CLI ходит в любой OpenAI-совместимый API, в том числе в AITUNNEL.

Понадобятся ключ из панели и Node.js 22+, если ставите через npm. Подписка Copilot и вход в аккаунт GitHub для BYOK не нужны. Без входа недоступны только /delegate, встроенный GitHub MCP-сервер и поиск по коду репозиториев.

Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице GitHub Copilot CLI в каталоге инструментов.

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

  1. Установка

    bash
    # npm (нужен Node.js 22+)
    npm install -g @github/copilot
    
    # macOS — Homebrew
    brew install --cask copilot-cli
    
    # Windows
    winget install GitHub.Copilot

    Проверьте: copilot --version.

  2. Адрес API и ключ

    Добавьте в ~/.zshrc или ~/.bashrc:

    bash
    export COPILOT_PROVIDER_BASE_URL="https://api.aitunnel.ru/v1"
    export COPILOT_PROVIDER_TYPE="openai"
    export COPILOT_PROVIDER_API_KEY="sk-aitunnel-xxx"
    export COPILOT_MODEL="claude-sonnet-5.5"
    
    # Чужих моделей CLI не знает и по умолчанию считает контекст 128K
    export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=200000
    export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=32000

    Адрес указывается без /chat/completions на конце. На Windows — setx для каждой переменной, затем новое окно терминала.

  3. Запуск

    bash
    source ~/.zshrc
    cd ~/projects/my-app
    copilot
    
    # разовая задача без интерактива
    copilot -p "Найди, где обрабатываются ошибки оплаты, и добавь логирование"

Режим Anthropic для Claude

Через эндпоинт в формате Anthropic Messages Claude получает родное кэширование промптов и thinking-блоки:

bash
export COPILOT_PROVIDER_TYPE="anthropic"
export COPILOT_PROVIDER_BASE_URL="https://api.aitunnel.ru"
export COPILOT_MODEL="claude-sonnet-5.5"

Здесь адрес без /v1: путь /v1/messages клиент добавляет сам. Режим работает только с моделями claude-*. Для GPT-моделей можно включить Responses API: COPILOT_PROVIDER_WIRE_API="responses".

Несколько моделей

Чтобы переключаться командой /model, опишите модели в ~/.copilot/providers.json:

~/.copilot/providers.json
{
  "providers": [
    {
      "name": "aitunnel",
      "type": "openai",
      "baseUrl": "https://api.aitunnel.ru/v1",
      "wireApi": "completions"
    }
  ],
  "models": [
    {
      "id": "claude-sonnet-5.5",
      "provider": "aitunnel",
      "maxPromptTokens": 200000,
      "maxOutputTokens": 32000,
      "capabilities": { "supports": { "toolCalls": true, "vision": true, "streaming": true } }
    },
    {
      "id": "deepseek-v4.1-flash",
      "provider": "aitunnel",
      "maxPromptTokens": 200000,
      "maxOutputTokens": 32000,
      "capabilities": { "supports": { "toolCalls": true, "vision": false, "streaming": true } }
    }
  ]
}

Ключ и адрес всё равно держите в COPILOT_PROVIDER_API_KEY и COPILOT_PROVIDER_BASE_URL: без адреса в переменной агент молча уходит на модели подписки. Запуск с конкретной моделью — copilot --model aitunnel/deepseek-v4.1-flash, /model --global сохраняет выбор.

Модели

Нужны модели с tool calling и стримингом. Все модели из таблицы это умеют.

ЗадачаМодель
Основная работаclaude-sonnet-5.5
Сложный рефакторингclaude-opus-5.5, gpt-6.1-sol
Код подешевлеkimi-k2.7-code
Экономияdeepseek-v4.1-flash
Open-sourceglm-5.3, qwen3-coder-next

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

Агент отвечает, но запросов нет в панели

CLI ушёл на модели подписки Copilot. Проверьте echo $COPILOT_PROVIDER_BASE_URL в текущем терминале. Если providers.json содержит записи, он перекрывает переменные окружения, и забытый старый файл может прятать ваши настройки.

404 или model not found

Id модели — посимвольно как в каталоге: claude-sonnet-5.5, а не claude-sonnet-5-5. В режиме openai адрес с /v1, в режиме anthropic — без.

Агент обрезает контекст

Для незнакомых моделей CLI ставит лимит 128K. Увеличьте COPILOT_PROVIDER_MAX_PROMPT_TOKENS или maxPromptTokens в providers.json.

Смотрите также