AI 파일 편집 도구 — 되돌리기가 사라져 백업은 내 몫입니다

AI에게 파일을 직접 열고 고치게 하는 도구가 있습니다. 명령을 실행하는 도구와 짝을 지으면 그게 곧 코딩 에이전트가 되죠. 그런데 변경 이력을 보다가 눈에 띄는 대목이 있었습니다 — 초기 버전엔 있던 "되돌리기" 명령이 지금은 빠져 있습니다. AI가 내 파일을 고치는데 무르기가 없다는 뜻이라, 안전망은 내가 깔아야 합니다.

📌 30초 요약

• ★★되돌리기 명령이 없어졌습니다 — 예전 버전엔 있었어요.
• ★파일을 실제로 만지는 건 전부 내 코드입니다.
• ★바꿀 문구가 여러 군데 걸리면 내가 오류를 만들어 돌려줘야 합니다.
• ⚠️ 공백과 들여쓰기까지 정확히 일치해야 바뀝니다.
• 쓸 수 있는 명령은 넷뿐 — 보기·바꾸기·만들기·끼워넣기.
• 문서가 백업 함수 예시까지 실어 뒀습니다. 이유가 있죠.

쓸 수 있는 명령은 넷뿐입니다

생각보다 단출합니다. ①보기 ②문구 바꾸기 ③새로 만들기 ④특정 줄 뒤에 끼워넣기, 이 넷이 전부예요. 보기 명령은 파일 전체를 읽을 수도, 줄 범위를 정해 그 구간만 읽을 수도 있고, 경로에 폴더를 주면 그 안의 목록을 보여 주는 용도로도 씁니다. 파일 목록을 따로 얻을 방법이 없어 보이는데, 사실 같은 명령으로 됩니다.

큰 파일을 볼 때는 잘립니다. 그 잘리는 기준을 내가 정할 수 있는 설정이 있는데, 특정 시점 이후 버전에서만 먹힙니다. 옛 버전에 그 설정을 붙이면 그냥 무시돼요. 도구 버전과 모델을 짝 맞춰 쓰라는 안내가 붙어 있는 이유입니다.

되돌리기가 사라졌습니다

변경 이력을 보면 분명합니다. 처음 나왔을 때는 보기·만들기·바꾸기·끼워넣기에 더해 "되돌리기"까지 다섯 개였어요. 그런데 다음 세대용으로 갱신되면서 되돌리기만 빠지고 나머지는 그대로 유지됐습니다. 이후 버전에도 다시 들어오지 않았고요.

🚨 무르기가 없으면 안전망은 내가 깔아야 합니다

문서가 구현 요령에 "고치기 전에 사본을 만들어 두라"는 항목을 두고 백업 함수 예시 코드까지 언어별로 실어 뒀습니다. 편의 기능이라서가 아니라 되돌릴 수단이 도구 쪽에 없기 때문이죠. 실무에서는 사본보다 더 나은 방법이 있습니다 — 형상 관리로 되돌아갈 지점을 남겨 두는 것. 바이브코딩에 그게 왜 필수인지 여기서 다시 확인되는 셈입니다.

파일을 실제로 만지는 건 내 코드입니다

가장 많이 오해하는 부분입니다. AI가 내 디스크를 직접 건드리는 게 아닙니다. AI는 "이 경로의 이 문구를 저걸로 바꿔 줘"라는 요청을 만들어 보낼 뿐이고, 파일을 열고 찾고 쓰고 저장하는 일은 전부 내 프로그램이 합니다. 결과도 내가 만들어 돌려줘야 하고요.

누가 하나	무엇을
AI 쪽	어느 파일의 무엇을 어떻게 바꿀지 정해서 요청
내 코드	경로 확인·읽기·치환·저장·백업 전부
내 코드	없는 파일·여러 군데 일치 같은 오류 판정과 회신
내 코드	되돌릴 수단 마련 — 도구엔 없습니다

그래서 공짜 모델을 붙여 코딩 에이전트를 굴려 본 경험이 있다면 감이 올 겁니다 — 에이전트 품질의 절반은 모델이 아니라 이 뒤처리 코드에서 갈립니다. 어느 폴더까지 열어 줄지, 잘못된 경로를 어떻게 막을지도 전부 이쪽 몫이고요.

여러 군데 걸리면 내가 오류를 만들어야 합니다

문구 바꾸기 명령의 함정입니다. 바꿀 문구는 공백과 들여쓰기까지 정확히 일치해야 합니다. 한 칸만 달라도 못 찾아요. 그런데 반대 상황이 더 위험합니다 — 같은 문구가 파일 안에 여러 번 나오면 어디를 바꿔야 할지 알 수 없습니다.

이때 문서가 요구하는 건 "내가 그 상황을 감지해서 오류라고 표시한 결과를 돌려주라"는 겁니다. 도구가 알아서 막아 주는 게 아니에요. 이 검사를 빼먹으면 첫 번째 것만 조용히 바뀌거나, 구현에 따라 전부 바뀌어 버립니다. 없는 파일을 열려고 할 때도 마찬가지로 오류 표시를 붙여 돌려줘야 AI가 상황을 알고 다른 방법을 찾습니다.

덧붙여, 이 도구도 붙여 두기만 해도 입력 토큰이 조금 더 붙습니다. 명령을 실행하는 도구와 같이 쓰면 그만큼 더 늘어나니, 긴 세션에서 토큰이 어떻게 집계되는지도 같이 챙겨 두면 좋습니다.

자주 묻는 질문 (FAQ)

Q. 왜 되돌리기를 없앴을까요?

문서에 이유는 안 적혀 있고 "이 버전은 되돌리기를 제거하고 나머지 기능은 유지한다"고만 나옵니다. 다만 되돌리기를 제대로 하려면 도구가 이전 상태를 들고 있어야 하는데, 파일을 만지는 주체가 내 프로그램이라 그럴 자리가 없습니다. 구조상 자연스러운 정리로 보입니다.

Q. 명령 실행 도구로 파일을 고치면 안 되나요?

됩니다만 둘을 짝 지어 쓰라는 게 문서의 권고입니다. 이쪽으로 고치고 저쪽으로 돌려 보는 분업이죠. 셸 명령으로 문자열을 치환하면 실수가 잦고 무엇이 바뀌었는지 추적하기도 어렵습니다.

Q. 어떻게 부탁해야 잘 고치나요?

문서가 예시로 비교해 뒀습니다 — "코드 좀 고쳐 줘"보다 "어느 파일에 무슨 증상이 있는데 그것 때문에 실행이 안 된다"가 훨씬 낫습니다. 파일 경로를 분명히 짚어 주는 것도 같은 이유예요.

Q. 윈도우에서도 되나요?

됩니다. 파일을 다루는 코드를 내가 짜기 때문에 운영체제 제약이 없습니다. 다만 경로 구분자와 줄바꿈 문자 처리는 직접 챙겨야 해요. 여기서 어긋나면 문구가 정확히 일치하지 않아 치환이 계속 실패합니다.

✨ 정리하면

명령은 넷뿐이라 배울 게 적지만, 안전은 전부 내가 책임지는 구조입니다. 셋만 챙기세요 — 고치기 전에 되돌아갈 지점을 남기고, 여러 군데 걸리는 상황을 반드시 오류로 처리하고, 열어 줄 폴더 범위를 좁게 묶을 것. 되돌리기가 없다는 사실을 알고 시작하는 것과 모르고 시작하는 것의 차이가 큽니다. 비용과 권한을 함께 설계하는 흐름은 AI 지출 관리 허브에 정리해 두었습니다.

출처: Claude 공식 문서 「텍스트 편집 도구」 (2026-09-02 열람). 버전별 지원 명령과 모델 짝은 2026년 기준이며 변동될 수 있습니다.