> For the complete documentation index, see [llms.txt](https://mitsu-1.gitbook.io/vrc-ai-companion/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mitsu-1.gitbook.io/vrc-ai-companion/ttatoki/troubleshooting.md).

# 困ったとき

> **まず「アプリ」→「再起動」を実施してください**
>
> マイクが認識しない、機能が動作しない・設定変更や更新が反映されない場合は、画面上部の **「アプリ」→「再起動」** を実施してください。再起動後、もう一度動作を確認してください。

> **アプリ起動直後の返答について**
>
> アプリ起動直後は応答が遅く、返答までに時間がかかる場合があります。すぐに返答がないときは、少し待ってから再度話しかけてください。

**文字入力 → マイク → VRChat表示** の順に確かめると、問題の場所を絞り込めます。

## 文字を入力しても返答がない

1. 「AI の設定」の「まとめて切り替え」で、使う提供元とモデルを選んだか確認する。
2. クラウドAIなら、対応する提供元の利用キーが「設定済み」か確認する。
3. 提供元の管理画面で、残高・利用上限・キーの有効期限を確認する。
4. Ollamaなら、本体が起動していてモデルがダウンロード済みか確認する。
5. 「動作記録」に出ているエラーを確認する。

| エラーの目安       | 確認すること                                  |
| ------------ | --------------------------------------- |
| 401 / 認証に失敗  | キーの入力漏れ、無効化、期限切れ、提供元の取り違え               |
| 403 / 利用できない | アカウント・地域・プロジェクト・モデルの権限                  |
| 404 / モデルがない | APIで利用できる正式なモデルID。Webチャット上の呼び名と同じとは限らない |
| 429 / 制限     | 短時間の回数制限、割り当て、残高や利用上限。本文と提供元画面を確認       |
| 時間切れ / 接続失敗  | ネット接続、提供元の障害、ローカルAIの起動・負荷               |

エラー番号だけで原因が確定するわけではありません。連続して再送せず、表示内容を確認してください。

## 返答はあるが、会話がかみ合わない

会話の自然さ・文脈の理解・返答の正確さは、使用するAIサービスやモデルによって大きく異なります。同じサービスでもモデルによって差があります。 まず同じ内容を文字で入力し、音声認識の聞き間違いが原因かを切り分けます。 文字入力でも意図と違う返答になる場合は、「AI の設定」の会話用モデルと、名前・性格などの設定を確認してください。 [AIによる会話品質の違い](/vrc-ai-companion/aiwosuru/ai.md)を参照してください。

## 文字では返答するが、マイクでは返答しない

1. 「音声 / 出力」で自分のマイクがオンか確認する。
2. 「マイクと音声」でマイクを再スキャンし、目的の入力デバイスを選ぶ。
3. 「入力をテスト」で音が取得できるか確認し、「保存する」を押す。
4. 認識モデルの準備が終わっているか確認する。
5. AIが返答し終わってから、短い一文を話す。

入力テストが失敗する場合は、Windowsのマイク許可、機器の接続、別アプリによる占有を確認します。 接続先を変えた場合は「再接続」を試してください。[詳しいマイク設定](/vrc-ai-companion/tovrchat/microphone.md)

## マイクが重複して見える／未導入のモデルが候補にある

同じマイクへの接続方式や名前の省略が原因で、似た候補が並ぶ場合があります。 「マイクを再スキャン」の後に普段使う機器を選び、「入力をテスト」で確認してください。[候補の見分け方](/vrc-ai-companion/tovrchat/microphone.md)

配布識別「2026-09-18-ui-fixes」以降の版では、確認できた導入済みモデルを候補に表示します。Ollama起動・モデル導入後に「導入済みモデルを再確認」を押してください。 旧版では、候補名が表示されていても導入完了を意味しない場合があります。 「AI を選ぶ」でモデルの導入を確認してください。初回セットアップ中なら、スキップしてから導入できます。 [ローカルAIの準備](/vrc-ai-companion/aiwosuru/ollama.md)

## 意図と違う文章になる

マイクとの距離を一定にし、BGMや別アプリの音を減らします。 一度に長く話すより、一文ずつ間を空けて試してください。 AI補正をオンにしている場合は、オフにして原文と比較します。 [認識方式の選び方](/vrc-ai-companion/tovrchat/models.md)

## 周囲の声を拾わない／音楽にも返答する

VRChatの再生先と取り込みデバイスを合わせます。Windowsの再生音を拾うため、他アプリの音も対象になる場合があります。 音楽を止め、一人ずつ話して試してください。返答が多い場合は[反応設定](/vrc-ai-companion/niwaseru/responses.md)を変更します。

## アプリには返答が出るが、VRChatに表示されない

VRChat側のOSC、VACの「VRChat に送る」、表示先が「表示しない」になっていないかを確認します。 文字盤を使う場合は、先に標準チャットボックスで動作を確認してください。 [VRChatの設定手順](/vrc-ai-companion/tovrchat/vrchat.md)

## モデル取得が止まる／遅い

ネット接続と空き容量を確認します。GPU用部品の取得なら「CPUで続ける」を選べます。 音声認識モデルそのものは、認識に必要です。CPUに切り替えても認識モデルの取得が不要になるわけではありません。

## 閉じても動いている／起動しても画面がない

通知領域（タスクトレイ）のVACアイコンを確認してください。 終了は「アプリ → 終了」、再起動は「アプリ → 再起動」を使います。

## 解決しない場合

![動作記録の画面。送る前に個人情報や秘密情報が含まれないか確認します。](https://2281629983-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWzAawsJRGrYYDbrjl4uR%2Fuploads%2Fgit-blob-c51f2aa626bdd96827e44cea0926c07f1d513d1e%2Flogs.png?alt=media)

アプリの版・Windowsの版・操作手順・エラーの内容をまとめ、[お問い合わせ](/vrc-ai-companion/ttatoki/support.md)へ進んでください。 APIキーやアプリフォルダ全体を送る必要はありません。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://mitsu-1.gitbook.io/vrc-ai-companion/ttatoki/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.