> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.


# Установка

```bash
# Глобальная установка
npm install -g @pachca/cli

# Проверка
pachca --version

# Или без установки
npx -y @pachca/cli users list --token YOUR_ACCESS_TOKEN
```

**Если вы в терминале** — ставьте глобально (`npm i -g`): короткая команда `pachca`, автодополнение, авто-проверка обновлений.

**Если подключаете агента** — используйте `npx -y @pachca/cli`: без установки и без шага «настрой окружение». Агент запускает команду сразу, всегда последняя версия, ничего не нужно поддерживать на машине.

> Флаг `-y` обязателен для агентов и CI. При первом запуске (и после каждого нового релиза, так как берётся последняя версия) `npx` скачивает пакет и в современных версиях npm запрашивает подтверждение установки. В неинтерактивной среде без `-y` команда остановится на этом вопросе и не выполнится.


## Автодополнение

CLI поддерживает автодополнение для bash, zsh и PowerShell:

```bash
pachca autocomplete zsh
pachca autocomplete bash
pachca autocomplete powershell
```

Команда выводит инструкцию по установке для выбранного шелла.

## Настройки

Установите постоянные значения по умолчанию:

```bash
# Всегда выводить JSON
pachca config set defaults.output json

# Увеличить таймаут
pachca config set defaults.timeout 60

# Показать все настройки
pachca config list
```

Настройки хранятся в `~/.config/pachca/config.toml`. Флаги команды всегда имеют приоритет над настройками.

## Диагностика

Команда `pachca doctor` проверяет окружение — Node.js, сеть, конфиг, токен и версию CLI:

```bash
pachca doctor

# ✔ Node.js        v20.11.0 (требуется >=20)
# ✔ Сеть           api.pachca.com доступен (142ms)
# ✔ Конфиг         ~/.config/pachca/config.toml (права: 600)
# ✔ Профиль        personal (user: Иван Иванов)
# ✔ Токен          действителен (11 скоупов)
# ✔ CLI            v2026.5.2 (актуальная версия)
```

## Обновление

CLI автоматически проверяет наличие новой версии раз в сутки и показывает уведомление в терминале. Для обновления:

```bash
# Обновить до последней версии
pachca upgrade

# Или вручную через npm
npm install -g @pachca/cli

# Посмотреть, что нового
pachca changelog
```

Отключить автоматическую проверку можно переменной `PACHCA_SKIP_NEW_VERSION_CHECK`.