GitHub Copilot CLI — свои модели без подписки и VPN
GitHub Copilot CLI — терминальный агент GitHub, подключённый к моделям AITUNNEL через BYOK
GitHub Copilot CLI — агент в терминале от GitHub: читает проект, правит файлы, запускает команды и работает с git. С версии 1.0.12 у него есть режим BYOK (Bring Your Own Key): вместо моделей из подписки Copilot он ходит в любой OpenAI-совместимый API. AITUNNEL — как раз такой API.
Ниже — установка, три способа подключения, выбор модели и разбор типичных ошибок. В конце есть отдельный раздел про BYOK в VS Code Copilot Chat.
API-ключ для GitHub Copilot CLI
GitHub Copilot CLI обращается к моделям через API-ключ. Ключ AITUNNEL вида sk-aitunnel-... один для всех моделей из каталога: чтобы перейти с Claude на GPT или DeepSeek, достаточно сменить id модели.
- Зарегистрируйтесь на aitunnel.ru и пополните баланс (от 500₽).
- Откройте Ключи, нажмите «Новый», задайте имя и нажмите «Создать ключ».
- Скопируйте ключ. Его можно показать повторно в любой момент.
Copilot CLI берёт ключ только из переменной COPILOT_PROVIDER_API_KEY: поле apiKey в providers.json в текущих версиях игнорируется (подробнее — в разделе про providers.json). Аккаунт и подписка GitHub к ключу AITUNNEL отношения не имеют, расход идёт с баланса AITUNNEL.
Для CI заведите отдельный ключ с дневным бюджетом и передавайте его через секреты репозитория. Если агент в пайплайне зациклится, он упрётся в бюджет ключа, а не в весь баланс. В VS Code Copilot Chat ключ подставляется через ${input:aitunnelKey}: редактор спросит его один раз и сохранит в защищённом хранилище, а не в JSON.
Бюджет, ограничения по моделям и IP, сброс ключа — в документации по ключам.
Что понадобится
- Ключ AITUNNEL вида
sk-aitunnel-...— создаётся в личном кабинете - Положительный баланс (пополнение от 500₽)
- Node.js 22+ (только для установки через npm)
Подписка GitHub Copilot для BYOK не нужна: по документации GitHub в этом режиме CLI работает даже без входа в аккаунт. Без входа недоступны только функции, завязанные на GitHub: /delegate, встроенный GitHub MCP-сервер и поиск по коду репозиториев.
Установка
# npm (кроссплатформенно, нужен Node.js 22+)
npm install -g @github/copilot
# macOS — Homebrew
brew install --cask copilot-cli
# macOS / Linux — установочный скрипт
curl -fsSL https://gh.io/copilot-install | bash# Windows
winget install GitHub.CopilotПроверьте установку командой copilot --version.
Способ 1: переменные окружения (рекомендуется)
Самый надёжный вариант. Добавьте в ~/.zshrc или ~/.bashrc:
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"
# Лимиты модели: Copilot CLI не знает чужие модели и по умолчанию считает 128K
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=200000
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=32000Перечитайте профиль и запустите агента в папке проекта:
source ~/.zshrc
cd ~/projects/my-app
copilotЧто означают переменные:
| Переменная | Значение |
|---|---|
COPILOT_PROVIDER_BASE_URL | https://api.aitunnel.ru/v1 — без /chat/completions на конце |
COPILOT_PROVIDER_TYPE | openai (по умолчанию) — формат Chat Completions |
COPILOT_PROVIDER_API_KEY | ваш ключ sk-aitunnel-... |
COPILOT_MODEL | id модели из каталога AITUNNEL |
COPILOT_PROVIDER_MAX_PROMPT_TOKENS | сколько токенов контекста отдавать модели |
COPILOT_PROVIDER_MAX_OUTPUT_TOKENS | лимит длины ответа |
COPILOT_PROVIDER_WIRE_API | completions (по умолчанию) или responses |
COPILOT_OFFLINE | true — не обращаться к серверам GitHub и отключить телеметрию |
Windows (PowerShell)
setx COPILOT_PROVIDER_BASE_URL "https://api.aitunnel.ru/v1"
setx COPILOT_PROVIDER_TYPE "openai"
setx COPILOT_PROVIDER_API_KEY "sk-aitunnel-xxx"
setx COPILOT_MODEL "claude-sonnet-5.5"
setx COPILOT_PROVIDER_MAX_PROMPT_TOKENS "200000"После setx откройте новое окно терминала — в текущем переменные не появятся.
Responses API для моделей GPT
AITUNNEL поддерживает и Chat Completions, и Responses API. Для GPT-моделей можно включить Responses — так reasoning между шагами агента передаётся точнее:
export COPILOT_PROVIDER_WIRE_API="responses"
export COPILOT_MODEL="gpt-6.1-sol"Для Claude, DeepSeek, Kimi и остальных оставьте completions.
Способ 2: режим Anthropic для моделей Claude
У AITUNNEL есть эндпоинт в формате Anthropic Messages. Через него Claude получает родное кэширование промптов и thinking-блоки без конвертации:
export COPILOT_PROVIDER_TYPE="anthropic"
export COPILOT_PROVIDER_BASE_URL="https://api.aitunnel.ru"
export COPILOT_PROVIDER_API_KEY="sk-aitunnel-xxx"
export COPILOT_MODEL="claude-sonnet-5.5"Обратите внимание: здесь Base URL без /v1 — путь /v1/messages клиент добавляет сам. Этот режим работает только с моделями claude-*.
Способ 3: несколько моделей через providers.json
Если хотите переключаться между моделями командой /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": "kimi-k2.7-code",
"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 } }
}
]
}Ключ и Base URL всё равно держите в переменных окружения COPILOT_PROVIDER_API_KEY и COPILOT_PROVIDER_BASE_URL. В актуальных версиях CLI (проверено на 1.0.105) есть известная ошибка: поле apiKey из providers.json игнорируется, а без COPILOT_PROVIDER_BASE_URL агент молча переключается на модели подписки Copilot.
Запуск с конкретной моделью — формат провайдер/модель:
copilot --model aitunnel/kimi-k2.7-codeВнутри сессии модель меняется командой /model, а /model --global сохраняет выбор по умолчанию.
Первые команды
# Интерактивная сессия в текущем проекте
copilot
# Разовая задача без интерактива
copilot -p "Найди, где обрабатываются ошибки оплаты, и добавь логирование"Агент спрашивает разрешение перед изменением файлов и запуском команд. Каждый запрос виден в разделе «Запросы» личного кабинета с расходом в рублях.
Какую модель выбрать
Copilot CLI работает только с моделями, которые поддерживают вызов инструментов (tool calling) и стриминг. Все модели из таблицы это умеют.
| Задача | Модель | Почему |
|---|---|---|
| Основная работа с кодом | claude-sonnet-5.5 | Сильный агент, контекст 1M токенов |
| Сложный рефакторинг, архитектура | claude-opus-5.5 | Лучшее качество рассуждений, дороже |
| Агентный код от OpenAI | gpt-6.1-sol | Точно следует ограничениям, контекст 1M |
| Код за меньшие деньги | kimi-k2.7-code | Специализирована на программировании |
| Максимальная экономия | deepseek-v4.1-flash | В десятки раз дешевле флагманов |
| Open-source альтернатива | glm-5.3, qwen3-coder-next | Длинные агентные сценарии |
Цены в рублях — на странице моделей.
BYOK в VS Code Copilot Chat
Тот же ключ AITUNNEL можно подключить к чату Copilot в VS Code. BYOK доступен на всех планах — Free, Pro, Pro+, Business и Enterprise. На Business и Enterprise администратор может отключить его политикой «Bring Your Own Language Model Key».
- Откройте выпадающий список моделей в чате и нажмите шестерёнку (Manage Language Models). То же самое — команда
Chat: Manage Language Modelsв палитре команд. - Выберите Add Models → Custom Endpoint.
- Введите имя группы (например,
AITUNNEL), ключ и тип API — Chat Completions. - VS Code откроет файл
chatLanguageModels.json. Приведите его к такому виду:
[
{
"name": "AITUNNEL",
"vendor": "customendpoint",
"apiKey": "${input:aitunnelKey}",
"apiType": "chat-completions",
"models": [
{
"id": "claude-sonnet-5.5",
"name": "Claude Sonnet 5.5 (AITUNNEL)",
"url": "https://api.aitunnel.ru/v1/chat/completions",
"toolCalling": true,
"vision": true,
"thinking": true,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
},
{
"id": "deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash (AITUNNEL)",
"url": "https://api.aitunnel.ru/v1/chat/completions",
"toolCalling": true,
"vision": false,
"maxInputTokens": 200000,
"maxOutputTokens": 32000
}
]
}
]Указывайте в url полный путь до /chat/completions. Модели без toolCalling: true не появятся в режиме агента.
Старая настройка github.copilot.chat.customOAIModels и провайдер «OpenAI Compatible» объявлены устаревшими — используйте Custom Endpoint.
Ограничения: BYOK не распространяется на автодополнение кода (inline completions), семантический поиск и эмбеддинги — они остаются на моделях GitHub.
Устранение неполадок
Агент отвечает, но запросов нет в личном кабинете
CLI ушёл на модели подписки Copilot. Проверьте, что в текущем терминале задана COPILOT_PROVIDER_BASE_URL:
echo $COPILOT_PROVIDER_BASE_URLЕсли используете providers.json, помните: при наличии в нём записей файл перекрывает переменные окружения. Старый забытый файл может прятать ваши настройки.
Ошибка 401
- Ключ должен лежать в
COPILOT_PROVIDER_API_KEY, а не только вproviders.json - Проверьте, что ключ активен в личном кабинете и баланс положительный
- Ключ скопирован без пробелов и кавычек внутри
Ошибка 404 или «model not found»
Сверьте id модели с каталогом посимвольно: claude-sonnet-5.5, а не claude-sonnet-5-5. В режиме Anthropic Base URL должен быть без /v1, в режиме OpenAI — с /v1.
Агент обрезает контекст или «забывает» файлы
Для незнакомых моделей CLI ставит лимит 128K токенов. Увеличьте COPILOT_PROVIDER_MAX_PROMPT_TOKENS (или maxPromptTokens в providers.json). Большой контекст дороже: каждый шаг агента отправляет его заново.
Частые вопросы
Нужна ли подписка GitHub Copilot?
Для BYOK — нет. Вы платите только AITUNNEL за токены. Подписка нужна, если хотите пользоваться моделями GitHub или функциями вроде /delegate.
Можно ли совмещать модели подписки Copilot и свои?
Пока задана COPILOT_PROVIDER_BASE_URL, CLI ходит только в AITUNNEL. Чтобы вернуться к моделям подписки, уберите переменную или откройте терминал без неё.
Работает ли Copilot CLI с российских серверов и в CI?
Да. Задайте переменные в секретах CI и запускайте copilot -p "...". Запросы идут на api.aitunnel.ru без VPN.
Почему это выгодно
- Без VPN — российский endpoint
api.aitunnel.ru - Без подписки Copilot — платите только за использованные токены
- Все модели по одному ключу — Claude, GPT, Gemini, DeepSeek, Kimi, GLM
- Оплата в рублях — карты МИР, СБП, пополнение от 500₽
- Для бизнеса — счёт в кабинете, закрывающие документы через ЭДО
Ключевые возможности
- Один API-ключ AITUNNEL на все модели
- BYOK без подписки GitHub Copilot
- Настройка тремя переменными окружения
- Режим Anthropic Messages для Claude
- Несколько моделей через providers.json и /model
- Тот же ключ работает в VS Code Copilot Chat
- Без VPN, оплата в рублях
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.