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

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

copilot login варианты

Стандартный режим аутентификации — это веб-браузерный поток. После завершения аутентификационный токен надежно хранится в системном хранилище учетных данных. Если хранилище учетных данных не найдено, токен хранится в простом текстовом конфигурационном файле в ~/.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

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

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

Ярлыки для сессионного выбора

Когда выбор сессии открыт (открыт через /resume или --continue):

Сессии сортируются по следующим режимам:

Сессии, уже открытые в другом окне, поднимаются наверх во всех нерелевантных режимах сортировки. Когда контекст рабочей директории отсутствует, relevance режим пропускается.

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

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

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

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

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

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

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

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

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

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

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

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

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

Для 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'

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

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

Для подробной информации о настройках конфигурационных файлов — включая полный список пользовательских настроек, репозиториев, локальных настроек и их каскадного распределения — см. Каталог конфигурации 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 Параметры:**

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

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

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

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

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

Безголовый OAuth (client_credentials грант)

Для случаев использования CI или cron, когда браузер недоступен, установите oauthGrantType: "client_credentials". Этот подход включает следующие этапы.

• oauthClientId—статический идентификатор клиента, выдаваемый поставщиком MCP.
• oauthPublicClient: false—клиент конфиденциальный.
• Хранится client_secret в системном ключе (настраивается один раз через /mcp пользовательский интерфейс или записывается в хранилище учетных данных OAuth).

При настройке CLI полностью пропускает браузер, сервер обратного вызова, PKCE и динамическую регистрацию клиента. На каждом 401 он отправляется grant_type=client_credentials напрямую на обнаруженный токен сервера.

{
    "mcpServers": {
        "headless-api": {
            "type": "http",
            "url": "https://api.example.com/mcp",
            "tools": ["*"],
            "oauthClientId": "YOUR-CLIENT-ID",
            "oauthPublicClient": false,
            "oauthGrantType": "client_credentials"
        }
    }
}

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

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

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

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

Используйте --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 очищаются перед отправкой в модель. Символы, недопустимые в названиях инструментов (кроме a-z, A-Z, 0-9``-``_), заменяются на .- Символы Unicode кодируются в Punycode. Символ также заменён на@, - чтобы избежать конфликтов с кодированием Punycode.

Объединённое имя (serverName-toolName) ограничено 64 символами. Когда усечение вызывает коллизию имён, добавляется числовой суффикс (например, my-server-tool2, my-server-tool3) для обеспечения уникальности.

Уровни доверия сервера 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 как расширение файла.

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

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

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

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

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

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

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

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

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

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

Опция This location появляется, когда CLI может определить ключ местоположения (корень git или текущий каталог). Он сохраняет одобрение для диска, так что то же разрешение автоматически получается при следующей работе с этой директорией без повторного запроса.

Используйте /permissions reset для очистки одобрений в памяти для текущей сессии.

Мониторинг OpenTelemetry

Второй пилот CLI может экспортировать трассы и метрики через OpenTelemetry (OTel), что даёт вам видимость взаимодействия с агентами, вызовы LLM, выполнение инструментов и использование токенов. Все имена и атрибуты сигналов следуют семантическим конвенциям OTel GenAI.

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) без атрибутов сервера.

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

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

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

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

Metrics

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

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

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

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

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

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

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

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

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

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

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