Facade Code구성 참고 자료
facade.json의 필드와 기본값, Facade가 이를 적용하는 방식을 찾아봅니다.
최상위 필드
에이전트 설정을 통해 파일을 여십시오. JSON 주석과 후행 쉼표를 사용할 수 있습니다. 빈 객체는 기본값을 사용합니다.
| 필드 | 값 | 기본값 |
|---|---|---|
yolo | CLI 승인과 에이전트 액세스를 제어하는 부울. | true |
names | 에이전트 이름 제안 목록. 각 이름은 비어 있지 않아야 함. | 기본 제공 이름 목록 |
clis | 기본 제공 항목의 재정의와 추가로 이름을 지정한 항목을 담는 객체. | {}; 기본 제공 CLI는 계속 사용 가능 |
$schema | 편집기 스키마 메타데이터용 문자열. | 생략됨 |
CLI 항목 필드
| 필드 | 값 | 기본값 |
|---|---|---|
type | claude, codex, agy, muse, opencode, pi 또는 custom. | 정확한 기본 제공 ID에는 자동 적용, 추가 항목에는 필수. |
command | 실행 파일 이름 또는 경로 하나. | 유형에 맞는 PATH 명령이며 custom에는 필수. |
args | 리터럴 인수 문자열 배열. | [] |
env | 문자열 또는 null에 매핑된 변수 이름. | {} |
model | 비어 있지 않은 모델 ID. | CLI가 결정하며 OpenCode 또는 custom에는 사용할 수 없음. |
effort | CLI와 모델이 지원하는 비어 있지 않은 effort. | CLI가 결정하며 OpenCode 또는 custom에는 사용할 수 없음. |
enabled | 이후 시작과 복원 허용 여부를 제어하는 부울. | true |
icon | 기본 제공 CLI ID 또는 지원되는 로봇 아이콘. | 유형별 아이콘이며 custom은 facade-pearl. |
기본 제공 항목을 구성하려면 codex처럼 정확한 소문자 ID를 사용하십시오. 새 항목의 이름은 대소문자를 구분하지 않더라도 모든 기본 제공 ID 및 표시 이름과 달라야 합니다. 예를 들어 Codex 대신 Codex · work를 사용하십시오. 추가한 항목은 같은 유형의 기본 제공 항목 설정을 상속하지 않습니다.
enabled: false는 유효한 항목을 숨기고 이후 시작이나 복원을 거부합니다. 이미 실행 중인 에이전트는 중지하지 않습니다.
환경 값
{
"clis": {
"codex": {
"env": {
"WORK_API_KEY": "${env:WORK_API_KEY}",
"OLD_TOKEN": null
}
}
}
}- 문자열은 변수를 설정합니다.
null은 변수를 제거합니다. 생략한 변수는 상속됩니다. ${env:NAME}은 편집기 호스트의 환경을 읽습니다. 같은 객체의 다른 키는 읽지 않습니다.- 참조한 환경 변수가 없으면 해당 항목을 사용할 수 없습니다. 참조는
env값에서 한 번만 확장되며args에서는 확장되지 않습니다. - 리터럴 값은 facade.json에 남습니다. 환경 참조를 사용하면 그 값이 파일에 남지 않지만 CLI는 확장된 값을 받습니다.
이미 열려 있는 통합 터미널에서 변수를 설정해도 편집기 호스트 환경은 업데이트되지 않습니다. 편집기를 시작하기 전에 변수를 사용할 수 있게 하십시오.
우선순위 및 시작 옵션
Facade는 먼저 새 에이전트에 지정된 모델과 effort를 사용하고, 그다음 항목의 기본값을 사용합니다. 둘 다 값을 제공하지 않으면 CLI가 결정합니다. OpenCode는 두 선택을 자체 구성에서 관리합니다.
기본 제공 유형에는 모델과 effort 전용 필드를 사용하십시오. Facade는 권한, 대화 ID, 작업 폴더, 자체 도구도 설정합니다. 이러한 선택과 충돌하거나 대화형 세션 시작을 막는 인수는 거부합니다.
Facade는 Facade 홈에서 facade.json을 찾습니다. VS Code 설정의 Facade: Home이 있으면 그 값을, 없으면 FACADE_HOME, 그다음 ~/.facade를 사용합니다. 프로젝트에서 Open Settings를 열면 활성 파일을 확인할 수 있습니다.
파일 오류 및 항목 오류
잘못된 JSON, 중복 키, 알 수 없는 최상위 필드 같은 파일 수준 오류는 새 시작과 복원을 막습니다. CLI 항목 하나의 오류는 해당 항목만 사용할 수 없게 합니다. 실행 중인 에이전트는 계속 실행됩니다.
오류에 표시된 설정 경로를 확인하고 해당 값을 수정하십시오. Facade가 이전 설정으로 조용히 대체하지는 않습니다. 일반적인 시작 및 제공자 오류는 문제 해결을 참조하십시오.