중요 참고: 모든 모델 버전에 대한 도구 버전 문자열은 여기에서 확인할 수 있습니다: https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool(새 탭에서 열림)
Claude에는 처음부터 직접 만들 필요가 없는 내장 도구가 하나 있습니다. 바로 텍스트 편집 도구입니다. 이 도구는 Claude에게 일반적인 텍스트 편집기에서와 마찬가지로 파일 및 디렉터리 작업을 수행할 수 있는 능력을 부여합니다.
텍스트 편집 도구로 할 수 있는 일
텍스트 편집 도구는 Claude에게 포괄적인 파일 조작 기능 세트를 제공합니다:
- 파일 또는 디렉터리 내용 보기
- 파일에서 특정 범위의 줄 보기
- 파일 내 텍스트 대체
- 새 파일 생성
- 파일의 특정 줄에 텍스트 삽입

이는 Claude의 능력을 획기적으로 확장하며, 사실상 처음부터 소프트웨어 엔지니어로서 행동할 수 있는 힘을 부여합니다.
구현 요구사항 이해하기
여기서 약간 혼란스러운 부분이 생깁니다. 도구 스키마는 Claude에 내장되어 있지만, 실제 구현은 여전히 직접 제공해야 합니다. 이렇게 생각해보세요 - Claude는 파일 작업을 어떻게 요청해야 하는지는 알고 있지만, 그 작업을 실제로 수행하는 코드는 여러분이 작성해야 합니다.

다른 도구를 사용할 때는 JSON 스키마와 함수 구현을 모두 직접 작성합니다. 텍스트 편집 도구의 경우, Claude가 스키마 지식을 제공하지만, 파일 생성, 디렉터리 읽기, 텍스트 대체 등 Claude의 요청을 처리하는 함수는 여러분이 작성해야 합니다.
스키마 버전
기본 스키마는 Claude에 내장되어 있지만, 요청을 할 때는 작은 스키마 스텁을 포함해야 합니다. 정확한 스키마는 사용 중인 Claude 모델에 따라 달라집니다:
def get_text_edit_schema(model):
if model.startswith("claude-3"):
return {
"type": "text_editor_20250124",
"name": "str_replace_editor",
}
else:
return {
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool",
}
Claude는 이 작은 스키마를 보고 내부적으로 이를 자동으로 전체 텍스트 편집 도구 사양으로 확장합니다.
실습 예제
텍스트 편집 도구가 실제로 작동하는 모습을 살펴보겠습니다. Claude에게 파일 작업을 요청하면, 필요에 따라 파일을 읽고, 수정하고, 생성하는 데 이 도구를 사용합니다.
예를 들어, Claude에게 "./main.py 파일을 열어서 내용을 요약해줘"라고 요청하면 Claude는 다음을 수행합니다:
- 텍스트 편집 도구를 사용하여 파일을 봅니다
- 내용을 읽습니다
- 요약을 제공합니다
더 나아가 Claude에게 파일을 수정하도록 요청할 수도 있습니다. 예를 들어: "./main.py 파일을 열어서 소수점 5자리까지 파이(pi)를 계산하는 함수를 작성해줘. 그런 다음 구현을 테스트할 ./test.py 파일을 생성해줘."
Claude는 다음을 수행합니다:
- 기존 main.py 파일을 확인합니다
- 파이 계산 함수를 포함한 새로운 구현으로 내용을 교체합니다
- 적절한 단위 테스트가 포함된 새로운 test.py 파일을 생성합니다
텍스트 편집 도구를 사용해야 하는 이유
최신 코드 편집기에는 이미 AI 어시스턴트가 내장되어 있는데 왜 이 도구가 필요한지 궁금할 수 있습니다. 텍스트 편집 도구는 다음과 같은 상황에서 유용해집니다:
- 프로그래밍 방식으로 파일을 편집해야 하는 애플리케이션을 구축하는 경우
- 완전한 기능을 갖춘 코드 편집기에 접근할 수 없는 환경에서 작업하는 경우
- 파일 편집 기능을 Claude 기반 애플리케이션에 직접 통합하고 싶은 경우
본질적으로, 텍스트 편집 도구를 사용하면 멋진 AI 기반 코드 편집기의 많은 기능을 여러분 자신의 애플리케이션 내에서 재현할 수 있으며, Claude가 파일 시스템과 상호작용하는 방식을 세밀하게 제어할 수 있습니다.