---
title: "내 사이트의 코드 | Briks"
url: https://briks.dev/ko/docs/code
description: "모든 플랜에서 File Explorer로 사이트 코드를 보고 수정하고 게시해요. 유료 플랜은 버전을 zip으로 내려받고, 빠지는 부분도 확인해요."
last_updated: 2026-10-08
---

# 내 사이트의 코드

Briks는 모든 사이트에 진짜 코드를 쓰고, 그 코드는 읽을 수 있도록 내 것이에요. File Explorer에서는 라이브 버전이 가진 그대로 사이트에 쓰인 파일을 볼 수 있어요. 편집 권한이 있는 사람은 모든 플랜에서 파일을 바꾸고 게시할 수 있어요. 유료 플랜에서는 워크스페이스의 누구나 zip으로 내려받을 수도 있어요.

읽는 데 6분 2026년 10월 8일 스튜디오 기준으로 확인함

## File Explorer 열기

어디에

1. Projects
2. Your project
3. Settings
4. File Explorer

화면은 두 가지예요. 읽고 편집하는 **Files**, 그리고 유료 플랜에서 다운로드하는 **Settings** 예요. 제목에는 어느 버전이 라이브인지 나와요. 예를 들면 “The code written for this site, as version 14 is live.”처럼요. 사이트를 게시하기 전에는 보여 줄 내용이 없어서 “Nothing published yet”라고 표시돼요.

## 파일 둘러보기

폴더와 파일은 왼쪽 트리에 폴더가 먼저, 각각 이름순으로 나열돼요. **Filter files** 에 입력하면 이름이나 폴더로 목록을 좁힐 수 있어요. 그 아래에는 “38 files written for this site” 같은 개수가 표시돼요. 처음 열리는 파일은 `content/site.ts`로, 사이트의 주요 정보가 들어 있어요.

| 폴더 | 구성 내용 |
| --- | --- |
| `app/` | 사이트의 페이지들이에요. 페이지 주소마다 폴더가 하나씩 있어요. |
| `components/custom/` | 히어로, 서비스 목록, 푸터처럼 내 사이트에 맞춰 쓴 섹션이에요. |
| `content/` | 사이트의 문구와 사실 정보예요. |
| `public/` | 사이트가 있는 그대로 제공하는 파일. |
| `api/` | 사이트 자체의 서버 코드가 있다면 그 코드예요. |
| `db/` | 사이트가 데이터를 저장한다면 그 데이터의 구조예요. |

파일을 클릭하면 줄 번호와 함께 내용을 읽을 수 있어요. **Wrap lines** 를 켜면 긴 줄이 옆으로 넘치지 않고, **Copy** 를 누르면 파일 전체가 클립보드에 복사돼요. 이미지처럼 텍스트가 아닌 파일은 목록에는 나오지만 내용은 보여 주지 않으며, 유료 플랜에서는 다운로드에 포함돼요.

## 파일을 편집하고 게시하기

Editor, Admin, Owner는 파일을 열면 편집기가 열려요. Viewer는 모든 파일을 읽기 전용으로 봐요.

1. 파일 열기

   위치: Files

   트리에서 클릭하세요. 에디터가 텍스트와 함께 열려요.

2. 수정하기

   위치: Editor

   일반 코드 편집기처럼 입력하세요. 파일에는 **Edited** 표시가 붙고, 폴더가 닫혀 있으면 점으로 표시돼요. **Undo changes** 를 누르면 파일 하나가 원래대로 돌아가요.

3. 필요하면 파일을 추가하거나 삭제하세요

   위치: Files

   **New file** 은 `app/`, `components/custom/`, `content/`, `api/`, `db/`, `public/` 안의 경로를 물어요. **Delete** 는 파일을 삭제 대상으로 표시하고, **Keep file** 을 누르면 마음을 바꿀 수 있어요.

4. 저장하고 게시하기

   위치: Editor

   아래쪽 바의 **Save and publish** 를 누르거나 Ctrl+S(Mac은 ⌘S)를 누르세요. 대화상자에 변경된 파일이 모두 나와요.

5. 메모 추가

   위치: Dialog

   원하면 **Note** 에 바뀐 내용을 적으세요. 버전 기록에 남아요.

6. 확인

   위치: Dialog

   **Save and publish** 를 누르세요. 표시줄에 예를 들어 “변경된 파일 2개를 게시하는 중이에요.”라는 문구와 함께 스튜디오에서 진행 상황을 따라갈 링크가 나와요.

수정 내용은 이 탭에만 남아요

게시하기 전까지 변경 내용은 이 브라우저 탭에만 있어요. 페이지를 떠나려 하면 “Leave without publishing?”라고 묻고, 탭을 닫으면 변경 내용이 사라져요. 게시하기 전에는 라이브 사이트가 바뀌지 않아요.

## 저장하면 일어나는 일

Briks가 내 파일로 사이트를 빌드해 게시하며, 보통 몇 분 안에 끝나요. 새로 디자인하거나 다시 쓰는 것은 없고, 크레딧도 보류되거나 차감되지 않아요. 스튜디오에 **Verifying build** 와 **Publishing** 이 표시된 뒤 “Your code changes are live: 2 files changed in the File Explorer. Nothing else about the site changed.” 같은 답변이 나와요. File Explorer로 돌아오면 초록색 바에 “Your changes are published and live.”라는 문구와 **Open the site** 가 보여요.

저장하면 **Change** 로 표시된 새 버전이 만들어져요. 그래서 미리보기 위쪽의 되돌리기 화살표로 저장 전 상태로 되돌릴 수 있어요. 이후 대화에서 요청하는 변경은 직접 수정한 파일을 기준으로 시작해요. [비주얼 에디터](https://briks.dev/ko/docs/visual-editor) 에서 게시한 변경은 같은 파일에 반영되므로, 게시가 끝나면 여기에서 확인할 수 있어요.

코드가 빌드되지 않으면 아무것도 게시되지 않고, 라이브 사이트는 그대로 유지돼요. 빨간 상자에 “Nothing was published”라는 문구와 멈춘 파일 이름이 나오고, 그 아래에 빌드 자체의 로그 줄이 표시돼요. 수정한 내용은 그대로 남아 있어요. 해당 파일의 **Open** 버튼을 눌러 그 줄로 이동하고, 고친 다음 다시 게시하세요.

| 한도 | 금액 |
| --- | --- |
| 한 번에 저장되는 파일 | 50 |
| 직접 편집할 수 있는 파일 하나 | 256 KB (더 큰 파일은 읽기 전용으로 보여요) |
| 모든 변경을 한 번에 저장 | 2 MB |
| 메모 | 300자 |

페이지를 연 뒤 사이트가 바뀌었거나(“The site changed since you opened it: reload to see the new version.”), 무언가 빌드 중이거나, A/B 테스트가 진행 중이면 이유와 함께 저장이 거부돼요. 일부 파일은 빌드할 때마다 스튜디오가 먼저 작성하므로 여기서는 바꿀 수 없고, 시도하면 File Explorer가 그렇게 알려 줘요.

## 코드 다운로드

코드 다운로드는 유료 플랜에 포함돼요. Free에서는 **Download code** 버튼과 **Backups** 의 **Download** 버튼이 보이지 않아요. 대신 “Downloading the code comes with a paid plan.”라는 안내가 나오고, **See what's included** 를 누르면 **Download your site's code** 에서 업그레이드 창이 열려요. 파일 보기와 편집은 모든 플랜에서 계속 쓸 수 있어요.

1. Settings 화면으로 이동하기

   위치: File Explorer

   **Settings**, **File Explorer** 를 열고, **Files** 옆의 **Settings** 보기를 여세요.

2. 다운로드

   위치: Export

   **Download code** 를 눌러요. 사이트 주소와 버전 이름이 붙은 zip 파일을 받게 돼요. 예: `harbour-plumbing-version-14.zip`.

어디에

1. Settings
2. File Explorer
3. Settings
4. Download code

이전 버전은 **Settings**, **Backups** 를 열어 보세요. 버전마다 **Download** 버튼이 따로 있어요. **Download code** 행에는 **Paid** 태그가 붙어 있어요.

## zip에 들어 있는 것과 없는 것

zip에는 사이트를 위해 작성된 파일이 들어 있어요. 페이지, 섹션, 문구, 사이트 고유의 파일이 그 버전에 있던 그대로 담겨요. 스튜디오가 모든 사이트에 제공하는 공용 구성 요소, 빌드를 설정하는 파일, 비밀 정보는 들어 있지 않아요. 이런 공용 요소가 빠져 있어서 zip만으로는 실행하거나 빌드할 수 없어요.

그래서 옮겨 쓸 수 있는 사본이 아니라 기록이자 참고 자료예요. 게시된 내용을 보관하거나, 개발자에게 섹션이 어떻게 만들어졌는지 보여 주거나, 사이트의 글을 자신의 편집기에서 검색할 때 쓰는 분들이 많아요.

보관함 디자인 에이전시

> 고객 사이트가 여섯 개인 에이전시는 오픈 후 각 사이트의 zip 파일을 내려받아 고객 계약서와 함께 보관해요.

각 zip에는 출시 버전의 페이지와 문구가 들어 있어서, 무엇이 언제 공개됐는지 정확히 보여 줄 수 있어요.

직접 하는 작은 수정 물리치료 클리닉

> 클리닉의 사무장이 영업시간이 담긴 파일을 찾아 금요일을 오전 8시부터 오후 4시로 바꾸고, `Winter hours`라는 메모를 더한 뒤 **Save and publish** 를 눌러요.

몇 분 뒤 사이트에 새 영업시간이 표시됐어요. **Versions** 에는 **Change** 로 나타났고, 크레딧은 쓰이지 않았어요.

### Viewer도 코드를 수정할 수 있나요?

아니요. 모든 파일을 읽을 수 있고, 유료 플랜에서는 zip으로 내려받을 수도 있어요.

### Free에서도 코드를 다운로드할 수 있나요?

아니요. 코드 다운로드는 Starter부터 유료 플랜에 포함돼요. Free에서도 모든 파일을 볼 수 있고, 편집 권한이 있으면 편집하고 게시할 수 있어요.

### Briks가 제가 한 수정을 덮어쓰나요?

나중에 요청하는 변경은 내 파일에서 시작해요. 변경이 건드리는 파일을 다시 손볼 수도 있으니, 같은 부분을 Briks에 바꿔 달라고 할 때는 직접 수정한 내용을 함께 알려 주세요.

### 여기에 사진을 추가할 수 있나요?

아니요. 사진처럼 텍스트가 아닌 파일은 File Explorer에서 만들 수 없어요. **Media** 탭이나 **Storage** 를 이용하세요.

## 다음 글 읽기

- [프로젝트에서 작업하기 **버전, 실행 취소, 다시 실행** 모든 제작과 변경이 사이트 버전으로 저장돼요. 변경을 취소하거나 다시 적용하고, 이전 버전을 그대로 되살려 게시해요. 크레딧은 묶이지 않아요.](https://briks.dev/ko/docs/versions)
- [프로젝트에서 작업하기 **GitHub 동기화** GitHub 저장소를 연결하면 게시한 버전이 커밋되고, 브랜치에 푸시할 때마다 점검 후 사이트에 게시돼요.](https://briks.dev/ko/docs/github)
- [데이터와 자동화 **백업** Briks가 프로젝트마다 보관하는 코드 버전, 데이터베이스 복원 지점, 야간 복사본. 복원과 다운로드 방법, 복사본별 내용을 안내해요.](https://briks.dev/ko/docs/backups)
- [데이터와 자동화 **시크릿** 사이트 코드에 필요한 API 키와 비밀번호를 페이지나 다운로드가 아닌 서버에 보관해요. 추가, 변경, 삭제와 Briks가 적용하는 규칙을 안내해요.](https://briks.dev/ko/docs/secrets)

아직 해결되지 않았나요?

프로젝트 이름과 기대했던 내용을 적어 [hello@briks.dev](mailto:hello@briks.dev) 로 보내 주세요. 스크린샷이 있으면 도움이 돼요.