# 문제 해결

문제가 실행 구성, CLI, 모델 제공자 중 어디에서 비롯되었는지 확인합니다.

## 요청된 시작 구성 확인

명령 팔레트에서 **Show Agent Launch**를 실행하고 작업 위치를 선택하십시오. 보고서에는 현재 설정으로 각 CLI를 해당 위치에서 시작할 때 사용할 실행 파일, 디렉터리, 인수, 환경 변수 이름이 표시됩니다. 비공개 값은 가려집니다.

이 보고서는 현재 설정으로 수행할 다음 시작을 설명합니다. 이미 실행 중인 에이전트는 설명하지 않습니다. 요청이 성공했다면 제공자의 사용량 기록에서 어떤 계정이 처리했는지 확인할 수 있습니다.

## 증상 찾기

| 문제 | 확인할 사항 |
| --- | --- |
| 설정 파일을 찾을 수 없음 | Open Settings를 선택한 다음 Facade: Home 아래의 Edit in facade.json을 선택합니다. 원격 창에서 Settings가 JSON으로 열리면 이 명령이 facade.json을 바로 엽니다. |
| New Agent에 항목이 없음 | 항목의 이름과 `type`을 확인하고 `enabled: false`로 비활성화되지 않았는지 확인합니다. 유효하지 않은 항목은 Unavailable 아래에 이유와 함께 표시됩니다. |
| 실행 파일을 찾을 수 없음 | 프로젝트가 실행되는 위치에 CLI를 설치하거나 `command`에 전체 경로를 설정합니다. OpenCode는 버전 2(`@opencode/cli`)를 사용합니다. |
| 환경 변수 참조를 찾을 수 없음 | 에이전트를 시작하기 전에 편집기 호스트에 해당 변수가 있어야 합니다. 이미 열린 터미널에서 내보내도 호스트는 업데이트되지 않습니다. |
| 인수가 Facade가 관리하는 옵션과 충돌함 | `args`에서 해당 옵션을 제거합니다. 대신 `model`, `effort` 또는 최상위 `yolo` 필드를 사용합니다. |
| 인증에 실패하거나 모델을 사용할 수 없음 | 제공자의 키, 엔드포인트, 리전, 모델 ID, 계정 액세스를 확인합니다. |
| Codex 제공자가 응답하지 않음 | 해당 엔드포인트가 Responses API를 지원하는지 확인합니다. |
| 에이전트가 다른 에이전트를 찾지 못함 | 두 프로젝트가 같은 Facade 홈을 통해 연결되어 있고 액세스 설정이 통신을 허용하는지 확인합니다. |
| 사용자 지정 프로그램이 메시지를 받지 못함 | 해당 터미널에 직접 입력합니다. 사용자 지정 항목은 Facade 메시징이나 도구를 받지 않습니다. |
| 저장한 설정이 실행 중인 에이전트에 적용되지 않음 | 새 에이전트를 시작합니다. 대화를 유지하려면 에이전트를 종료한 뒤 Resume Agent로 새 설정을 적용해 다시 시작합니다. |

SSH 설정은 [원격 머신에서 에이전트 실행](https://facadecode.com/ko/docs/remote-ssh/)을, 휴대폰 연결 오류는 [휴대폰에서 이어서 작업](https://facadecode.com/ko/docs/remote-control/)을 참조하십시오.

## 문제 보고

시도한 내용, 정확한 오류 메시지, 운영 체제, 편집기 및 확장 프로그램 버전, CLI 버전, 선택한 항목을 포함하십시오. 가능하면 키와 비공개 값을 제거한 관련 설정도 함께 보내십시오.

[GitHub 이슈 열기 ↗](https://github.com/y5ez3g/facadecode/issues)