문제 해결

막혔을 때 화면에 나온 문구를 아래 표의 「증상」 칸에서 찾으세요. 증상 칸의 글자는 앱 소스의 한국어를 그대로 옮긴 것이고, <…> 는 상황마다 달라지는 자리입니다. 이 쪽의 증상 문구는 2026-10-08 에 내려받을 수 있던 0.1.0 의 소스에도 같은 글자로 있습니다. 증상마다 자세한 설명이 있는 쪽을 함께 달았습니다.

먼저 해 볼 것

1. 카드나 배너의 글을 끝까지 읽습니다. 앱의 안내는 대부분 원인과 할 일을 한 문장으로 말합니다.
2. 「설정」 › 「빌더」에서 「다시 확인」을 누릅니다. cob · 빌더 기계 API · bricks · 레시피 카탈로그가 갖춰졌는지 한 번에 보여 줍니다(빌더).
3. 터미널에서 <명령> --version 이 되는지 확인합니다. 앱이 찾는 도구가 컴퓨터에 있는지 가리는 가장 빠른 길입니다(준비물).
4. 계획을 실행하다 멈췄다면 아래쪽 「디버그 로그」를 봅니다. 실행하는 동안 cob 가 낸 출력이 담겨 있습니다(코드 모드).

채팅이 계획을 세우지 못할 때

요구를 보냈는데 계획 카드 대신 안내가 나오는 경우입니다. 「빌더가 멈췄습니다」 카드의 글이 원인을 말하고, 설정을 가리키는 글이면 「설정 열기」 단추가 함께 나옵니다. 같은 요구를 다시 보내려면 「다시 시도」를 누릅니다(조립 계획 읽기).

연결 확인 단추가 보여 주는 결과 줄(「키가 거부되었습니다 — 키를 확인하세요 (HTTP 401)」 등)의 뜻은 AI 공급자에 표로 있습니다.

cob 와 bricks

프로젝트를 조립하는 cob 가 준비되지 않았을 때입니다. 같은 문제가 채팅에는 카드로, 「설정」 › 「빌더」에는 한 줄로 나옵니다. 설치 · 갱신 명령은 앱이 보여 주는 것을 복사해 쓰세요. 이 쪽은 그 명령을 적지 않습니다.

각 안내의 화면과 준비 방법은 빌더, 준비물에 있습니다.

실행이 멈췄을 때

「확인하고 실행」 뒤에 실행 카드의 빨간 상자가 나오는 경우입니다. 제목 「<단계>에서 멈췄습니다」가 멈춘 단계를, 아래의 글이 cob 가 남긴 사유를 알려 줍니다. 상자 읽는 법과 단계별로 다시 돌리는 방법은 실행 결과와 게시에 있습니다.

꼬리표 「도구 없음」 · 「인증」 · 「네트워크」

빨간 상자 제목 오른쪽에 작은 꼬리표가 붙을 수 있습니다. 이 꼬리표는 들어 있는 글자를 세어 붙이는 추정입니다. 앱이 이 컴퓨터 안에서 실패 요약 · cob 가 남긴 사유 · 출력 꼬리에 아래 글자 가운데 몇 개가 들어 있는지 세어 가장 많이 맞는 쪽을 붙입니다(auth · network 처럼 꼬리표 이름과 겹치는 글자는 두 번 세고, 비기면 도구 없음 → 인증 → 네트워크 순입니다). 어느 쪽에도 맞지 않으면 꼬리표를 달지 않습니다. 그때 「설정」의 「빠른 판단 (Jev)」 키가 있으면 실패 요약 한 줄만 Jev 에 보내 묻습니다.

글자만 보는 추정이라 틀릴 수 있습니다. 꼬리표보다 사유를 먼저 읽으세요.

정책 프록시가 막은 호스트

실행 카드 빨간 상자 맨 아래의 「정책 프록시가 막은 호스트: …」는, 빌더가 띄운 cob 가 샌드박스의 허용 목록에 없는 호스트로 접속하려다 정책 프록시에 막혔다는 뜻입니다. 멈춘 실행 카드에는 그 실행이 시작된 뒤 막힌 호스트만 담깁니다.

• 이 줄이 보인다고 곧 그것이 실패의 원인이라는 뜻은 아닙니다. 사유와 함께 읽으세요.
• 이 줄이 없다고 호스트 문제가 아니라는 뜻도 아닙니다. 프록시 환경 변수를 읽지 않는 도구(Gradle 이 그렇습니다)는 프록시를 거치지 않아 막힌 호스트로 잡히지 않습니다.
• 허용 목록은 앱에서 고칠 수 없습니다. 사람이 터미널에서 직접 실행하는 도구는 이 목록의 영향을 받지 않습니다.

코드 모드와 프리뷰

「▶」 실행, 프리뷰, 터미널, 소스 제어에서 만나는 증상입니다.

터미널에서는 되는데 앱에서는 안 될 때

앱이 도구를 찾는 환경은 터미널과 같지 않을 수 있습니다.

• PATH: macOS · Linux 에서는 앱이 시작할 때 로그인 셸의 PATH 를 한 번 읽어 오고, 5초 안에 끝나지 않으면 앱이 받은 PATH 를 그대로 씁니다. Windows 에서는 앱이 시작된 환경의 PATH 를 씁니다. 셸 프로필(.zshrc 등)을 고쳤다면 앱을 다시 실행하세요(준비물).
• 환경 변수: 터미널과 「▶」 실행은 PATH · HOME · LANG · 임시 폴더 · 프록시 변수 같은 허용 목록의 변수만 넘기고, ANTHROPIC_API_KEY 같은 키 환경 변수는 넘기지 않습니다. 그래서 설정 화면이 읽는 키가 터미널 안에서는 보이지 않을 수 있습니다(코드 모드).

이 표에 없을 때

• 카드나 배너의 글을 그대로 복사해 두세요. 이 쪽의 증상 칸과 글자가 같은지 견주어 보면 가장 빨리 찾습니다.
• 실행이 멈췄다면 「출력 보기」와 아래쪽 「디버그 로그」에 cob 의 원문 출력이 있습니다. 디버그 로그는 가장 최근 실행 하나만 담고, 앱을 끄면 사라집니다(실행 결과와 게시).
• 용어가 낯설다면 용어집을, 앱에서 지금 쓸 수 없는 기능을 찾는다면 준비 중인 기능을 보세요.

다음 단계

자주 받는 질문은 자주 묻는 질문에 모아 두었습니다.