> 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을 다시 생성하십시오 |
### 인덱스 처리 오류
| 상황 | 원인 | 해결 방법 |
| ------------------------- | ----------------- | ----------------------------------------------------- |
| 상태가 **인덱싱 실패**인 채로 바뀌지 않음 | 임베딩 처리 중에 오류가 발생함 | 코드베이스를 한 번 삭제한 후 다시 업로드하십시오. 반복해서 발생하는 경우 지원팀에 문의하십시오 |
| **인덱싱 대기 중**이 오랫동안 지속됨 | 처리 대기열이 혼잡함 | 잠시 기다린 후 상황을 확인하십시오. 해소되지 않는 경우 지원팀에 문의하십시오 |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.genesis.autify.com/features-ko/resources-context/codebase.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.