# エージェント設定

New Agent に表示する CLI を選び、既定値を変更し、独自の起動設定を追加します。

## 1. facade.json を開く

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

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

## 2. 既定値を変更する

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

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

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

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

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

```json
{
  "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](https://facadecode.com/ja/docs/providers/claude-code/) または [Codex](https://facadecode.com/ja/docs/providers/codex/) のガイドに従います。表示の変更方法は[名前とアイコン](https://facadecode.com/ja/docs/appearance/)を参照してください。

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

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

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

現在使用している設定ファイルを開くには **Edit in facade.json** を使用します。各フィールドの定義と既定値は[設定リファレンス](https://facadecode.com/ja/docs/reference/)を参照してください。