OpenCode가 파일 수정에 실패했다면, 같은 요청을 다시 보내도 될까요?

핵심 요약 (TL;DR)

“수정할 부분을 찾지 못했습니다”라는 답이 오면 같은 요청을 다시 보내기 쉽습니다. 한국 시간 10월 31일 공개된 OpenCode 2.2.5는 이런 실패를 읽는 단서를 보강했습니다. 없는 폴더를 읽으려 하면 가까운 실제 경로를 알려 주고, 바꿀 문자열을 찾지 못하면 비슷한 줄이나 이미 반영된 변경을 안내합니다.[1] 첫 앱을 만드는 분이라면 재시도 전에 현재 파일 상태부터 구분해 보시면 좋겠습니다.

폴더가 없는 것과 파일을 못 읽는 것은 같을까요?

공식 변경 기록은 read가 없는 폴더 때문에 실패할 때 해당 폴더와 가장 가까운 존재 경로를 오류에 표시한다고 설명합니다.[1] 이것은 필요한 폴더를 자동으로 만들어 준다는 발표가 아닙니다. 실패한 위치를 더 구체적으로 드러내는 개선입니다.

예를 들어 소개 페이지를 만드는 중이라면, AI가 가정한 프로젝트 위치와 실제 열린 작업 폴더가 같은지부터 확인해 보세요. “현재 작업 위치와 읽으려던 파일의 경로를 나누어 보여 주세요. 없는 파일을 새로 만들기 전에 기존 파일이 다른 곳에 있는지 확인해 주세요”라고 요청할 수 있습니다. 이는 공식 명령이 아닌 실습용 문장입니다.

바꿀 문장을 못 찾으면 무엇부터 봐야 할까요?

이번 릴리스는 edit가 oldString을 찾지 못할 때 파일의 가까운 줄을 보여 주거나, 변경이 이미 들어가 있다고 안내하도록 했습니다.[1] oldString은 교체하려던 기존 내용입니다. 오류 문구만 보고 수정 자체가 전혀 이루어지지 않았다고 판단하지 않는 편이 좋겠습니다.

첫 요청 뒤 파일이 달라졌다면 이전 내용을 기준으로 한 두 번째 요청은 맞지 않을 수 있습니다. 먼저 현재 파일에서 바꾸려던 부분을 읽고, 기대한 결과가 이미 있는지 비교해 보세요. 그다음 필요한 차이만 수정하게 합니다. 현재 상태 확인이 재요청보다 먼저입니다.

초보자는 오류 기록을 어떻게 남기면 좋을까요?

버튼 문구를 바꾸는 작은 작업이라면 바꾸기 전 문구, 요청한 문구, 현재 파일의 문구, 실제 화면의 문구를 나누어 적어 보세요. 파일에는 새 문구가 있는데 화면에는 예전 문구가 보인다면, 파일 교체만 반복하기보다 실행 중인 화면이 어떤 프로젝트를 보여 주는지 확인해야 합니다.

실습 제안이며 제품 결함 보고는 아닙니다. 오류 메시지는 다음 질문을 정하는 단서로 쓰되, 화면을 직접 확인하는 절차까지 대신하게 하지는 마세요. 수정이 끝난 뒤 새로고침하고 같은 버튼을 다시 누른 결과를 남겨 두시면 좋겠습니다.

긴 대화의 설정도 바로 바꿔야 할까요?

같은 릴리스에는 compaction.buffer를 토큰 수뿐 아니라 모델 문맥 크기의 백분율로 지정하는 기능도 있습니다. 공식 예시는 20%이며 모델의 문맥 공간 일부를 여유로 남기기 위한 설정입니다.[1] 예시 숫자를 모든 프로젝트에 맞는 권장값으로 받아들일 필요는 없습니다.

오류 하나를 만났다고 기억 관련 설정까지 동시에 바꾸면 무엇이 영향을 줬는지 구분하기 어렵습니다. 처음에는 작업 위치, 현재 파일, 실제 화면을 확인하고, 긴 대화 관리가 별도 문제일 때 설정을 검토해 보세요. 이는 문서 안내이며 직접 설치한 후기는 아닙니다.

FAQ: 이번 업데이트가 파일 오류를 모두 고치나요?

아닙니다. 공식 기록은 특정 실패 상황에서 안내를 개선했다고 설명합니다.[1] 파일이 왜 없어졌는지, 요청한 수정이 올바른지까지 자동으로 판단해 준다는 보장은 없습니다.

FAQ: 다른 AI 코딩 도구에도 적용할 수 있나요?

같은 오류 메시지나 기능이 있다고 단정할 수는 없습니다. 다만 현재 파일을 읽고, 기대한 상태와 비교하고, 필요한 차이만 고친 뒤 화면을 확인하는 순서는 연습 기준으로 삼을 수 있습니다. 첫 실행의 성공은 에이전트의 완료 문구보다 내가 확인한 결과로 남겨 보세요.

출처
[1] https://github.com/anomalyco/opencode/releases/tag/v2.2.5
관찰: 2026-11-02 KST