빠른 시작

프로젝트를 추가하고, 채팅으로 요구를 말해 조립 계획을 확인한 뒤 실행해서 첫 프로젝트를 만들고 여는 과정을 처음부터 끝까지 따라갑니다.

제공 중 마지막 확인: 2026-10-08

설치한 Cocode IDE 로 첫 프로젝트를 만드는 길입니다. 프로젝트 폴더를 하나 정하고, 채팅으로 만들고 싶은 것을 말하고, 조립 계획을 확인해 실행하면 그 폴더 안에 새 프로젝트가 생깁니다.

주의

시작하기 전에 준비물을 확인하세요. API 키나 cob 가 없으면 5단계에서 「빌더가 멈췄습니다」 카드(cob 를 못 찾으면 「cob 실행 파일을 찾지 못했습니다」)가 나오고, gh 로그인이 안 되어 있으면 7단계의 「사전 점검」에서 멈춥니다. 그 밖의 명령줄 도구나 비공개 저장소 권한이 모자라면 이후 단계에서 실패할 수 있습니다. 어느 쪽이든 프로젝트는 만들어지지 않습니다.

준비물

설치를 마친 Cocode IDE
쓰려는 공급자의 API 키(Ollama 는 필요 없습니다)
새 프로젝트를 담을 폴더를 만들 수 있는 위치(기본은 홈 폴더 아래 Projects, 없으면 홈 폴더)

단계

Cocode IDE 를 엽니다. 열린 프로젝트가 없으면 채팅 화면에 「무엇을 만들까요?」와 「프로젝트 추가」 단추가 보입니다. 이전에 연 폴더가 있고 닫지 않은 채 앱을 껐다면 그 폴더가 열리니 3단계는 건너뛰어도 됩니다.
API 키를 저장합니다. 사이드바 맨 아래의 톱니바퀴 「설정」을 누르고 「AI 공급자」에서 쓸 공급자 카드를 고릅니다. 「API 키」 칸에 키를 넣고 「저장」을 누르면 「키체인에 저장했습니다」가 보입니다. Linux 에서는 이 저장이 실패할 수 있으니 준비물의 환경 변수 방법을 쓰세요. 키를 넣은 공급자가 둘 이상이면 「기본으로 설정」으로 채팅이 쓸 공급자를 정합니다. 위쪽의 「돌아가기」로 앱 화면에 돌아옵니다. 화면별 설명은 AI 공급자에 있습니다.
프로젝트 폴더를 추가합니다. 「프로젝트 추가」를 눌러 같은 이름의 대화상자를 엽니다. 아래 「다른 방법」의 **「새 프로젝트 만들기」**를 펼쳐 「이름」(예: my_workspace)을 적고 「만들고 열기」를 누르면, 빈 폴더가 만들어지고 git init 까지 된 채로 열립니다(「git 저장소로 초기화」는 처음부터 켜져 있습니다). 이미 있는 폴더를 쓰려면 위쪽의 「폴더 찾아보기」를 고르세요. 폴더가 열리면 코드 모드 화면이 나옵니다.
채팅 모드로 옮깁니다. 화면 위쪽의 「채팅」을 누릅니다. 입력창 아래에 「<폴더 이름> 에 만들기」가 보이면 맞게 온 것입니다. 이 폴더가 새 프로젝트의 생성 위치이고, 새 프로젝트는 그 안의 하위 폴더로 생깁니다.
요구를 말합니다. 입력창에 만들고 싶은 것을 적고 Enter 키나 오른쪽의 위쪽 화살표 단추(스크린 리더에는 「보내기」)로 보냅니다. 입력창 아래의 예시 단추(예: 「피부과 의원 EMR — 예약 · 접수 · 차트」)를 누르면 입력창이 채워질 뿐 바로 보내지지는 않습니다. 「카탈로그를 대조하고 계획을 세우는 중…」이 지나면 AI 가 계획을 설명하는 글과 「조립 계획」 카드가 나옵니다. 앱이 요구를 도메인과 기능으로 나누어 읽는 규칙은 요구 쓰기에 있습니다.
조립 계획을 확인합니다. 카드에서 다음을 살펴봅니다. 해당하는 내용이 없는 줄(「기본 포함」 · 「후속 적용」 · 「데이터 팩」 · 「구현 필요」)은 나오지 않습니다.
- 「프로젝트 이름」: 소문자 · 숫자 · 밑줄(snake_case)로 쓰되 첫 글자는 소문자이고 밑줄은 연달아 쓰거나 끝에 둘 수 없습니다. 칸 아래에 「<생성 위치 폴더>/<프로젝트 폴더> 에 만듭니다」가 보이며, 밑줄은 폴더 이름에서 하이픈이 됩니다(clinic_emr → clinic-emr). 이미 있는 폴더 이름이면 「이미 있는 폴더입니다 — 다른 이름을 쓰세요」가 나오고 실행할 수 없습니다.
- 「레시피」 · 「기본 포함」 · 「후속 적용」: cob 가 카탈로그에서 고른 조립 재료입니다. 「기본 포함」은 기본 조립에 들어가는 것이고 「후속 적용」은 이어서 적용할 후보입니다. 그 밖에 「데이터 팩」 줄이 나올 수 있습니다. 「레시피」 줄이 「없음 — 기본 조립」이 아니면 「프로젝트 생성」에서 멈출 수 있습니다(아래 「자주 겪는 문제」).
- 「구현 필요」: 카탈로그로 직접 채워지지 않는 기능입니다. 따로 구현해야 합니다.
- 「예상 시간」: 「약 N분 · 휴리스틱 추정」입니다.
- 「함께 만들기」: 「데모 데이터」 · 「소개 페이지 (Pages)」 · 「운영 콘솔」 중 함께 만들 것을 고릅니다.
계획을 바꾸고 싶으면 「계획 다듬기」를 눌러 입력창에 다시 말합니다. 새 요구를 보내면 새 계획이 나오고 앞의 계획은 「이전 계획 — 대체됨」으로 접힙니다. 카드의 줄마다 무엇을 뜻하는지는 조립 계획 읽기에, 「함께 만들기」는 함께 만들기 옵션에 자세히 있습니다.
「확인하고 실행」을 누릅니다. 이 단추를 누르기 전에는 아무것도 만들어지지 않습니다. 누르면 계획 카드는 「계획 확인됨」 한 줄로 접히고, 그 아래에 「<이름> 생성 중」 실행 카드가 나타나 「사전 점검」 → 「프로젝트 생성」 → 「검증」(Pages 를 켰다면 「Pages 게시」까지)이 차례로 도는 것이 단계마다 보입니다. 오른쪽 패널에는 「진행 상황」 · 「출력」 · 「컨텍스트」가, 아래쪽에는 cob 의 출력이 쌓이는 「디버그 로그」 탭이 열립니다. 실행 카드가 보여 주는 것과, 멈췄을 때 다시 돌리는 방법은 실행 결과와 게시에 있습니다.
결과를 확인하고 엽니다. 끝나면 카드 제목이 「<이름> 생성 완료」로 바뀌고 「새 프로젝트 열기」 단추가 나타납니다. 누르면 새 프로젝트가 프로젝트 목록에 추가되어 열리고, 지금까지의 대화도 새 프로젝트로 옮겨 갑니다. 화면은 채팅 모드 그대로이니, 만들어진 파일을 보려면 위쪽의 「코드」를 누르세요. 코드 모드는 코드 모드와 실행에 있습니다.

주의

「소개 페이지 (Pages)」는 처음부터 켜져 있습니다. 켜 두면 마지막 단계에서 GitHub 에 비공개 저장소를 만들고 push 한 뒤 Pages 로 배포합니다. GitHub 의 무료 요금제에서는 비공개 저장소로 Pages 를 쓸 수 없고(Pro · Team · Enterprise 요금제가 필요합니다), 배포된 사이트는 저장소가 비공개여도 기본으로는 인터넷에서 누구나 볼 수 있습니다. 카드의 「Pages 저장소」 기본값은 coco-de/<프로젝트 폴더 이름> 입니다. 그 소유자에 저장소를 만들 권한이 없다면 본인 GitHub 의 owner/name 으로 고치거나, 체크를 꺼서 Pages 없이 시작하세요. 형식이 틀렸거나, 확인하는 중이거나, GitHub 에 같은 이름의 저장소가 이미 있다고 확인되면 「확인하고 실행」이 눌러지지 않습니다. 저장소가 있는지 확인하지 못했을 때(gh 가 없거나 로그인하지 않은 경우 등)에는 눌러지고, 이미 있는 저장소라면 게시 단계에서 멈춥니다. 저장소 이름을 정하는 법은 함께 만들기 옵션에 있습니다. 3단계에서 「git 저장소로 초기화」를 켠 채 만든 폴더처럼 생성 위치가 Git 저장소이면, 새 프로젝트가 그 안에 만들어져 게시 단계가 멈출 수 있습니다(실행 결과와 게시의 경고).

참고

요구를 보낼 때마다 새 조립 계획을 세우고, 계획마다 AI 공급자를 부릅니다. 「설정」 › 「AI 공급자」의 「채팅 맥락 제안」이 켜져 있으면 계획 카드 아래에 AI 가 고른 다듬기 제안을 만드느라 계획 1건마다 호출이 1번 더 늘어납니다. 아래 NOTE 의 시작 제안이 있는 빌드에서는 같은 설정이 켜져 있을 때 빈 대화의 첫 화면에서도 호출이 한 번 더 있고(같은 프로젝트에서 앞선 요구가 같으면 받은 제안을 다시 씁니다), 끝난 실행 카드 아래에도 제안이 붙어 실행 1건마다(멈춘 실행은 cob 의 사유나 막힌 호스트가 있을 때만) 호출이 1번 더 늘어납니다. 비용이 걱정되면 그 설정을 끌 수 있습니다. 호출이 생기는 때와 보내는 내용은 맥락 제안에 있습니다.

참고

첫 화면의 모습은 앱 빌드에 따라 조금 다릅니다. 2026-10-08 에 내려받을 수 있었던 0.1.0 에는 예시 단추 세 개가 보입니다. 그 뒤에 추가된 빌드에서는 「채팅 맥락 제안」이 켜져 있고 공급자 연결이 있고 cob 의 카탈로그를 읽을 수 있으면 예시 단추 자리에 「AI 생성 · 이 기기의 카탈로그 기준」 시작 제안이 나옵니다. 시작 제안을 만들지 못하면 예시 단추가 그대로 보입니다.

확인

사이드바 「프로젝트」 목록에 새 프로젝트(폴더 이름의 밑줄이 하이픈으로 바뀐 이름)가 추가되어 선택되어 있고, 「채팅·작업」 목록에 방금 대화가 옮겨 와 있습니다.
실행 카드 제목이 「<이름> 생성 완료」이고 단계가 모두 완료로 표시됩니다.
「새 프로젝트 열기」를 누른 뒤 위쪽 「코드」의 탐색기에 생성된 파일이 보입니다.

자주 겪는 문제

채팅 화면에 「프로젝트 추가」 단추만 보입니다

채팅은 열려 있는 프로젝트 폴더를 생성 위치로 씁니다. 폴더가 열려 있지 않으면 「프로젝트 폴더를 추가하면 채팅으로 기능을 조립할 수 있습니다」라고 안내합니다. 위 3단계로 폴더를 추가하세요. 대화상자의 「채팅으로 만들기」는 폴더를 만들지 않고 채팅 화면으로만 옮겨 주므로, 열린 프로젝트가 없을 때는 같은 안내가 다시 나옵니다.

「빌더가 멈췄습니다」가 나옵니다

카드의 사유를 읽으세요. 「API 키가 없습니다」라면 「설정 열기」로 키를 저장하고 「다시 시도」를 누릅니다. 그 밖의 사유도 카드에 나오고, 같은 요구를 다시 보내려면 「다시 시도」를 누르면 됩니다. 문구별 원인은 문제 해결에 있습니다.

「cob 실행 파일을 찾지 못했습니다」나 「bricks 체크아웃이 없습니다」가 나옵니다

cob 가 준비되지 않은 상태입니다. 카드의 「명령 복사」로 설치 명령을 복사해 터미널에서 실행한 뒤 「다시 시도」를 누르세요. bricks 가 없다면 「bricks 받기」를 누릅니다. 자세한 내용은 준비물의 「cob 와 bricks」에 있습니다. 설정 화면에서 미리 점검하는 법은 빌더에 있습니다.

실행이 「사전 점검」에서 멈춥니다

실행 카드에 「사전 점검에서 멈췄습니다」와 cob 가 알려 준 사유가 나옵니다. 사전 점검은 gh 로그인 여부를 확인하므로, 터미널에서 gh auth status 가 통과하는지 먼저 확인하세요. 나머지 준비물은 준비물에서 점검할 수 있습니다.

실행이 「프로젝트 생성」이나 「Pages 게시」에서 멈춥니다

카드의 「레시피」 줄이 「없음 — 기본 조립」이 아니면 「프로젝트 생성」에서 멈출 수 있습니다. cob 가 레시피 기반 생성을 시작할 때 bricks 에 사용 중단된 코드가 남아 있으면 프로젝트를 쓰기 전에 멈추기 때문입니다. 2026-10-09 에 확인한 첫 화면의 예시 단추 세 개는 모두 레시피가 있는 계획이었습니다. 「Pages 게시」에서는 3단계에서 「git 저장소로 초기화」를 켠 채 만든 폴더처럼 생성 위치가 Git 저장소 안이면 멈출 수 있습니다. 이유와 대처는 실행 결과와 게시의 경고와 「자주 겪는 문제」에 있습니다. 소스를 읽고 같은 계열의 cob 를 임시 폴더에서 실행해 확인한 내용이며, 앱 화면에서 직접 돌려 보지는 않았습니다.

다음 단계

프로젝트를 여닫는 방법과 화면 구성은 화면 구성과 프로젝트 관리에 있습니다. 채팅으로 만드는 각 단계를 자세히 알고 싶다면 채팅으로 프로젝트 만들기를 보세요. 만든 프로젝트를 고치고 돌려 보려면 코드 모드와 실행을, 설정 화면은 설정을, 막혔을 때는 문제 해결을 보세요.