텍스트 편집기 도구

Claude는 Anthropic이 정의한 텍스트 편집기 도구를 사용하여 텍스트 파일을 보고 수정할 수 있으며, 코드나 기타 텍스트 문서를 디버깅, 수정 및 개선하는 데 도움을 줍니다. 이를 통해 Claude가 파일과 직접 상호작용하여 단순히 변경 사항을 제안하는 것이 아니라 실질적인 도움을 제공할 수 있습니다.

모델 호환성

모델	도구 버전
Claude 4.x 모델	`text_editor_20250728`
Claude Sonnet 3.7 (지원 중단)	`text_editor_20250124`

Claude 4 모델용 text_editor_20250728 도구에는 undo_edit 명령이 포함되어 있지 않습니다. 이 기능이 필요한 경우 Claude Sonnet 3.7(지원 중단)을 사용해야 합니다.

이전 도구 버전은 최신 모델과의 하위 호환성이 보장되지 않습니다. 항상 모델 버전에 해당하는 도구 버전을 사용하세요.

텍스트 편집기 도구를 사용해야 하는 경우

텍스트 편집기 도구를 사용하는 몇 가지 예시는 다음과 같습니다:

코드 디버깅: Claude가 구문 오류부터 논리 문제까지 코드의 버그를 식별하고 수정하도록 합니다.
코드 리팩토링: Claude가 대상 편집을 통해 코드 구조, 가독성 및 성능을 개선하도록 합니다.
문서 생성: Claude에게 코드베이스에 독스트링, 주석 또는 README 파일을 추가하도록 요청합니다.
테스트 생성: Claude가 구현에 대한 이해를 바탕으로 코드의 단위 테스트를 생성하도록 합니다.

텍스트 편집기 도구 사용하기

텍스트 편집기 도구는 다음과 같은 방식으로 사용할 수 있습니다:

텍스트 편집기 도구 명령

텍스트 편집기 도구는 파일을 보고 수정하기 위한 여러 명령을 지원합니다:

view

view 명령을 사용하면 Claude가 파일의 내용을 검사하거나 디렉토리의 내용을 나열할 수 있습니다. 전체 파일 또는 특정 줄 범위를 읽을 수 있습니다.

매개변수:

command: "view"여야 합니다
path: 볼 파일 또는 디렉토리의 경로
view_range (선택 사항): 볼 시작 및 끝 줄 번호를 지정하는 두 정수의 배열입니다. 줄 번호는 1부터 시작하며, 끝 줄에 -1을 지정하면 파일 끝까지 읽습니다. 이 매개변수는 디렉토리가 아닌 파일을 볼 때만 적용됩니다.

str_replace

str_replace 명령을 사용하면 Claude가 파일의 특정 문자열을 새 문자열로 교체할 수 있습니다. 이는 정밀한 편집을 위해 사용됩니다.

매개변수:

command: "str_replace"여야 합니다
path: 수정할 파일의 경로
old_str: 교체할 텍스트 (공백과 들여쓰기를 포함하여 정확히 일치해야 합니다)
new_str: 이전 텍스트 대신 삽입할 새 텍스트

create

create 명령을 사용하면 Claude가 지정된 내용으로 새 파일을 생성할 수 있습니다.

매개변수:

command: "create"여야 합니다
path: 새 파일을 생성할 경로
file_text: 새 파일에 작성할 내용

insert

insert 명령을 사용하면 Claude가 파일의 특정 위치에 텍스트를 삽입할 수 있습니다.

매개변수:

command: "insert"여야 합니다
path: 수정할 파일의 경로
insert_line: 텍스트를 삽입할 줄 번호 (파일 시작 부분에 삽입하려면 0)
insert_text: 삽입할 텍스트

undo_edit

undo_edit 명령을 사용하면 Claude가 파일에 대한 마지막 편집을 되돌릴 수 있습니다.

이 명령은 Claude Sonnet 3.7(지원 중단)에서만 사용할 수 있습니다. text_editor_20250728을 사용하는 Claude 4 모델에서는 지원되지 않습니다.

매개변수:

command: "undo_edit"여야 합니다
path: 마지막 편집을 취소할 파일의 경로

예시: 텍스트 편집기 도구로 구문 오류 수정하기

텍스트 편집기 도구 구현

텍스트 편집기 도구는 스키마 없는 도구로 구현됩니다. 이 도구를 사용할 때 다른 도구처럼 입력 스키마를 제공할 필요가 없습니다. 스키마는 Claude의 모델에 내장되어 있으며 수정할 수 없습니다.

도구 유형은 모델 버전에 따라 다릅니다:

Claude 4: type: "text_editor_20250728"
Claude Sonnet 3.7: type: "text_editor_20250124"

텍스트 편집기 도구를 구현할 때 다음 사항을 유의하세요:

보안: 이 도구는 로컬 파일 시스템에 접근할 수 있으므로 적절한 보안 조치를 구현하세요.
백업: 중요한 파일을 편집하기 전에 항상 백업을 생성하세요.
유효성 검사: 의도하지 않은 변경을 방지하기 위해 모든 입력의 유효성을 검사하세요.
고유 매칭: 의도하지 않은 편집을 방지하기 위해 교체가 정확히 하나의 위치와 일치하는지 확인하세요.

오류 처리

텍스트 편집기 도구를 사용할 때 다양한 오류가 발생할 수 있습니다. 다음은 이를 처리하는 방법에 대한 안내입니다:

구현 모범 사례 따르기

가격 및 토큰 사용량

The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you're using.

In addition to the base tokens, the following additional input tokens are needed for the text editor tool:

Tool	Additional input tokens
`text_editor_20250429` (Claude 4.x)	700 tokens
`text_editor_20250124` (Claude Sonnet 3.7 (deprecated))	700 tokens

도구 가격에 대한 더 자세한 정보는 도구 사용 가격을 참조하세요.

텍스트 편집기 도구를 다른 도구와 통합

텍스트 편집기 도구는 다른 Claude 도구와 함께 사용할 수 있습니다. 도구를 결합할 때 다음을 확인하세요:

사용 중인 모델과 도구 버전을 일치시키세요
요청에 포함된 모든 도구의 추가 토큰 사용량을 고려하세요

변경 로그

날짜	버전	변경 사항
2025년 7월 28일	`text_editor_20250728`	일부 문제를 수정하고 선택적 `max_characters` 매개변수를 추가한 업데이트된 텍스트 편집기 도구 출시. 그 외에는 `text_editor_20250429`와 동일합니다.
2025년 4월 29일	`text_editor_20250429`	Claude 4용 텍스트 편집기 도구 출시. 이 버전은 `undo_edit` 명령을 제거했지만 다른 모든 기능은 유지합니다. 도구 이름은 str_replace 기반 아키텍처를 반영하도록 업데이트되었습니다.
2025년 3월 13일	`text_editor_20250124`	독립형 텍스트 편집기 도구 문서 도입. 이 버전은 Claude Sonnet 3.7에 최적화되어 있지만 이전 버전과 동일한 기능을 갖추고 있습니다.
2024년 10월 22일	`text_editor_20241022`	Claude Sonnet 3.5(지원 종료)와 함께 텍스트 편집기 도구 최초 출시. `view`, `create`, , , 명령을 통해 파일 보기, 생성 및 편집 기능을 제공합니다.

다음 단계

텍스트 편집기 도구를 더 편리하고 강력하게 사용하는 방법에 대한 몇 가지 아이디어입니다:

개발 워크플로우에 통합: 텍스트 편집기 도구를 개발 도구나 IDE에 구축하세요
코드 리뷰 시스템 생성: Claude가 코드를 검토하고 개선하도록 하세요
디버깅 어시스턴트 구축: Claude가 코드의 문제를 진단하고 수정하는 데 도움을 줄 수 있는 시스템을 만드세요
파일 형식 변환 구현: Claude가 파일을 한 형식에서 다른 형식으로 변환하는 것을 도와주도록 하세요
문서화 자동화: Claude가 코드를 자동으로 문서화하는 워크플로우를 설정하세요

텍스트 편집기 도구로 애플리케이션을 구축하면서, Claude의 기능을 활용하여 개발 워크플로우와 생산성을 향상시키는 방법을 보게 되어 기대됩니다.

도구 사용 개요

Claude와 함께 사용할 도구 워크플로우를 구현하는 방법을 알아보세요.

편집기 구현 초기화
파일 읽기, 쓰기, 수정과 같은 파일 작업을 처리하는 헬퍼 함수를 만드세요. 실수로부터 복구할 수 있도록 백업 기능 구현을 고려하세요.

편집기 도구 호출 처리

명령 유형에 따라 Claude의 도구 호출을 처리하는 함수를 만드세요:

def handle_editor_tool(tool_call, model_version):
    input_params = tool_call.input
    command = input_params.get('command', '')
    file_path = input_params.get('path', '')
    
    if command == 'view':
        # Read and return file contents
        pass
    elif command == 'str_replace':
        # Replace text in file
        pass
    elif command == 'create':
        # Create new file
        pass
    elif command == 'insert':
        # Insert text at location
        pass
    elif command == 'undo_edit':
        # Check if it's a Claude 4 model
        if 'str_replace_based_edit_tool' in model_version:
            return {"error": "undo_edit command is not supported in Claude 4"}
        # Restore from backup for Claude 3.7
        pass

보안 조치 구현
유효성 검사 및 보안 검사를 추가하세요:
- 디렉토리 탐색을 방지하기 위해 파일 경로 유효성 검사
- 변경 전 백업 생성
- 오류를 우아하게 처리
- 권한 검사 구현

Claude의 응답 처리

Claude의 응답에서 도구 호출을 추출하고 처리하세요:

# Process tool use in Claude's response
for content in response.content:
    if content.type == "tool_use":
        # Execute the tool based on command
        result = handle_editor_tool(content)
        
        # Return result to Claude
        tool_result = {
            "type": "tool_result",
            "tool_use_id": content.id,
            "content": result
        }

str_replace

insert

undo_edit

모델 호환성

텍스트 편집기 도구를 사용해야 하는 경우

텍스트 편집기 도구 사용하기

텍스트 편집기 도구 명령

view

view 명령 예시

str_replace

str_replace 명령 예시

create

create 명령 예시

insert

insert 명령 예시

undo_edit

undo_edit 명령 예시

예시: 텍스트 편집기 도구로 구문 오류 수정하기

텍스트 편집기 도구 구현

오류 처리

파일을 찾을 수 없음

교체 대상이 여러 개 일치

구현 모범 사례 따르기

명확한 컨텍스트 제공

파일 경로를 명시적으로 지정

편집 전 백업 생성

가격 및 토큰 사용량

텍스트 편집기 도구를 다른 도구와 통합

변경 로그

다음 단계

교체 대상 일치 없음

권한 오류

고유 텍스트 교체를 신중하게 처리

변경 사항 검증