Справочник команды GitHub Copilot CLI

Команды командной строки

          `copilot login` варианты

          GitHub URL хоста (по умолчанию: `https://github.com`). Используйте это для аутентификации с GitHub Enterprise Cloud экземпляром, использующим data residency (например, `https://example.ghe.com`). |

Стандартный режим аутентификации — это веб-браузерный поток. После завершения аутентификационный токен надежно хранится в системном хранилище учетных данных. Если хранилище учетных данных не найдено, токен хранится в простом текстовом конфигурационном файле в ~/.copilot/ (или в каталоге, указанном COPILOT_HOME в if set).

В качестве альтернативы Второй пилот CLI буду использовать токен аутентификации, находящийся в переменных окружения. Следующие параметры проверяются в порядке старшинства: COPILOT_GITHUB_TOKEN, GH_TOKEN, , GITHUB_TOKEN. Этот метод наиболее подходит для безголового использования, например, для автоматизации.

Поддерживаемые типы токенов включают fine-grained personal access tokens (v2 PAT) с разрешением «Copilot Requests», токены OAuth из Copilot приложения CLI и токены OAuth из GitHub CLI приложения (gh). Classic personal access tokens (ghp_) не поддерживается.

          **Примеры:**

# Authenticate with github.com
copilot login

# Authenticate with GitHub Enterprise Cloud (data residency)
copilot login --host https://example.ghe.com

# Use a fine-grained PAT via environment variable
COPILOT_GITHUB_TOKEN=github_pat_... copilot

С использованием copilot completion

Команда copilot completion SHELL выводит скрипт для указанной оболочки (bash, zsh или fish).

Используя этот скрипт (или записывая его в каталог завершения вашей оболочки), вы можете включить завершение вкладок в терминале для copilot подкоманд, опций команд и известных значений для опций команд.

Примеры использования

Bash (только текущая сессия):

source <(copilot completion bash)

source <(copilot completion bash)

Bash (persistent, Linux):

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

Zsh — запишите результат в каталог на вашем $fpath. Перезагрузите оболочку после выполнения этой команды:

copilot completion zsh > "${fpath[1]}/_copilot"

copilot completion zsh > "${fpath[1]}/_copilot"

Рыба:

copilot completion fish > ~/.config/fish/completions/copilot.fish

copilot completion fish > ~/.config/fish/completions/copilot.fish

Глобальные ярлыки в интерактивном интерфейсе

Ярлыки временной линии в интерактивном интерфейсе

Навигационные ярлыки в интерактивном интерфейсе

          <kbd>Опция</kbd>+<kbd>←</kbd>/<kbd>→</kbd> (Mac) | Двигайте курсор на слово.             |

| ↑/↓ | Просматривайте историю команд. | | Tab / Ctrl+Y | Примите текущее предложение по завершению inline. |

Команды Slash в интерактивном интерфейсе

Для полного списка доступных команд слэш введите /help в интерактивный интерфейс CLI.

Параметры командной строки

Для полного списка команд и опций запустите copilot help.

Значения доступности инструментов

Опции и --available-tools поддерживают --excluded-tools следующие значения:

Оболочные инструменты

Инструменты управления файлами

Инструменты для делегирования агентов и задач

Другие инструменты

Шаблоны разрешений инструментов

Опции и --allow-tool принимают --deny-tool шаблоны разрешений в формате Kind(argument). Аргумент необязательн — его исключение соответствует всем подобным инструментам.

          `read`, `read(.env)` |

| shell | Выполнение команд shell | shell(git push), , shell(git:*)``shell | | url | Доступ к URL через web-fetch или shell | url(github.com), url(https://*.api.com) | | write | Создание или модификация файлов | write, write(src/*.ts) | | SERVER-NAME | Вызов инструмента MCP-сервера | MyMCP(create_issue), MyMCP |

Для shell правил суффикс :* совпадает с командным стволом, за которым следует пробел, предотвращая частичные совпадения. Например, shell(git:*) совпадение git push и git pull но не совпадает giteaс .

Правила отказа всегда имеют приоритет над правилами допуска, даже если --allow-all они установлены.

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool='MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool='MyMCP'

Переменные среды

          GitHub Имя хоста только Второй пилот CLI для Only, перевышающее `GH_HOST`. Используй, когда `GH_HOST` цель GitHub Enterprise Server , но Copilot требуется аутентификацию по GitHub.com имени, или GitHub Enterprise Cloud при имени хозяина. |

| COPILOT_GITHUB_TOKEN | Маркер проверки подлинности. Имеет приоритет над GH_TOKEN и GITHUB_TOKEN. | | COPILOT_HOME | Переопределите конфигурацию и каталог состояний. По умолчанию: $HOME/.copilot. | | COPILOT_MODEL | Задайте модель ИИ. | | COPILOT_PROMPT_FRAME | Настройте на 1 включение декоративного интерфейса вокруг входного запроса или 0 отключение его. Переопределяет PROMPT_FRAME флаг экспериментальной функции для текущей сессии. | | COPILOT_SKILLS_DIRS | Список дополнительных каталогов с разделёнными запятой для навыков. | | COPILOT_SUBAGENT_MAX_CONCURRENT | Максимальное количество параллельных субагентов по всему дереву сессий. По умолчанию: 32. Диапазон: 1–256. | | COPILOT_SUBAGENT_MAX_DEPTH | Максимальная глубина вложения субагентов. По умолчанию: 6. Диапазон: 1–256. | | GH_HOST | GitHub Имя хоста для обоих GitHub CLI и Второй пилот CLI (по умолчанию: github.com). Установите имя GitHub Enterprise Cloud хоста для проживания с данными. Переопределите только COPILOT_GH_HOST для Второй пилот CLI For. | | GH_TOKEN | Маркер проверки подлинности. Имеет приоритет над GITHUB_TOKEN. | | GITHUB_TOKEN | Маркер проверки подлинности. | | PLAIN_DIFF | Настройте на true отключение рендеринга rich diff. | | USE_BUILTIN_RIPGREP | Настройте на false использование системного ripgrep вместо комплектной версии. |

Настройки конфигурационных файлов

Для подробной информации о настройках конфигурационных файлов — включая полный список пользовательских настроек, репозиториев, локальных настроек и их каскадного распределения — см. Каталог конфигурации CLI GitHub Copilot.

Project инициализация для Copilot

Когда вы используете команду copilot init, или команду слэш /init в интерактивной сессии, Copilot он анализирует вашу кодовую базу и записывает или обновляет .github/copilot-instructions.md файл в репозитории. Этот пользовательский файл инструкций содержит конкретные рекомендации по проекту, которые улучшат будущие сессии CLI.

Обычно вы используете copilot init, или /init, когда начинаете новый проект или Второй пилот CLI в существующем репозитории.

          `copilot-instructions.md` Файл, который создаётся или обновляется, обычно документирует:

• Команды сборки, тестирования и ворса.
• Архитектура высокого уровня.
• Специфичные для кодовой базы конвенции.

Если файл уже существует, он Copilot предлагает улучшения, которые можно применить или отклонить.

CLI ищет copilot-instructions.md файл при запуске, и если он отсутствует, отображается сообщение:

          💡 Инструкции второго пилота не найдено. Запустите /init, чтобы сгенерировать copilot-instructions.md файл для этого проекта.

Если вы не хотите создавать этот файл, вы можете навсегда скрыть это сообщение запуска для текущего репозитория с /init suppress помощью команды slash.

Дополнительные сведения см. в разделе Добавление пользовательских инструкций репозитория для GitHub Copilot.

Ссылка на Hooks

Для подробной информации о крючках — включая форматы конфигурации крючков, события крючков, входные полезные нагрузки и управление решением — см. раздел AUTOTITLE.

Конфигурация сервера MCP

MCP-серверы предоставляют дополнительные инструменты агенту CLI. Настройте постоянные серверы в ~/.copilot/mcp-config.json. Используйте --additional-mcp-config для добавления серверов на одну сессию.

          `copilot mcp` Подкомандование

Используйте copilot mcp управление конфигурациями MCP-сервера из командной строки без запуска интерактивной сессии.

          **
          `copilot mcp add` Параметры:**

          `--show-secrets` Можно печатать чувствительные значения переменных среды и заголовков в ваш терминал или логи. Используйте эту опцию только в доверенных условиях и избегайте копирования, вставки или иного фиксации результатов в общих логах или истории.

Типы транспорта

          `command`, `args` |

| http | Удалённый сервер с использованием потокового HTTP-транспорта. | url | | sse | Удалённый сервер с использованием Server-Sent Events Transport. | url |

Поля конфигурации локального сервера

          `"local"` или `"stdio"`. По умолчанию: `"local"`. |

Поля конфигурации удалённых серверов

          `"http"` или `"sse"`. |

| url | Да | URL сервера. | | tools | Да | Инструменты для включения. | | headers | Нет | HTTP-заголовки. Поддерживает переменное расширение. | | oauthClientId | Нет | Статический идентификатор клиента OAuth (пропускает динамическую регистрацию). | | oauthPublicClient | Нет | Является ли клиент OAuth публичным. По умолчанию: true. | | oidc | Нет | Включить инъекцию токена OIDC. Когда true, вводит GITHUB_COPILOT_OIDC_MCP_TOKEN переменную среды (локальные серверы) или Bearer``Authorization заголовок (удалённые серверы). | | timeout | Нет | Тайм-аут вызова инструментов — в миллисекундах. |

OAuth повторная аутентификация

Удалённые MCP-серверы, использующие OAuth, могут показывать needs-auth статус после истечения срока действия токена или необходимости другого аккаунта. Используйте /mcp auth <server-name> для запуска нового потока OAuth. Это открывает запрос аутентификации в браузере, позволяющий войти в систему или сменить аккаунт. После завершения процесса сервер автоматически подключается.

Фильтровое отображение

Контролировать, как обрабатывается вывод инструмента MCP с помощью filterMapping поля в конфигурации сервера.

Встроенные MCP-серверы

CLI включает встроенные MCP-серверы, доступные без дополнительной настройки.

          GitHub Интеграция с API: проблемы, pull requests, коммиты, поиск по коду и GitHub Actions. |

| playwright | Автоматизация браузера: навигация, клик, ввод, скриншот и обработка форм. | | fetch | HTTP-запросы через инструмент fetch . | | time | Временные утилисы: get_current_time и convert_time. |

Используйте --disable-builtin-mcps для отключения всех встроенных серверов или --disable-mcp-server SERVER-NAME для отключения конкретного сервера.

Наименование серверов MCP

Имена серверов могут содержать любые печатные символы, включая пробелы, символы Unicode и пунктуацию. Контрольные символы (U+0000–U+001F, U+007F) и закрывающая распорка (}) не разрешены. Имена серверов используются как префиксы для имён инструментов — например, сервер с именем my-server создаёт имена инструментов, такие как my-server-fetch, а сервер с именем My Server — .My Server-fetch

Уровни доверия сервера MCP

MCP-серверы загружаются из нескольких источников, каждый с разным уровнем доверия.

Все вызовы инструментов MCP требуют явного разрешения. Это относится даже к операциям только для чтения на внешних сервисах.

Список разрешений корпоративного MCP

          GitHub Enterprise организации могут применять список разрешений для разрешённых MCP-серверов. При активном режиме CLI оценивает каждый нестандартный сервер по корпоративной политике перед подключением.

Когда обнаруживается GitHub Enterprise политика реестра (или MCP_ENTERPRISE_ALLOWLIST включен флаг экспериментальной функции), CLI:

1. Вычисляет отпечаток пальца для каждого настроенного нестандартного сервера на основе его команды, аргументов и удалённых URL.
2. Отправляет отпечатки пальцев в конечную точку оценки корпоративного списка разрешений.
3. Разрешено только серверы, чьи отпечатки одобрены; все остальные блокируются сообщением с названием Enterprise.

Эта проверка является fail-closed: если конечная точка оценки недоступна или возвращает ошибку, нестандартные серверы блокируются до проверки политики.

Когда сервер блокируется корпоративным списком разрешений, CLI отображает:

MCP server "SERVER-NAME" was blocked by your enterprise "ENTERPRISE-NAME".
Contact your enterprise administrator to add this server to the allowlist.

Встроенные серверы по умолчанию всегда освобождаются от контроля по спискам разрешений.

Миграция из .vscode/mcp.json

Если ваш проект использует .vscode/mcp.json (формат конфигурации MCP VS Code), переходите на .mcp.json для GitHub Copilot CLI. Миграция переназначает servers ключ на mcpServers.

          **Раковины POSIX (bash, zsh, fish и другие):**

jq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json

Требует jq.

          **PowerShell:**

pwsh -NoProfile -Command "`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))"

В Windows замените pwsh на powershell, если используете Windows PowerShell вместо PowerShell Core.

Справочник по навыкам

Навыки — это файлы Markdown, которые расширяют возможности CLI. Каждый навык находится в отдельном каталоге с SKILL.md файлом. При вызове (через /SKILL-NAME агента или автоматически) содержание навыка вводится в разговор.

Фронтматические поля навыков

Места навыков

Навыки загружаются из этих мест в порядке приоритета (первым найденным выигрывает дублирующиеся имена).

Команды (альтернативный формат навыка)

Команды являются альтернативой навыкам, хранящимся в отдельных .md файлах в .claude/commands/. Имя команды происходит от имени файла. Командные файлы используют упрощённый формат (поле не name требуется) и поддерживают description, allowed-tools, и disable-model-invocation. Команды имеют меньший приоритет, чем умения с таким же названием.

Ссылка на таможенных агентов

Пользовательские агенты — это специализированные AI-агенты, определённые в файлах Markdown. Имя файла (без расширения) становится идентификатором агента. Используйте .agent.md или .md как расширение файла.

Встроенные агенты

Фронтматэрные поля пользовательского агента

Местоположение кастомных агентов

          `.github/agents/` или `.claude/agents/` |

| User | ~/.copilot/agents/ | | Плагин | <plugin>/agents/ |

Агенты уровня Project имеют приоритет над агентами пользовательского уровня. Агенты плагинов имеют самый низкий приоритет.

Ограничения субагентов

CLI устанавливает ограничения на глубину и параллельность, чтобы предотвратить появление неуправляемых агентов.

          **Глубина** определяет, сколько агентов вложено друг в друга. При достижении предела глубины самый внутренний агент не может создавать новые субагенты. 
          **Параллельность** подсчитывает, сколько субагентов работает одновременно на протяжении всего дерева сессий. При достижении лимита новые запросы субагентов отклоняются до тех пор, пока активный агент не завершит работу. Значения фиксируются между `1` и `256`.

Ответы на одобрение разрешений

Когда CLI запросит разрешение на выполнение операции, вы можете ответить следующими клавишами.

Одобрения сессий сбрасываются, когда вы запускаете /clear или начинаете новую сессию.

Мониторинг OpenTelemetry

          Второй пилот CLI может экспортировать трассы и метрики через [OpenTelemetry](https://opentelemetry.io/) (OTel), что даёт вам видимость взаимодействия с агентами, вызовы LLM, выполнение инструментов и использование токенов. Все имена и атрибуты сигналов следуют [семантическим конвенциям OTel GenAI](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/).

OTel по умолчанию выключен без накладных расходов. Он активируется при выполнении любого из следующих условий:

• COPILOT_OTEL_ENABLED=true
• OTEL_EXPORTER_OTLP_ENDPOINT задано
• COPILOT_OTEL_FILE_EXPORTER_PATH задано

Переменные среды OTel

Traces

Время выполнения создаёт иерархическое дерево span для каждого взаимодействия агента. Каждое дерево содержит корневый invoke_agent размах, с chat и execute_tool дочерними spans.

          `invoke_agent` Атрибуты размаха

Обворачивает весь вызов агента: все LLM-вызовы и выполнение инструментов для одного пользовательского сообщения.

• Верхнеуровневые сессии используют span kind CLIENT (удалённый вызов сервиса) с server.address и server.port.
• Вызовы субагентов (например, explore, task) используют span kind INTERNAL (in-process) без атрибутов сервера.

          `["stop"]` или `["error"]` | Both |

| gen_ai.usage.input_tokens | Общее количество входных жетонов (все ходы) | Both | | gen_ai.usage.output_tokens | Общее количество токенов выхода (все ходы) | Both | | gen_ai.usage.cache_read.input_tokens | Кэшированные входные токены считываются | Both | | gen_ai.usage.cache_creation.input_tokens | Созданы кэшированные входные токены | Both | | github.copilot.turn_count | Количество поездок с LLM туда и обратно | Both | | github.copilot.cost | Денежные затраты | Both | | github.copilot.aiu | Потраченные единицы ИИ | Both | | server.address | Имя хоста сервера | Только CLIENT | | server.port | Порт сервера | Только CLIENT | | error.type | Имя класса ошибки (по ошибке) | Both | | gen_ai.input.messages | Полные вводные сообщения в формате JSON (только захват контента) | Both | | gen_ai.output.messages | Полный вывод сообщений в формате JSON (только захват контента) | Both | | gen_ai.system_instructions | Системный запрос контента в формате JSON (только захват контента) | Both | | gen_ai.tool.definitions | Схемы инструментов в формате JSON (только захват контента) | Both |

          `chat` Атрибуты размаха

Один проём на запрос LLM. Размах видов: CLIENT.

          `execute_tool` Атрибуты размаха

Один размах на вызов инструмента. Размах видов: INTERNAL.

Metrics

Метрики конвенции GenAI

Метрики, специфичные для поставщика

Временные события

События жизненного цикла, зафиксированные на активном chat или invoke_agent промежуточном цикле.

          `github.copilot.hook.type`, `github.copilot.hook.invocation_id` |

| github.copilot.hook.end | Крюк выполнен успешно | github.copilot.hook.type, github.copilot.hook.invocation_id | | github.copilot.hook.error | Крюк не сработал | github.copilot.hook.type, , github.copilot.hook.invocation_id``github.copilot.hook.error_message | | github.copilot.session.truncation | История разговоров была сокращена | github.copilot.token_limit, github.copilot.pre_tokens, github.copilot.post_tokens``github.copilot.pre_messages``github.copilot.post_messages``github.copilot.tokens_removed``github.copilot.messages_removed``github.copilot.performed_by | | github.copilot.session.compaction_start | Начало уплотнения в истории | Нет | | github.copilot.session.compaction_complete | Завершено уплотнение истории | github.copilot.success, github.copilot.pre_tokens, github.copilot.post_tokens, github.copilot.tokens_removed``github.copilot.messages_removed, , ( github.copilot.message только захват контента) | | github.copilot.skill.invoked | Был вызван навык | github.copilot.skill.name, , github.copilot.skill.path``github.copilot.skill.plugin_name``github.copilot.skill.plugin_version | | github.copilot.session.shutdown | Сессия закрывается | github.copilot.shutdown_type, github.copilot.total_premium_requests, , github.copilot.lines_added, github.copilot.lines_removed``github.copilot.files_modified_count | | github.copilot.session.abort | Пользователь отменил текущую операцию | github.copilot.abort_reason | | exception | Ошибка сессии | github.copilot.error_type, , github.copilot.error_status_code``github.copilot.error_provider_call_id |

Атрибуты ресурсов

Все сигналы несут эти атрибуты ресурсов.

          `github-copilot` (настраивается через `OTEL_SERVICE_NAME`) |

| service.version | Версия среды выполнения |

Захват контента

По умолчанию не фиксируется содержимое запросов, ответы или аргументы инструментов — только метаданные, такие как названия моделей, количество токенов и длительность. Чтобы охватить полный контент, установите OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true.

Когда включено захват контента, заполняются следующие атрибуты.

Дополнительные материалы

• GitHub Copilot CLI
• Ссылка на крючки GitHub Copilot CLI
• Ссылка на плагин GitHub Copilot CLI
• GitHub Copilot CLI программный справочник
• Каталог конфигурации CLI GitHub Copilot