Claude Code CLI 파일 편집 오류 완벽 해결 가이드: "File has been unexpectedly modified" 극복하기

// 상대 경로로 작은 변경 수행
Edit: src / components / Header.tsx;

old_string: import { useState, useEffect } from "react";
new_string: import { useEffect, useState } from "react";

// 절대 경로로 실제 편집
Edit: C:/projects/my-app/src/components/Header.tsx

old_string: export default function Header() {
new_string: export default function Header() {
  const [isScrolled, setIsScrolled] = useState(false)
  const [menuOpen, setMenuOpen] = useState(false)

  useEffect(() => {
    const handleScroll = () => setIsScrolled(window.scrollY > 50)
    window.addEventListener('scroll', handleScroll)
    return () => window.removeEventListener('scroll', handleScroll)
  }, [])

// 바로 절대 경로로 시도
Edit: C:/projects/portfolio/app/profile/page.tsx
old: export default function ProfilePage()
new: export default function ProfilePage() {
  const [editing, setEditing] = useState(false)
}

// 결과: "File has been unexpectedly modified" 오류

// 1단계: 워밍업
Edit: app/profile/page.tsx
old: 'use client'
new: 'use client'

// 2단계: 실제 편집
Edit: C:/projects/portfolio/app/profile/page.tsx
old: export default function ProfilePage() {
  return (
new: export default function ProfilePage() {
  const [editing, setEditing] = useState(false)
  const [userData, setUserData] = useState({})

  return (

src/
└── utils/
    └── api/
        └── client/
            └── fetcher.ts  ← 편집 대상

// 1단계: 상대 경로로 워밍업
Edit: src/utils/api/client/fetcher.ts
old: export const
new: export const

// 2단계: 절대 경로로 실제 편집
Edit: C:/Users/dev/projects/my-api/src/utils/api/client/fetcher.ts
old: export const fetcher = async (url: string) => {
  return fetch(url).then(r => r.json())
}
new: export const fetcher = async <T>(url: string): Promise<T> => {
  const response = await fetch(url)
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${response.statusText}`)
  }
  return response.json()
}

const filesToEdit = [
  { rel: 'components/Button.tsx', abs: 'C:/proj/components/Button.tsx' },
  { rel: 'components/Input.tsx', abs: 'C:/proj/components/Input.tsx' },
  { rel: 'components/Form.tsx', abs: 'C:/proj/components/Form.tsx' },
]

// 각 파일마다 2단계 워크플로우 적용
filesToEdit.forEach(file => {
  // 1. 워밍업
  Edit: file.rel (minor change)

  // 2. 실제 편집
  Edit: file.abs (main changes)
})

try {
  Edit(absolutePath);
} catch (error) {
  if (error.includes("unexpectedly modified")) {
    // 즉시 워밍업 재시도
    Edit(relativePath); // warmup
    await sleep(2000); // 안정화 대기
    Edit(absolutePath); // retry
  }
}

// 더 명확한 변경으로 워밍업
Edit: src/component.tsx
old: // Comment line 1
new: // Updated comment with timestamp: 2025-11-17

// 워밍업 시 충분한 대기 시간 확보
Edit: large - file.ts(warmup);
await sleep(5000); // 5초 대기
Edit: C: /path/ot / large - file.ts(actual);