Документация

Pi

Подключите терминального агента Pi к четырём моделям через airaw.

1. Установите Pi

Нужен Node.js 22.19 или новее. Поставьте текущий официальный пакет:

npm install -g @earendil-works/[email protected]

Пакет @mariozechner/pi-coding-agent помечен устаревшим; новые версии выходят в пространстве @earendil-works.

2. Добавьте провайдера

Откройте ~/.pi/agent/models.json и добавьте airaw в providers, сохранив остальные записи. Ниже полный документ:

{
        "$schema": "https://pi.dev/schemas/models.schema.json",
        "providers": {
        "airaw": {
        "name": "airaw",
        "baseUrl": "/v1",
        "api": "openai-completions",
        "models": [
        {
        "id": "glm-5.3",
        "name": "GLM 5.3",
        "contextWindow": 1048576,
        "maxTokens": 131072
        },
        {
        "id": "deepseek-v4.1-flash",
        "name": "DeepSeek V4.1 Flash 1017",
        "contextWindow": 1000000,
        "maxTokens": 393216
        },
        {
        "id": "kimi-k3",
        "name": "Kimi K3",
        "contextWindow": 1048576,
        "maxTokens": 1048576
        },
        {
        "id": "qwen3.8-max-0902",
        "name": "Qwen 3.8 Max",
        "contextWindow": 1000000,
        "maxTokens": 131072
        }
        ]
        }
        }
        }

3. Сохраните ключ и выберите модель

Получите ключ на странице активации. В штатном хранилище ~/.pi/agent/auth.json добавьте только запись airaw. Замените YOUR_AIRAW_KEY своим ключом; чужие записи не удаляйте:

{
        "airaw": {
        "type": "api_key",
        "key": "YOUR_AIRAW_KEY"
        }
        }

Ключ хранится локально, а не в models.json. Не публикуйте auth.json и не добавляйте его в проект.

В ~/.pi/agent/settings.json добавьте выбор модели, сохранив остальные настройки:

{
        "defaultProvider": "airaw",
        "defaultModel": "glm-5.3"
        }

Для другой модели замените glm-5.3 одним из идентификаторов из models.json.

4. Проверьте подключение

Перезапустите клиент и проверьте ключ без его вывода, затем отправьте задачу:

pi auth check --provider airaw --json
        pi

Расход появится в кабинете. Скрипты настройки не требуют оболочки Git Bash для чтения ключа.

Если не подключается

• not_ready или 401 — проверьте запись airaw в auth.json и вставьте ключ целиком.
• 404 — базовый адрес должен оканчиваться на /v1, протокол должен хранить openai-completions.
• Если задан PI_CODING_AGENT_DIR, все три файла должны лежать в этой папке, а не в ~/.pi/agent.

Сверяйте параметры с официальной справкой Pi и схемой моделей.