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 в каталоге инструментов.
Быстрый старт
Установка
bash# npm (нужен Node.js 22+) npm install -g @github/copilot # macOS — Homebrew brew install --cask copilot-cli # Windows winget install GitHub.CopilotПроверьте:
copilot --version.Адрес API и ключ
Добавьте в
~/.zshrcили~/.bashrc:bashexport 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для каждой переменной, затем новое окно терминала.Запуск
bashsource ~/.zshrc cd ~/projects/my-app copilot # разовая задача без интерактива copilot -p "Найди, где обрабатываются ошибки оплаты, и добавь логирование"
Режим Anthropic для Claude
Через эндпоинт в формате Anthropic Messages Claude получает родное кэширование промптов и thinking-блоки:
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:
{
"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-source | glm-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.