에이전트 설정

1. facade.json 열기#

1. Facade 패널의 … 메뉴를 열고 Open Settings를 선택합니다. 명령 팔레트에서도 찾을 수 있습니다.
2. Facade: Home에서 Edit in facade.json을 선택합니다. 원격 창에서 Settings가 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. 다른 구성 추가#

codex 같은 기본 제공 ID를 사용해 해당 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 Settings의 Facade: Home 설정은 facade.json이 있는 폴더를 지정합니다. 명시적으로 지정한 값이 있으면 이를 사용하고, 그렇지 않으면 FACADE_HOME, 그다음 ~/.facade를 사용합니다. 홈을 변경한 뒤에는 Facade가 표시하는 창 다시 로드 안내를 따르십시오.

활성 파일을 열려면 Edit in facade.json을 사용하십시오. 필드 정의와 기본값은 구성 참고 자료를 참조하십시오.