Facade Codeリファレンス
トラブルシューティング
問題の原因が起動設定、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 のセットアップについては、リモートマシンでエージェントを実行するを参照してください。スマートフォン接続のエラーについては、スマートフォンから作業を続けるを参照してください。
問題を報告する
試したこと、表示されたエラーメッセージの全文、オペレーティングシステム、エディターと拡張機能のバージョン、CLI のバージョン、選択していたエントリーを含めてください。可能であれば、キーや機密の値を除いた関連設定も添えてください。
Markdown で表示 ↗ドキュメント