프로젝트와 작업 공간
기존 폴더를 등록하거나 저장소를 복제하고, 현재 체크아웃과 새 워크트리 중 작업할 위치를 선택합니다.
프로젝트는 Liverary가 읽고 수정할 파일의 기준 폴더입니다. 같은 프로젝트에서도 기존 파일을 바로 수정할지, 별도 워크트리에서 작업할지를 선택할 수 있습니다. 이 문서는 공개 설치본 1.0.0을 기준으로 합니다.
기존 폴더 등록하기
- 사이드바나 시작 화면에서 프로젝트 추가를 누릅니다.
- 실행 환경이 여러 개라면 폴더가 있는 환경을 선택합니다. 내 PC의 폴더는 로컬 환경, WSL이나 SSH 서버의 폴더는 해당 환경에서 찾습니다.
- 로컬 폴더를 선택하고 작업할 폴더를 탐색하거나 경로를 입력합니다.
- 폴더를 선택해 추가한 뒤, 프로젝트 이름과 경로가 맞는지 확인합니다.
- 해당 프로젝트에서 새 대화를 열고 제공자와 모델을 선택합니다.
웹 앱이라면 src 같은 하위 폴더보다 package.json과 README가 있는 프로젝트 루트를 선택하는 편이 작업 범위를 설명하기 쉽습니다. 이름이 같은 폴더가 여러 곳에 있다면 이름만 보지 말고 전체 경로를 확인하세요. Git 저장소가 아닌 일반 폴더도 등록할 수 있지만 브랜치와 워크트리 기능에는 Git 저장소가 필요합니다.
첫 요청은 다음처럼 시작할 수 있습니다.
이 프로젝트의 README와 실행 설정을 읽고, 시작 명령과 주요 폴더의 역할을 설명해 줘. 아직 파일은 수정하지 마.
원격 저장소 복제하기
아직 내 컴퓨터에 소스가 없다면 프로젝트 추가 → 원격 URL에서 저장소 복제를 사용합니다.
https://github.com/계정/저장소.git같은 복제 URL을 입력하고 Enter를 누릅니다.- 저장할 경로를 선택하거나 입력하고 Enter를 눌러 복제를 시작합니다.
- 복제 상태를 확인하고, 완료된 프로젝트를 열어 첫 대화를 시작합니다.
저장 위치는 선택한 실행 환경의 경로입니다. SSH 환경을 골랐다면 저장소도 서버에 복제됩니다. 비공개 저장소에는 그 환경에서 사용할 수 있는 Git 인증이 필요하며, Codex나 Claude에 로그인한 것만으로 GitHub 접근 권한이 생기지는 않습니다.
이미 복제한 폴더가 있다면 다시 복제할 필요 없이 로컬 폴더로 등록하세요. 복제 오류가 나면 URL, 저장 경로, 해당 환경의 Git 인증을 순서대로 확인합니다. 설정 필요가 표시되는 저장소 서비스는 안내에 따라 설정 → 소스 제어를 먼저 확인하세요.
새 프로젝트 만들기
새 작업을 시작할 때는 새 프로젝트에서 이름을 입력하고 표시된 저장 위치를 확인한 뒤 폴더 생성 후 추가를 선택합니다. 새 폴더에서 시작하는 Git 프로젝트이며, GitHub에 공개되는 단계와는 별개입니다. 원격 저장소에 올리려면 이후 소스 제어 작업을 진행해야 합니다.
폴더를 정하기 전에 질문부터 하고 싶다면 프로젝트 없이 시작을 선택할 수 있습니다. 이 대화를 실제 프로젝트로 정리하려면 대화 메뉴의 프로젝트로 전환을 사용합니다. 기존 저장소를 수정하려는 작업이라면 처음부터 그 프로젝트를 선택하면 작업 위치가 명확해집니다.
현재 폴더와 워크트리 선택하기
Git 프로젝트의 새 대화에서는 첫 메시지를 보내기 전에 입력창 주변의 작업 공간과 브랜치 선택을 확인합니다.
| 선택 | 작업 위치와 용도 |
|---|---|
| 현재 체크아웃 | 현재 프로젝트 폴더에서 작업합니다. 다른 편집기에서 열어 둔 파일에도 변경이 반영됩니다. |
| 현재 워크트리 | 이미 연결된 워크트리에서 계속 작업할 때 표시됩니다. |
| 새 워크트리 | 기준 브랜치에서 별도 작업 폴더를 만들어 새로운 작업을 시작합니다. 기존 작업과 파일을 나누고 싶을 때 사용합니다. |
새 워크트리를 선택했다면 기준 브랜치를 고른 뒤 요청을 보냅니다. 워크트리 준비 중 표시가 끝날 때까지 기다리고, 준비 오류가 있다면 그 내용을 먼저 확인하세요. 기존 대화에서는 작업 공간 선택이 고정될 수 있으므로 다른 위치에서 작업하려면 새 대화를 여는 것이 명확합니다.
예를 들어 지금 진행 중인 수정은 그대로 두고 다른 화면 구성을 시험하려면, 새 대화에서 새 워크트리를 선택해 “설정 화면을 두 열 구성으로 바꿔 줘”라고 요청할 수 있습니다. 결과는 그 워크트리에서 확인하며, 원래 브랜치에 반영하는 일은 별도의 Git 작업입니다.
작업 위치가 예상과 다를 때
- 폴더를 찾을 수 없음: 선택한 실행 환경이 맞는지 확인합니다. Windows 경로를 Linux 서버의 경로처럼 사용할 수는 없습니다.
- 프로젝트 추가가 비활성화됨: 환경 연결 상태와 프로젝트 추가 권한을 확인합니다.
- 새 워크트리를 시작할 수 없음: Git 저장소인지, 기준 브랜치를 선택했는지, 준비 단계에서 오류가 발생했는지 확인합니다.
- 내 편집기에서 변경이 보이지 않음: 대화가 원본 폴더가 아닌 워크트리를 사용하는지 확인합니다. 터미널에서도 현재 위치를 확인할 수 있습니다.
환경별 경로와 연결은 실행 환경, 변경 확인과 커밋은 파일·터미널·Git에서 이어서 설명합니다.