브라우저가 내 파일을 직접 고치는 원리 (그리고 한계)
최종 수정: 2026년 8월 23일
어떻게 동작하나 · 읽는 시간 6분
"브라우저가 내 컴퓨터 파일을 고친다"는 말은 처음 들으면 좀 무섭습니다. 실제로 어떻게 되는지, 어디까지 되고 어디부터는 안 되는지 알면 판단이 쉬워집니다.
파일을 올리는 것이 아니라, 폴더를 여는 것이다
일반적인 웹 서비스는 파일을 업로드합니다. 내 파일의 사본이 서버로 올라가고, 서버가 그것을 다룹니다.
이 서비스의 「내 컴퓨터에서 작업」 모드는 다릅니다. 브라우저가 내 컴퓨터의 폴더를 직접 읽고 씁니다. 파일 사본이 서버로 올라가지 않습니다. 최신 브라우저의 파일 시스템 접근 기능(File System Access API)을 쓰는 방식입니다.
그래서 이런 차이가 생깁니다.
- 고친 결과가 내 폴더에 바로 반영됩니다. 내려받아 덮어쓰는 단계가 없습니다.
- 서버에는 파일이 남지 않습니다. 남길 곳이 없습니다.
- 대신 브라우저 탭을 닫으면 접근 권한이 사라집니다. 다시 열면 폴더를 다시 골라야 합니다.
권한은 내가 고른 폴더 하나뿐이다
폴더를 고를 때 브라우저가 "이 폴더의 파일을 편집하도록 허용하시겠습니까?"를 묻습니다. 여기서 허용한 범위가 전부입니다.
- 고른 폴더와 그 하위만 접근됩니다. 상위 폴더로 올라갈 수 없습니다.
- 다른 폴더를 다루려면 다시 고르고 다시 허용해야 합니다.
- 브라우저가 막는 폴더가 있습니다 — 시스템 폴더, 다운로드 폴더처럼 민감한 위치는 선택 자체가 거부됩니다.
권한 범위를 좁히는 가장 확실한 방법은 필요한 폴더만 고르는 것입니다. 프로젝트 전체를 열지 말고 작업할 하위 폴더만 여는 편이 안전합니다.
지원하는 브라우저가 제한된다
이 기능은 모든 브라우저에 있지 않습니다.
| 환경 | 「내 컴퓨터에서 작업」 |
|---|---|
| 데스크톱 Chrome · Edge | 된다 |
| 데스크톱 Safari · Firefox | 안 된다 |
| 모바일 브라우저 전부 | 안 된다 |
안 되는 환경에서는 파일을 올려서 작업하는 모드를 쓰면 됩니다. 이때는 사본이 서버의 임시 작업 폴더로 올라가고, 정해진 시간이 지나면 지워집니다.
하지 않는 것: 명령 실행
브라우저는 프로그램을 실행할 수 없습니다. 그래서 이 판에서는 테스트·빌드·설치 명령을 돌릴 수 없습니다. 코드를 고칠 수는 있지만 고친 코드가 실제로 돌아가는지 확인하는 일은 사람이 해야 합니다.
명령 실행까지 맡기려면 터미널 판을 쓰면 됩니다. 그쪽은 내 컴퓨터에서 도는 프로그램이라 테스트와 빌드를 직접 실행합니다.
그래서 무엇이 안전하고 무엇이 위험한가
안전한 쪽
- 파일 내용이 서버에 보관되지 않습니다. 모델에 보내는 것은 작업에 필요한 부분뿐입니다.
- 권한이 폴더 단위로 끊어져 있고, 탭을 닫으면 사라집니다.
- 명령을 실행할 수 없으니 "시키지도 않은 프로그램이 돌아가는" 일이 없습니다.
주의할 쪽
- 파일은 실제로 바뀝니다. 되돌리기(Ctrl+Z)가 없습니다.
- 에이전트가 지시를 잘못 이해하면 잘못된 파일을 고칠 수 있습니다. 그래서 수정 전에 확인을 받습니다.
- 확인 창을 계속 승인하면 그대로 진행됩니다. 승인은 사람의 판단입니다.
시작하기 전에 30초만
- 버전 관리를 쓰신다면 커밋해 두세요. 되돌릴 수 있는 상태가 가장 강한 안전장치입니다.
- 아니라면 폴더를 복사해 두세요.
- 처음에는 작은 폴더로 한 번 시켜 보세요. 어떻게 일하는지 감이 잡힌 뒤에 큰 작업을 맡기는 편이 좋습니다.