> ## 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 のプレフィックスを付けたままにするか、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` は npm の一時キャッシュから CLI を実行し、**`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="キーをコピーする">
    [tokenページ](https://api.apiyi.com/token)を開き、`sk-`で始まるtokenをコピーします。tokenがない場合は、先に作成してください。
  </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`を実行します。`ok`の`status`が表示されれば、キーが有効でノードに接続できています。
  </Step>

  <Step title="最初のメッセージを送信する">
    `npx apiyi@latest chat "Hello" -m gpt-5.4-mini`を実行します。返信とtoken使用量が表示されれば、すべて正常に動作しています。
  </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` 内で設定）、新しいターミナルを開いてください。nvm で Node を管理している場合、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`。[個人用アクセストークンとは？](/ja/faq/personal-access-token)をご覧ください。
  </Accordion>
</AccordionGroup>

## 関連ドキュメント

<CardGroup cols={2}>
  <Card title="AI開発キット · CLI" icon="terminal" href="/ja/developer-kit#cli">
    すべてのコマンド、キーの検索順序、終了コード
  </Card>

  <Card title="APIキーが無効な場合はどうすればよいですか？" icon="key" href="/ja/faq/invalid-api-key">
    `check`がinvalid\_keyを返す場合にお読みください
  </Card>
</CardGroup>


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