Claude가 텍스트 파일을 보고 수정할 수 있는 Anthropic 정의 텍스트 에디터 도구를 사용하여 코드나 기타 텍스트 문서를 디버그, 수정 및 개선하는 방법을 알아보세요.
text_editor_20250728
text_editor_20250124
text_editor_20241022
computer-use-2024-10-22
베타 헤더가 필요합니다.텍스트 에디터 도구는 Claude 4 모델과 Claude Sonnet 3.7에서 일반적으로 사용할 수 있습니다.text_editor_20250728
도구는 undo_edit
명령을 포함하지 않습니다. 이 기능이 필요한 경우 해당 도구 버전과 함께 Claude Sonnet 3.7 또는 Sonnet 3.5를 사용해야 합니다.str_replace_based_edit_tool
이라는 이름)를 제공합니다.큰 파일을 볼 때 잘림을 제어하기 위해 선택적으로 max_characters
매개변수를 지정할 수 있습니다.max_characters
는 text_editor_20250728
및 이후 버전의 텍스트 에디터 도구와만 호환됩니다.Claude에게 텍스트 에디터 도구와 사용자 프롬프트 제공
Claude가 도구를 사용하여 파일이나 디렉토리 검사
view
명령을 사용하여 파일 내용을 검사하거나 디렉토리 내용을 나열합니다view
명령이 포함된 tool_use
콘텐츠 블록이 포함됩니다view 명령 실행 및 결과 반환
max_characters
매개변수가 지정된 경우 파일 내용을 해당 길이로 자릅니다tool_result
콘텐츠 블록이 포함된 새 user
메시지로 대화를 계속하여 Claude에게 결과를 반환합니다Claude가 도구를 사용하여 파일 수정
str_replace
와 같은 명령을 사용하여 변경하거나 insert
를 사용하여 특정 줄 번호에 텍스트를 추가할 수 있습니다.str_replace
명령을 사용하는 경우 Claude는 이전 텍스트와 교체할 새 텍스트로 적절히 형식화된 도구 사용 요청을 구성합니다편집 실행 및 결과 반환
Claude가 분석 및 설명 제공
view
명령을 사용하면 Claude가 파일의 내용을 검사하거나 디렉토리의 내용을 나열할 수 있습니다. 전체 파일이나 특정 줄 범위를 읽을 수 있습니다.
매개변수:
command
: “view”여야 합니다path
: 보려는 파일 또는 디렉토리의 경로view_range
(선택사항): 보려는 시작 및 끝 줄 번호를 지정하는 두 정수의 배열입니다. 줄 번호는 1부터 시작하며, 끝 줄에 대한 -1은 파일 끝까지 읽는다는 의미입니다. 이 매개변수는 파일을 볼 때만 적용되며 디렉토리에는 적용되지 않습니다.view 명령 예시
str_replace
명령을 사용하면 Claude가 파일의 특정 문자열을 새 문자열로 바꿀 수 있습니다. 이는 정확한 편집을 위해 사용됩니다.
매개변수:
command
: “str_replace”여야 합니다path
: 수정할 파일의 경로old_str
: 교체할 텍스트 (공백과 들여쓰기를 포함하여 정확히 일치해야 함)new_str
: 이전 텍스트 대신 삽입할 새 텍스트str_replace 명령 예시
create
명령을 사용하면 Claude가 지정된 내용으로 새 파일을 생성할 수 있습니다.
매개변수:
command
: “create”여야 합니다path
: 새 파일을 생성할 경로file_text
: 새 파일에 쓸 내용create 명령 예시
insert
명령을 사용하면 Claude가 파일의 특정 위치에 텍스트를 삽입할 수 있습니다.
매개변수:
command
: “insert”여야 합니다path
: 수정할 파일의 경로insert_line
: 텍스트를 삽입할 줄 번호 (파일 시작의 경우 0)new_str
: 삽입할 텍스트insert 명령 예시
undo_edit
명령을 사용하면 Claude가 파일에 대한 마지막 편집을 되돌릴 수 있습니다.
text_editor_20250728
을 사용하는 Claude 4 모델에서는 지원되지 않습니다.command
: “undo_edit”여야 합니다path
: 마지막 편집을 취소할 파일의 경로undo_edit 명령 예시
view
도구 결과는 각 줄에 줄 번호가 앞에 붙은 파일 내용을 포함합니다 (예: “1: def is_prime(n):”). 줄 번호는 필수는 아니지만 파일의 특정 섹션을 검사하기 위해 view_range
매개변수를 성공적으로 사용하고 정확한 위치에 내용을 추가하기 위해 insert_line
매개변수를 사용하는 데 필수적입니다.str_replace
명령을 사용하여 수정합니다:type: "text_editor_20250728"
type: "text_editor_20250124"
type: "text_editor_20241022"
에디터 구현 초기화
에디터 도구 호출 처리
보안 조치 구현
Claude의 응답 처리
파일을 찾을 수 없음
tool_result
에서 적절한 오류 메시지를 반환합니다:교체를 위한 여러 일치
str_replace
명령이 파일의 여러 위치와 일치하면 적절한 오류 메시지를 반환합니다:교체를 위한 일치 없음
str_replace
명령이 파일의 어떤 텍스트와도 일치하지 않으면 적절한 오류 메시지를 반환합니다:권한 오류
명확한 컨텍스트 제공
파일 경로를 명시적으로 지정
편집하기 전에 백업 생성
고유한 텍스트 교체를 신중하게 처리
str_replace
명령은 교체할 텍스트와 정확히 일치해야 합니다. 애플리케이션은 이전 텍스트에 대해 정확히 하나의 일치가 있는지 확인하거나 적절한 오류 메시지를 제공해야 합니다.변경사항 검증
Tool | Additional input tokens |
---|---|
text_editor_20250429 (Claude 4) | 700 tokens |
text_editor_20250124 (Claude Sonnet 3.7) | 700 tokens |
text_editor_20241022 (Claude Sonnet 3.5 (deprecated)) | 700 tokens |
날짜 | 버전 | 변경사항 |
---|---|---|
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 (deprecated)와 함께 텍스트 에디터 도구의 초기 릴리스. view , create , str_replace , insert 및 undo_edit 명령을 통해 파일을 보고, 생성하고, 편집하는 기능을 제공합니다. |