Аргументы CLI¶

Команда запуска называется koda. Справочник описывает флаги запуска, значения по умолчанию и связанные переменные окружения. Общие настройки и их приоритет — на странице настройки, команды внутри сессии — в справочнике команд.

Приоритет настроек¶

От низшего к высшему:

Значения по умолчанию — встроены в код;
settings.json — файлы настроек;
Переменные окружения — переопределяют настройки (если заданы);
CLI-флаги — переопределяют переменные окружения и настройки (если заданы явно).

Основной запуск¶

Команда	Назначение
`koda`	открыть интерактивную сессию
`koda -p "prompt"`	выполнить prompt в неинтерактивном режиме и выйти
`koda -i "prompt"`	выполнить prompt и продолжить интерактивно
`koda --version`	показать версию (алиас `-v`)
`koda --help`	показать справку (алиас `-h`)

Глобальные флаги --help/-h и --version/-v предоставляются самим парсером аргументов и доступны для koda и всех подкоманд.

Опции¶

Опция	Алиас	Назначение
`--model <id>`	`-m`	выбрать модель
`--prompt <text>`	`-p`	prompt для неинтерактивного режима; stdin добавляется к prompt
`--prompt-interactive <text>`	`-i`	выполнить prompt и оставить TUI открытым
`--sandbox`	`-s`	запустить CLI в песочнице
`--sandbox-image <uri>`		образ для Docker/Podman sandbox
`--debug`	`-d`	включить debug-режим
`--all-files`	`-a`	включить все найденные файлы в контекст
`--show-memory-usage`		показывать использование памяти в статусной строке
`--show-reasoning`		выводить reasoning модели в stderr в неинтерактивном режиме
`--approval-mode <mode>`		`default`, `auto_edit` или `yolo`
`--yolo`	`-y`	алиас для `--approval-mode=yolo`
`--checkpointing`	`-c`	включить checkpointing изменений файлов
`--acp`	`--experimental-acp`	запустить агент в ACP-режиме для IDE-клиента
`--allowed-mcp-server-names <names...>`		ограничить набор MCP-серверов
`--extensions <names...>`	`-e`	включить только указанные расширения; значение `none` отключает все
`--list-extensions`	`-l`	вывести доступные расширения и выйти
`--proxy <url>`		proxy для Koda client
`--ca-file <path>`		путь к PEM-набору корневых сертификатов
`--include-directories <dirs...>`		добавить каталоги в рабочую область; можно передавать через запятую
`--telemetry`		включить отправку телеметрии
`--telemetry-target <target>`		цель телеметрии: `local` или `gcp`
`--telemetry-otlp-endpoint <url>`		OTLP-адрес для телеметрии
`--telemetry-log-prompts`		включить или отключить логирование промптов
`--telemetry-outfile <path>`		перенаправить вывод телеметрии в файл

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

Модель и контекст¶

`--model`¶

koda-base KODA_MODEL

Модель для диалога. Значение по умолчанию применяется, если модель не задана настройками или переменными окружения.

`--all-files`¶

false

Включить все найденные файлы в контекст.

`--include-directories`¶

Добавить каталоги в рабочую область. Каталоги можно передавать через запятую или повторяя флаг.

Работает вместе с настройками

CLI-флаги добавляются к значению настройки includeDirectories, а не заменяют его.

Режим запуска¶

`--prompt`¶

Prompt для неинтерактивного режима. Содержимое stdin добавляется к prompt.

Нельзя использовать вместе с --prompt-interactive

`--prompt-interactive`¶

Выполнить prompt и продолжить в интерактивном режиме.

Нельзя использовать вместе с --prompt

`--show-reasoning`¶

false

В неинтерактивном режиме выводить reasoning модели в stderr. В stdout остаётся только ответ.

Подтверждение действий¶

`--approval-mode`¶

Режим подтверждения вызова инструментов:

default — запрашивать подтверждение;
auto_edit — автоматически подтверждать инструменты редактирования;
yolo — автоматически подтверждать все инструменты.

Нельзя использовать вместе с --yolo

Используйте --approval-mode=yolo вместо комбинации флагов.

`--yolo`¶

false

Алиас для --approval-mode=yolo.

Песочница¶

Подробнее — на странице о песочнице.

`--sandbox`¶

false KODA_SANDBOX

Запустить CLI в песочнице. Значением может быть true, false или одна из команд: docker, podman, sandbox-exec.

!!! info "Переменная окружения" KODA_SANDBOX имеет приоритет над флагом и настройками.

`--sandbox-image`¶

KODA_SANDBOX_IMAGE

Образ для Docker/Podman sandbox. По умолчанию используется образ, заданный в конфигурации пакета.

Отладка и мониторинг¶

`--debug`¶

false DEBUG, DEBUG_MODE

Включить debug-режим.

Переменные окружения

DEBUG или DEBUG_MODE со значением true или 1 включают debug-режим без флага.

`--show-memory-usage`¶

false

Показывать использование памяти в статусной строке.

Сеть¶

`--proxy`¶

HTTPS_PROXY, HTTP_PROXY

Строка подключения к прокси-серверу в формате schema://user:password@host:port. Имеет приоритет над переменными окружения и настройками.

`--ca-file`¶

Путь к PEM-набору корневых сертификатов для HTTP-запросов CLI. Имеет приоритет над настройкой network.caFile.

Checkpointing¶

`--checkpointing`¶

false

Включить checkpointing изменений файлов. Эквивалентен настройке checkpointing.enabled.

Подробнее — на странице контрольные точки.

MCP и расширения¶

`--allowed-mcp-server-names`¶

Ограничить набор MCP-серверов, которые могут использоваться. Переопределяет настройки allowMCPServers и excludeMCPServers.

Настройка серверов описана в разделе MCP-серверы.

`--extensions`¶

Включить только указанные расширения. Значение none отключает все расширения.

`--list-extensions`¶

false

Вывести доступные расширения и выйти.

Телеметрия¶

`--telemetry`¶

Включить отправку телеметрии. Другие флаги --telemetry-* задают отдельные значения, но сами по себе телеметрию не включают.

`--telemetry-target`¶

Цель телеметрии: local или gcp. Переопределяет настройки.

`--telemetry-otlp-endpoint`¶

OTEL_EXPORTER_OTLP_ENDPOINT

OTLP-адрес для телеметрии. Переопределяет переменную окружения и настройки.

`--telemetry-log-prompts`¶

Включить или отключить логирование пользовательских промптов для телеметрии. Переопределяет настройки.

`--telemetry-outfile`¶

Перенаправить весь вывод телеметрии в указанный файл.

IDE-интеграция¶

`--acp`¶

Запустить агент в ACP-режиме для IDE-клиента, например JetBrains AI Assistant. Алиас: --experimental-acp.

Подробнее — на странице ACP-режим.

Подкоманды верхнего уровня¶

Помимо основного запуска koda поддерживает встроенные подкоманды для управления MCP-серверами, языком интерфейса, расширениями и навыками. Все подкоманды выполняются однократно, выводят результат в терминал и завершают процесс, не открывая сессию.

Общий синтаксис:

koda <подкоманда> <действие> [аргументы] [опции]

Неизвестные опции и подкоманды приводят к ошибке разбора: CLI работает в строгом режиме.

MCP¶

Подкоманда koda mcp управляет MCP-серверами: добавляет, удаляет и показывает настроенные серверы.

koda mcp <add|remove|list> [аргументы] [опции]

Без указания действия koda mcp показывает справку.

`koda mcp add`¶

Добавляет или обновляет MCP-сервер в настройках.

koda mcp add [options] <name> <commandOrUrl> [args...]

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя сервера, под которым он будет сохранён в настройках
`commandOrUrl`	да	команда запуска (stdio) или URL сервера (sse, http)
`args`	нет	аргументы команды запуска для транспорта `stdio`

Опции:

Опция	Алиас	Значения	По умолчанию	Назначение
`--scope`	`-s`	`user`, `project`	`project`	область настроек: `user` — глобально, `project` — для проекта
`--transport`	`-t`	`stdio`, `sse`, `http`	`stdio`	тип транспорта сервера
`--env`	`-e`	`KEY=value` (можно повторять)		переменные окружения для процесса сервера (только `stdio`)
`--header`	`-H`	`Header: value` (можно повторять)		HTTP-заголовки для серверов `sse` и `http`
`--timeout`		число (миллисекунды)		таймаут подключения к серверу
`--trust`		`true` / `false`	`false`	доверять серверу: пропускать подтверждения вызовов инструментов
`--description`		строка		описание сервера
`--include-tools`		список имён через запятую (можно повторять)		разрешить только перечисленные инструменты
`--exclude-tools`		список имён через запятую (можно повторять)		скрыть перечисленные инструменты от модели

Если сервер с таким именем уже существует, команда обновляет его конфигурацию.

Примеры:

koda mcp add my-server npx -y @some/mcp-server
koda mcp add remote --transport sse --header "X-Api-Key: abc123" https://example.com/sse
koda mcp add gated --transport http --include-tools list,read --trust https://example.com/mcp

`koda mcp remove`¶

Удаляет MCP-сервер из настроек.

koda mcp remove [options] <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя удаляемого сервера

Опции:

Опция	Алиас	Значения	По умолчанию	Назначение
`--scope`	`-s`	`user`, `project`	`project`	область настроек, из которой удалить

Если сервер не найден в выбранной области, команда сообщает об этом и завершается без изменений.

`koda mcp list`¶

Показывает настроенные MCP-серверы и их статус подключения.

koda mcp list

Команда не принимает аргументов. Для каждого сервера выводится имя, команда или URL, тип транспорта и статус после попытки реального подключения:

✓ Connected — сервер ответил на ping;
✗ Disconnected — подключиться не удалось;
… Connecting — подключение ещё выполняется.

Language¶

Подкоманда koda language управляет языком интерфейса.

koda language <set> <language>

`koda language set`¶

Устанавливает язык интерфейса в пользовательских настройках.

koda language set <language>

Позиционные аргументы:

Аргумент	Обязательный	Значения	Назначение
`language`	да	`en`, `ru`	код языка интерфейса

Примеры:

koda language set ru
koda language set en

После изменения перезапустите другие запущенные экземпляры koda, чтобы язык применился.

Extensions¶

Подкоманда koda extensions управляет расширениями.

koda extensions <install|uninstall|list|update|enable|disable> [аргументы] [опции]

`koda extensions install`¶

Устанавливает расширение из git-репозитория или локальной директории.

koda extensions install [options] [source]

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`source`	нет	git-URL расширения

Опции:

Опция	Значения	Назначение
`--path`	строка	путь к локальной директории расширения

Аргументы source и --path взаимоисключающие: должен быть указан ровно один из них. После установки расширение включается автоматически.

Примеры:

koda extensions install https://github.com/example/my-extension
koda extensions install --path ./local-extension

`koda extensions uninstall`¶

Удаляет установленное расширение.

koda extensions uninstall <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя удаляемого расширения

`koda extensions list`¶

Показывает установленные расширения.

koda extensions list

Команда не принимает аргументов. Если расширений нет, выводится No extensions installed.

`koda extensions update`¶

Обновляет расширение до последней версии.

koda extensions update <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя обновляемого расширения

При успехе выводится сообщение о смене версии: старая → новая.

`koda extensions enable`¶

Включает расширение в указанной области настроек.

koda extensions enable [options] <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя включаемого расширения

Опции:

Опция	Значения	По умолчанию	Назначение
`--scope`	`User`, `Workspace`		область включения; без опции — во всех областях

`koda extensions disable`¶

Отключает расширение в указанной области настроек.

koda extensions disable [options] <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя отключаемого расширения

Опции:

Опция	Значения	По умолчанию	Назначение
`--scope`	`User`, `Workspace`	`User`	область, в которой отключить

Skills¶

Подкоманда koda skills управляет навыками агента: установкой, удалением и состоянием включения.

koda skills <list|install|uninstall|enable|disable> [аргументы] [опции]

Область настроек (--scope) во всех подкомандах принимает user, project или workspace. Области project и workspace эквивалентны: обе соответствуют настройкам рабочего каталога.

`koda skills list`¶

Показывает обнаруженные навыки.

koda skills list

Команда не принимает аргументов. Для каждого навыка выводятся имя, описание и метки: disabled — отключён, builtin — встроенный.

`koda skills install`¶

Устанавливает навыки из git-репозитория, локальной директории или .skill-пакета.

koda skills install [options] [source]

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`source`	нет	git-URL, путь к локальной директории навыка или `.skill`-пакет

Опции:

Опция	Алиас	Значения	По умолчанию	Назначение
`--path`		строка		локальная директория, если `source` не указан, или поддиректория внутри `source`
`--scope`	`-s`	`user`, `project`, `workspace`	`user`	область установки

Источником служит source либо --path. Если source указывает на репозиторий, а --path задан, устанавливается навык из указанной поддиректории репозитория. Установка копирует каталог навыка в ~/.kodacli/skills (область user) или <проект>/.kodacli/skills (область project).

Примеры:

koda skills install https://github.com/example/my-skills
koda skills install --path ./my-skill
koda skills install https://github.com/example/mono-repo --path packages/skill-a --scope project
koda skills install ./skill-package.skill

`koda skills uninstall`¶

Удаляет установленный навык.

koda skills uninstall [options] <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя удаляемого навыка

Опции:

Опция	Алиас	Значения	По умолчанию	Назначение
`--scope`	`-s`	`user`, `project`, `workspace`	`user`	область, из которой удалить

`koda skills enable`¶

Включает навык в указанной области настроек.

koda skills enable [options] <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя включаемого навыка

Опции:

Опция	Алиас	Значения	По умолчанию	Назначение
`--scope`	`-s`	`user`, `project`, `workspace`	`project`	область включения

Команда удаляет навык из списка отключённых skills.disabled выбранной области. Если навык не найден среди обнаруженных, выводится список доступных навыков.

`koda skills disable`¶

Отключает навык в указанной области настроек.

koda skills disable [options] <name>

Позиционные аргументы:

Аргумент	Обязательный	Назначение
`name`	да	имя отключаемого навыка

Опции:

Опция	Алиас	Значения	По умолчанию	Назначение
`--scope`	`-s`	`user`, `project`, `workspace`	`project`	область отключения

Удалённый доступ через Telegram¶

Подробнее о настройке и командах — на странице удалённого доступа через Telegram.

Удалённый доступ через Telegram управляется слеш-командами внутри сессии, а не подкомандой CLI:

/telegram status
/telegram setup <bot-token>
/telegram link
/telegram relink
/telegram unlink
/telegram disable

/telegram setup сохраняет токен бота в пользовательских настройках и включает удалённый доступ через Telegram. Ссылка привязки владельца появляется в /stats, когда бот подключился. Флоу рассчитан на одного владельца: один Telegram-пользователь управляет текущим CLI, а удалённые сессии живут только пока этот CLI запущен.

Со стороны Telegram доступны /start <code> для привязки, /new, /model, /stats, /compress, /revert, /delete, /stop, /commit и /unlink.

Аргументы CLI¶

Приоритет настроек¶

Основной запуск¶

Опции¶

Модель и контекст¶

--model¶

--all-files¶

--include-directories¶

Режим запуска¶

--prompt¶

--prompt-interactive¶

--show-reasoning¶

Подтверждение действий¶

--approval-mode¶

--yolo¶

Песочница¶

--sandbox¶

--sandbox-image¶

Отладка и мониторинг¶

--debug¶

--show-memory-usage¶

Сеть¶

--proxy¶

--ca-file¶

Checkpointing¶

--checkpointing¶

MCP и расширения¶

--allowed-mcp-server-names¶

--extensions¶

--list-extensions¶

Телеметрия¶

--telemetry¶

--telemetry-target¶

--telemetry-otlp-endpoint¶

--telemetry-log-prompts¶

--telemetry-outfile¶

IDE-интеграция¶

--acp¶

Подкоманды верхнего уровня¶

MCP¶

koda mcp add¶

koda mcp remove¶

koda mcp list¶

Language¶

koda language set¶

Extensions¶

koda extensions install¶

koda extensions uninstall¶

koda extensions list¶

koda extensions update¶

koda extensions enable¶

koda extensions disable¶

Skills¶

koda skills list¶

koda skills install¶

koda skills uninstall¶

koda skills enable¶

koda skills disable¶

Удалённый доступ через Telegram¶

`--model`¶

`--all-files`¶

`--include-directories`¶

`--prompt`¶

`--prompt-interactive`¶

`--show-reasoning`¶

`--approval-mode`¶

`--yolo`¶

`--sandbox`¶

`--sandbox-image`¶

`--debug`¶

`--show-memory-usage`¶

`--proxy`¶

`--ca-file`¶

`--checkpointing`¶

`--allowed-mcp-server-names`¶

`--extensions`¶

`--list-extensions`¶

`--telemetry`¶

`--telemetry-target`¶

`--telemetry-otlp-endpoint`¶

`--telemetry-log-prompts`¶

`--telemetry-outfile`¶

`--acp`¶

`koda mcp add`¶

`koda mcp remove`¶

`koda mcp list`¶

`koda language set`¶

`koda extensions install`¶

`koda extensions uninstall`¶

`koda extensions list`¶

`koda extensions update`¶

`koda extensions enable`¶

`koda extensions disable`¶

`koda skills list`¶

`koda skills install`¶

`koda skills uninstall`¶

`koda skills enable`¶

`koda skills disable`¶