Справочное руководство по CLI Pi Agent
Ниже приведён справочник по общим параметрам командной строки Pi Agent.
Параметры режима
Следующие параметры управляют режимом работы Pi Agent. Если они не указаны, по умолчанию открывается интерактивный интерфейс.
| Параметр | Описание | Пример |
|---|---|---|
| (По умолчанию) | Интерактивный режим, терминальный TUI-интерфейс | пи |
| -p, --print | Режим печати, завершает работу после вывода результата | pi -p "summarize code" |
| --mode json | Режим JSON, все события выводятся в виде строк JSON | pi --mode json -p "summarize" |
| --mode rpc | Режим RPC, протокол JSONL через stdin/stdout | pi --mode rpc |
| --export <input> [output] | Экспорт сессии в HTML; путь вывода можно опустить | pi --export abc123 session.html |
Параметры модели
Следующие параметры используются для указания провайдера, модели и уровня рассуждений; подходят для временного переключения без изменения файлов конфигурации.
| Параметр | Описание | Пример |
|---|---|---|
| --provider name | Указать провайдера ИИ | pi --provider anthropic |
| --model pattern | ID модели, поддерживает форматы provider/id и :thinking | pi --model openai/gpt-4o pi --model sonnet:high |
| --api-key key | Передайте API-ключ напрямую, с наивысшим приоритетом; замените значение из примера на свой ключ | pi --api-key sk-ant-api03-xxxx |
| --thinking level | Уровень рассуждений: off/minimal/low/medium/high/xhigh/max | pi --thinking high |
| --models patterns | Список моделей через запятую, ограничивает переключение по Ctrl+P | pi --models "claude-*,gpt-4o" |
| --list-models | Показать список всех доступных моделей | pi --list-models |
Параметры сеанса
Следующие параметры определяют, какой сеанс используется в этом запуске и где сохраняются файлы сеанса.
| Параметр | Описание | Пример |
|---|---|---|
| -c, --continue | Продолжить последнюю сессию | pi -c |
| -r, --resume | Просмотр и выбор исторического сеанса | pi -r |
| --session path|id | 使用指定的会话文件或 UUID | pi --session abc123 |
| --fork path|id | 从指定的会话派生新会话 | pi --fork abc123 |
| --session-dir dir | 自定义会话存储目录;默认目录为 ~/.pi/agent/sessions/,此参数会临时替换它 | pi --session-dir .pi/sessions |
| --no-session | 临时模式,不保存会话 | pi --no-session |
| -n, --name name | Задать отображаемое имя сеанса | pi --name "Рефакторинг модуля аутентификации" |
Параметры инструментов
Следующие параметры управляют доступностью встроенных инструментов и используются для ужесточения разрешений или для чистого общения.
| Параметр | Описание | Пример |
|---|---|---|
| -t, --tools list | Внести указанные инструменты в белый список, через запятую | pi --tools read,bash,edit,write |
| -xt, --exclude-tools list | Отключить указанные инструменты, через запятую | pi --exclude-tools bash |
| -nbt, --no-builtin-tools | Отключить все встроенные инструменты, оставить инструменты расширений | pi --no-builtin-tools |
| -nt, --no-tools | Отключить все инструменты, режим чистой беседы | pi --no-tools |
Параметры ресурсов
Следующие параметры управляют загрузкой расширений, Skills, шаблонов и тем. Параметры с префиксом --no- используются для отключения автообнаружения.
| Параметр | Описание | Пример |
|---|---|---|
| -e, --extension source | Загрузить расширение, можно использовать многократно | pi -e ./my-ext.ts -e npm:@foo/bar |
| --no-extensions | Отключить автообнаружение расширений | pi --no-extensions |
| --skill path | Загрузить навык, можно использовать многократно | pi --skill ./my-skill |
| --no-skills | Отключить автообнаружение навыков | pi --no-skills |
| --prompt-template path | Загрузить шаблон промпта, можно использовать многократно | pi --prompt-template ./review.md |
| --no-prompt-templates | Отключить автообнаружение шаблонов | pi --no-prompt-templates |
| --theme путь | Загрузить тему, можно использовать многократно | pi --theme ./my-theme.json |
| --no-themes | Отключить автообнаружение тем | pi --no-themes |
| -nc, --no-context-files | Отключить загрузку AGENTS.md/CLAUDE.md | pi -nc |
Другие параметры
Следующие параметры переопределяют поведение, такое как системный промпт, доверие к проекту и справочная информация.
| Параметр | Описание | Пример |
|---|---|---|
| --system-prompt текст | Заменить системный промпт по умолчанию | pi --system-prompt "You are a Python expert" |
| --append-system-prompt text | Добавить к системному промпту | pi --append-system-prompt "Reply in Chinese" |
| --tui-mode | Режим интерфейса, например, fullscreen; если не указан, используется обычный режим | pi --tui-mode fullscreen |
| --use-theme | Указать тему для загрузки; действует только для текущего запуска, не изменяет конфигурацию | pi --use-theme "dark-plus" |
| --verbose | Принудительно отображать подробную информацию о запуске | pi --verbose |
| -a, --approve | Доверять локальным файлам проекта для этого запуска | pi -a |
| -na, --no-approve | Не доверять локальным файлам проекта для этого запуска | pi -na |
| -- | Разделитель; содержимое после него передаётся в запрос как есть | pi -- @notes.md Кратко изложи эту заметку |
| -h, --help | Показать справочную информацию | pi -h |
| -v, --version | Показать номер версии | pi -v |
-aи-naВзаимоисключающие; в одном запуске можно указать только один.
Оба ограничены только текущим запуском и не будут записаны в trust.json.
Подкоманды pi
Помимо параметров запуска, pi также предоставляет набор подкоманд для управления пакетами расширений и собственными обновлениями.
| Подкоманда | Описание |
|---|---|
| pi install <source> | Установить пакет расширения; добавьте -l для локальной установки в проект |
| pi remove <source> | Удалить установленный пакет расширения |
| pi uninstall <source> | Псевдоним для remove, тот же эффект |
| pi list | Показать список установленных пакетов расширений |
| pi update | Обновить сам pi и пакеты расширений; поддерживает --self, --all, --models, --extensions, --extension <source> |
| pi config | Включить или отключить различные ресурсы, предоставляемые пакетами расширений |
Связанные переменные среды
Следующие переменные среды влияют на аутентификацию, работу сети и терминала и могут служить дополнительной конфигурацией помимо параметров командной строки.
| Переменная | Назначение | Пример |
|---|---|---|
| ANTHROPIC_API_KEY | Альтернативный способ аутентификации Anthropic; используется, когда вход не выполнен через подписку /login | sk-ant-api03-xxxx |
| HTTP_PROXY / HTTPS_PROXY | Укажите прокси-сервер для запросов API | http://127.0.0.1:7890 |
| NO_PROXY | Белый список прокси; совпавшие хосты не проходят через прокси | localhost,127.0.0.1 |
| COLORTERM | Одно из эталонных значений для автоопределения truecolor; если определение не удалось, используйте PI_TRUE_COLOR=1 для принудительного включения или настройте terminal.trueColor | truecolor |
Для прокси, требующих длительного использования, рекомендуется прописать в~/.pi/agent/settings.jsonзначениеhttpProxy。
Эта конфигурация действует только в глобальном файле конфигурации; запись её на уровне проекта.pi/settings.jsonнедействительна.
Аргументы файлов
Использование@Префикс для обращения к файлам:
$ pi @prompt.md "回答这个问题" $ pi -p @screenshot.png "图中有什么" $ pi @src/code.ts @src/test.ts "对比这两个文件"
Взяв вторую команду в качестве примера, вывод будет похож на:
The image is a screenshot of a login page, which includes a username input field, a password input field, and a login button.Другие расширения