# トラブルシューティング

問題の原因が起動設定、CLI、モデルプロバイダーのどこにあるかを見分けます。

## 次回の起動設定を確認する

コマンドパレットから **Show Agent Launch** を実行し、作業場所を選択します。レポートには、各 CLI がその場所で現在どのように起動されるか（実行ファイル、ディレクトリ、引数、環境変数名）が表示されます。機密の値は表示されません。

レポートは現在の設定で次に起動する内容を示すもので、すでに実行中のエージェントの内容は示しません。リクエストが成功した場合は、プロバイダーの使用履歴でどのアカウントが処理したかを確認できます。

## 症状から探す

| 問題 | 確認すること |
| --- | --- |
| 設定ファイルが見つからない | Open Settings を選び、Facade: Home の下の Edit in facade.json を選択します。リモートウィンドウで設定が JSON として開く場合、このコマンドは facade.json を直接開きます。 |
| New Agent にエントリーが表示されない | エントリーの名前と `type` を確認し、`enabled: false` で無効になっていないことを確かめます。不正なエントリーは Unavailable に理由付きで表示されます。 |
| 実行ファイルが見つからない | プロジェクトが動作する場所に CLI をインストールするか、`command` にフルパスを設定します。OpenCode はバージョン 2（`@opencode/cli`）を使用してください。 |
| 環境変数の参照が見つからない | エージェントが起動する前に、エディターホストでその変数を利用できる必要があります。既存のターミナルで export してもホストは更新されません。 |
| 引数が Facade の管理するオプションと競合する | `args` からそのオプションを削除します。代わりに `model`、`effort`、またはトップレベルの `yolo` フィールドを使用します。 |
| 認証に失敗する、またはモデルが利用できない | プロバイダーのキー、エンドポイント、リージョン、モデル ID、アカウントのアクセス権を確認します。 |
| Codex のプロバイダーが応答しない | エンドポイントが Responses API に対応していることを確認します。 |
| エージェントが別のエージェントを見つけられない | プロジェクトが同じ Facade ホームで接続され、アクセス設定が通信を許可していることを確認します。 |
| カスタムプログラムがメッセージを受け取らない | そのターミナルで直接入力してください。カスタムエントリーは Facade のメッセージングやツールを受け取りません。 |
| 設定を保存しても実行中のエージェントに反映されない | 新しいエージェントを起動してください。会話を維持する場合は、エージェントを終了してから Resume Agent で新しい設定を使って再起動します。 |

SSH のセットアップについては、[リモートマシンでエージェントを実行する](https://facadecode.com/ja/docs/remote-ssh/)を参照してください。スマートフォン接続のエラーについては、[スマートフォンから作業を続ける](https://facadecode.com/ja/docs/remote-control/)を参照してください。

## 問題を報告する

試したこと、表示されたエラーメッセージの全文、オペレーティングシステム、エディターと拡張機能のバージョン、CLI のバージョン、選択していたエントリーを含めてください。可能であれば、キーや機密の値を除いた関連設定も添えてください。

[GitHub issue を作成する ↗](https://github.com/y5ez3g/facadecode/issues)