> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Почему терминал сообщает, что команда apiyi не найдена?

> Команда npx apiyi@latest запускает CLI без установки, поэтому после этого команда apiyi недоступна. Используйте префикс npx apiyi@latest или установите CLI один раз с помощью npm i -g apiyi.

## Краткий ответ

`npx apiyi@latest` **загружает CLI, запускает его один раз и не оставляет после себя никаких файлов**, поэтому команда `apiyi` не добавляется в вашу систему. Для каждой последующей команды требуется полный префикс `npx apiyi@latest …`, например, чтобы сохранить свой ключ:

```bash theme={null}
npx apiyi@latest auth set-key
```

Если отныне вы хотите вводить просто `apiyi`, установите его глобально один раз: `npm i -g apiyi`.

## Симптом

При первой самопроверке сообщается, что ключ отсутствует, а команда из подсказки завершается с ошибкой:

```text theme={null}
% npx apiyi@latest check
status:   no_key
node:     api.apiyi.com
hint:     No API key found. Copy one at https://api.apiyi.com/token, then run "apiyi auth set-key" or export APIYI_API_KEY.

% apiyi auth set-key
zsh: command not found: apiyi
```

В Windows формулировка отличается (например, «термин apiyi не распознан как имя командлета»), но причина та же.

## Причина

`npx` запускает CLI из временного кэша npm и **не добавляет `apiyi` в ваш PATH**. В версии 0.2.1 и более ранних версиях в подсказке использовалась краткая форма `apiyi auth set-key`, поэтому её копирование приводило непосредственно к этой ошибке.

Начиная с **0.2.2**, CLI определяет, когда он запускается через `npx`, и выводит в подсказках полную форму `npx apiyi@latest auth set-key`; `--help` также содержит это объяснение.

## Исправление

<Tabs>
  <Tab title="Продолжайте использовать npx (рекомендуется, ничего устанавливать не нужно)">
    Добавляйте `npx apiyi@latest` перед каждой командой. Вы всегда получаете последнюю версию, и на вашем компьютере ничего не остаётся:

    ```bash theme={null}
    npx apiyi@latest auth set-key
    npx apiyi@latest check
    npx apiyi@latest chat "Hello" -m gpt-5.4-mini
    ```
  </Tab>

  <Tab title="Установите глобально один раз">
    После установки команда `apiyi` работает без префикса:

    ```bash theme={null}
    npm i -g apiyi
    apiyi auth set-key
    apiyi check
    ```

    Чтобы обновить позже: `npm i -g apiyi@latest`.
  </Tab>

  <Tab title="Используйте переменную окружения">
    Настройки не сохраняются в файле конфигурации; они действуют только в текущем терминале:

    ```bash theme={null}
    export APIYI_API_KEY=sk-your-apiyi-key
    npx apiyi@latest check
    ```

    Чтобы сохранить настройку, добавьте строку `export` в `~/.zshrc` (или `~/.bashrc`).
  </Tab>
</Tabs>

## Первоначальная настройка: пошаговая инструкция

<Steps>
  <Step title="Скопируйте ключ">
    Откройте [страницу токенов](https://api.apiyi.com/token) и скопируйте token, начинающийся с `sk-`; если у вас его нет, сначала создайте.
  </Step>

  <Step title="Сохраните ключ">
    Выполните `npx apiyi@latest auth set-key`. Когда появится `API key (input hidden):`, вставьте ключ и нажмите Enter.
    Во время ввода или вставки на экране ничего не отображается. Это сделано намеренно, чтобы никто не мог подсмотреть ваш ключ.
    `Saved apiKey to ~/.config/apiyi/config.json (mode 0600)` означает, что всё прошло успешно.
  </Step>

  <Step title="Проверьте ещё раз">
    Выполните `npx apiyi@latest check`. `status` со значением `ok` означает, что ключ действителен и узел доступен.
  </Step>

  <Step title="Отправьте первое сообщение">
    Выполните `npx apiyi@latest chat "Hello" -m gpt-5.4-mini`. Если вы получили ответ и видите расход tokens, значит, всё работает.
  </Step>
</Steps>

## Частые вопросы

<AccordionGroup>
  <Accordion title="После вставки ключа на экране ничего не происходит. Он вставился?">
    Ввод скрыт; после вставки просто нажмите Enter. Чтобы убедиться, выполните `npx apiyi@latest auth show` — команда выведет сохранённый ключ в замаскированном виде.
  </Accordion>

  <Accordion title="Я выполнил npm i -g apiyi, но команда всё равно не найдена">
    Глобальный каталог npm не добавлен в PATH. Выполните `npm prefix -g`, чтобы узнать его расположение, добавьте его подкаталог `bin` в PATH (в `~/.zshrc`), затем откройте новый терминал. Если вы управляете Node с помощью nvm, при смене версии Node также потребуется повторно выполнить глобальную установку для новой версии.
  </Accordion>

  <Accordion title="Где хранится ключ и как его удалить?">
    В `~/.config/apiyi/config.json`, с правами доступа к файлу 0600, поэтому прочитать его можете только вы. Удалите его с помощью `npx apiyi@latest auth clear`.
  </Accordion>

  <Accordion title="Сообщение говорит, что моя версия Node устарела">
    Для CLI требуется Node версии 18.17 или новее. Выполните `node -v`, чтобы проверить версию, и обновите Node, если она старше.
  </Accordion>

  <Accordion title="При проверке баланса также появляется сообщение no_key или permission denied">
    Обычный ключ `sk-` не может читать данные о балансе. Для просмотра баланса нужен персональный токен доступа (начинается с `nap_`): `npx apiyi@latest auth set-key --access-token`. См. раздел [Что такое персональный токен доступа?](/ru/faq/personal-access-token)
  </Accordion>
</AccordionGroup>

## Связанные документы

<CardGroup cols={2}>
  <Card title="Набор разработчика AI · CLI" icon="terminal" href="/ru/developer-kit#cli">
    Все команды, порядок поиска ключа и коды завершения
  </Card>

  <Card title="Что делать, если мой API-ключ недействителен?" icon="key" href="/ru/faq/invalid-api-key">
    Прочитайте это, если `check` возвращает invalid\_key
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.