> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/resources-context/codebase.md).
# 코드베이스
이 문서에서는 **리소스 및 컨텍스트** 탭 안의 **코드베이스** 기능을 설명합니다. 소스 코드를 ZIP 파일로 만들어 업로드하면 소스 코드를 워크스페이스에 등록할 수 있으며, AI가 코드 내용을 참조하면서 질문에 답변하거나 워크플로를 실행할 수 있게 됩니다. GitHub 리포지토리와의 연동은 [GitHub 연동](/features-ko/resources-context/github-integration.md) 참조.
## 사전 조건
| 작업 | 필요한 권한 |
| ---------- | --------- |
| ZIP 파일 업로드 | 전체 구성원 |
| 코드베이스 삭제 | 관리자 / 소유자 |
## ZIP 파일로 업로드하기
코드베이스 업로드 화면
1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. 업로드 영역에 ZIP 파일을 드래그 앤 드롭하거나, 영역을 클릭하여 파일을 선택하십시오.
4. 업로드 진행 상황이 백분율로 표시됩니다. 완료 후 자동으로 인덱스 처리가 시작됩니다.
5. 상태가 **{n}개 인덱싱됨**으로 바뀌면 코드베이스를 사용할 수 있습니다.
{% hint style="info" %}
지원 형식은 ZIP(.zip)뿐입니다. ZIP 파일은 최대 200 MB, 압축 해제 후 합계 크기는 최대 5 GB, ZIP 안의 파일 수는 100,000개까지입니다.
{% endhint %}
{% hint style="info" %}
ZIP 파일 업로드는 AI 사용량을 소비합니다. 사용 한도에 도달하면 업로드할 수 없게 됩니다. 또한 스토리지 사용량이 한도의 80%에 도달하면 경고가 표시되며, 한도를 초과한 경우 신규 업로드가 비활성화됩니다.
{% endhint %}
### 지원하는 파일 형식
인덱싱 대상이 되는 파일의 확장자는 다음과 같습니다.
**코드 파일**: `.ts` / `.tsx` / `.js` / `.jsx` / `.py` / `.go` / `.java` / `.rb` / `.rs` / `.c` / `.h` / `.cpp` / `.hpp` / `.cc` / `.cxx` / `.cs` / `.kt` / `.kts` / `.swift` / `.php` / `.sh` / `.sql`
**설정·문서 파일**: `.yml` / `.yaml` / `.toml` / `.json` / `.md` / `.txt`
`node_modules/` / `.git/` / `dist/` / `build/` 등의 디렉터리, 테스트 파일·잠금 파일은 자동으로 제외됩니다.
### 인덱스 상태
| 상태 | 설명 |
| ------------------ | --------------------------------------- |
| 준비 완료 | 추출이 완료된 상태 |
| 인덱싱 대기 중 | 인덱스 처리 시작을 기다리는 상태 |
| 인덱싱 중 ({처리됨}/{합계}) | 파일을 분석·인덱싱하는 중. 처리된 파일 수/전체 파일 수가 표시됩니다 |
| {n}개 인덱싱됨 | 인덱스 처리가 완료되어 사용 가능한 상태 |
| 인덱싱 실패 | 인덱스 처리에서 오류가 발생한 상태 |
| 실패 | 업로드 또는 압축 해제 처리에서 오류가 발생한 상태 |
## 코드베이스 삭제하기
ZIP 아카이브로 등록한 코드베이스를 삭제합니다. GitHub 리포지토리를 사용한 코드베이스의 삭제는 [GitHub 연동](/features-ko/resources-context/github-integration.md) 참조.
1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택하십시오.
2. **코드베이스**를 선택하십시오.
3. 삭제할 코드베이스의 오른쪽 끝에 있는 **메뉴**()를 클릭하십시오.
4. **삭제**를 클릭하십시오.
## 문제 해결
### 업로드 시 오류
| 오류 메시지 | 해결 방법 |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------- |
| .zip 파일을 업로드하세요 | 소스 코드를 .zip 형식으로 압축한 후 업로드하십시오. |
| File size exceeds maximum allowed size of 200MB | `node_modules/`나 `dist/` 등 불필요한 디렉터리를 제외하여 200 MB 이내가 되도록 ZIP을 다시 생성하십시오. |
| Failed to fetch | 페이지를 새로 고침한 후 다시 업로드하십시오. |
| 스토리지 한도를 초과했습니다 | 조직의 스토리지 용량이 한도에 도달했습니다. 불필요한 코드베이스를 삭제하여 스토리지를 확보하십시오. 한도 상향이 필요한 경우 조직의 관리자(소유자)에게 문의하십시오. |
| 사용 한도에 도달했습니다. 한도를 늘리려면 관리자에게 문의하세요. | 조직의 AI 사용량이 한도에 도달했으므로 조직의 관리자(소유자)에게 문의하십시오. |
### 압축 해제 시 오류
업로드 후 상태가 **인덱싱 실패** 또는 **실패**가 되는 경우, 다음 원인을 생각할 수 있습니다. 코드베이스를 한 번 삭제한 후, 원인에 따라 ZIP을 수정하여 다시 업로드하십시오.
| 원인 | 해결 방법 |
| ----------------------------------------------- | ---------------------------------------------------- |
| ZIP 안의 파일 수가 100,000개를 초과함 | 테스트 파일이나 캐시 파일을 제외하여 100,000개 이내가 되도록 ZIP을 다시 생성하십시오 |
| ZIP 안에 200 MB를 초과하는 개별 파일이 포함됨 | 해당 파일을 제외하여 ZIP을 다시 생성하십시오 |
| 압축 해제 후 합계 크기가 5 GB를 초과함 | 코드베이스를 분할하거나 불필요한 파일을 제외하여 ZIP을 다시 생성하십시오 |
| Windows의 ZIP 도구로 생성한 ZIP에 드라이브 문자(`C:\` 등)가 포함됨 | Unix/Linux 환경 또는 표준적인 ZIP 도구로 다시 생성하십시오 |
| ZIP에 심볼릭 링크가 포함됨 | 심볼릭 링크를 실체 파일로 교체한 후 ZIP을 다시 생성하십시오 |
### 인덱스 처리 오류
| 상황 | 원인 | 해결 방법 |
| ------------------------- | ----------------- | ----------------------------------------------------- |
| 상태가 **인덱싱 실패**인 채로 바뀌지 않음 | 임베딩 처리 중에 오류가 발생함 | 코드베이스를 한 번 삭제한 후 다시 업로드하십시오. 반복해서 발생하는 경우 지원팀에 문의하십시오 |
| **인덱싱 대기 중**이 오랫동안 지속됨 | 처리 대기열이 혼잡함 | 잠시 기다린 후 상황을 확인하십시오. 해소되지 않는 경우 지원팀에 문의하십시오 |