Cài đặt agent

1. Mở facade.json#

1. Mở menu … của bảng điều khiển Facade và chọn Open Settings. Bạn cũng có thể tìm lệnh này trong Command Palette.
2. Trong Facade: Home, chọn Edit in facade.json. Nếu cửa sổ từ xa mở Settings dưới dạng JSON, lệnh sẽ mở thẳng facade.json.
3. Sửa tệp và lưu. Facade chấp nhận chú thích JSON và dấu phẩy ở cuối.

Vị trí mặc định là ~/.facade/facade.json. Nếu tệp chưa tồn tại, Facade tạo tệp mới có chú thích, các mục CLI tích hợp và ví dụ để bạn sửa theo. Facade không ghi đè tệp đã có.

2. Thay đổi một giá trị mặc định#

Ví dụ sau đặt mức effort mặc định của Codex thành high và loại Pi khỏi New Agent. Hãy thêm các trường này vào tệp hiện có, giữ lại những mục khác bạn đang dùng:

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

Lưu tệp rồi khởi chạy agent mới. Các agent đang chạy giữ nguyên cài đặt khởi chạy; agent được khôi phục và agent đã ghim sẽ đọc tệp hiện tại ở lần khởi chạy tiếp theo.

3. Thêm một cấu hình khác#

Dùng ID tích hợp như codex để thay đổi mặc định của CLI đó, hoặc dùng một tên mới để thêm cấu hình riêng:

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

Thay YOUR_MODEL_ID bằng một mô hình mà cấu hình Codex của bạn hỗ trợ. Lưu lại, rồi chọn Codex · review trong New Agent để dùng cấu hình này. Trường type giữ lại tích hợp Facade của Codex, còn tên dùng để nhận diện cấu hình.

Mục mới không kế thừa cài đặt từ codex. Hãy thêm đối số, biến môi trường hoặc đường dẫn tệp thực thi riêng khi cần. Để kết nối một API khác, hãy làm theo hướng dẫn Claude Code hoặc Codex. Xem Tên và biểu tượng để đổi cách hiển thị.

Dùng cài đặt cho đúng máy#

Các dự án cục bộ dùng chung một Facade home sẽ chia sẻ cài đặt trong đó. Dự án SSH, WSL và container đọc tệp trong môi trường thực thi của chính chúng. Hãy mở Settings từ dự án bạn muốn cấu hình.

Cài đặt Facade: Home trong VS Code Settings chọn thư mục chứa facade.json. Nếu được đặt, cài đặt này được ưu tiên hơn FACADE_HOME; biến này lại được ưu tiên hơn ~/.facade. Sau khi đổi home, hãy chấp nhận lời nhắc tải lại cửa sổ của Facade.

Dùng Edit in facade.json để mở đúng tệp đang có hiệu lực. Về định nghĩa trường và giá trị mặc định, xem tham chiếu cấu hình.