エージェント設定

1. facade.json を開く#

1. Facade パネルの … メニューを開き、Open Settings を選択します。コマンドパレットからも実行できます。
2. Facade: Home の下にある Edit in facade.json を選択します。リモートウィンドウで設定が JSON として開く場合、このコマンドは facade.json を直接開きます。
3. ファイルを編集して保存します。Facade は JSON のコメントと末尾のカンマを受け付けます。

既定の場所は ~/.facade/facade.json です。ファイルが存在しない場合、Facade はコメント、組み込み CLI のエントリー、編集して使える例を含むファイルを作成します。既存のファイルが書き換えられることはありません。

2. 既定値を変更する#

たとえば、次の設定では Codex の既定の effort を high にし、New Agent の選択肢から Pi を外します。使用している他のエントリーを残したまま、これらのフィールドを既存のファイルに追加してください。

{
  "clis": {
    "codex": {
      "effort": "high"
    },
    "pi": {
      "enabled": false
    }
  }
}

保存してから新しいエージェントを起動します。実行中のエージェントは起動時の設定を維持し、再開したエージェントとピン留めしたエージェントは次回の起動時に現在のファイルを使用します。

3. 別の設定を追加する#

組み込み ID（codex など）を使えばその CLI の既定値を変更でき、新しい名前を付ければ別の起動設定を追加できます。

{
  "clis": {
    "Codex · review": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "effort": "high"
    }
  }
}

YOUR_MODEL_ID は、お使いの Codex 環境でサポートされているモデルに置き換えます。保存してから New Agent で Codex · review を選ぶと、この設定を使用できます。type は Codex の Facade 統合を維持し、名前はこの起動設定を識別します。

新しいエントリーは codex の設定を継承しません。必要に応じて、独自の引数、環境変数、実行ファイルのパスを追加してください。別の API に接続するには、Claude Code または Codex のガイドに従います。表示の変更方法は名前とアイコンを参照してください。

適切なマシンの設定を使う#

同じ Facade ホームを使うローカルプロジェクトは、その設定を共有します。SSH、WSL、コンテナーのプロジェクトは、それぞれの実行環境にあるファイルを読み込みます。設定したいプロジェクトから Open Settings を開いてください。

VS Code の設定にある Facade: Home は、facade.json を含むフォルダーを指定します。明示的に指定した値は FACADE_HOME より優先されます。FACADE_HOME も設定されていなければ、~/.facade が使われます。ホームを変更したら、Facade のプロンプトに従ってウィンドウを再読み込みしてください。

現在使用している設定ファイルを開くには Edit in facade.json を使用します。各フィールドの定義と既定値は設定リファレンスを参照してください。