Claude Academy
로드 중

텍스트 편집 도구

강의 325분

중요 참고 사항: 모든 모델 버전의 도구 버전 문자열은 여기에서 확인할 수 있습니다: https://platform.claude.com/docs/en/agents-and-tools/tool-use/text-editor-tool

Claude에는 처음부터 직접 만들 필요가 없는 내장 도구가 하나 있습니다. 바로 텍스트 편집 도구입니다. 이 도구를 사용하면 Claude가 일반 텍스트 편집기에서처럼 파일 및 디렉터리를 다룰 수 있습니다.

텍스트 편집 도구가 할 수 있는 것

텍스트 편집 도구는 Claude에게 다음과 같은 종합적인 파일 조작 기능을 제공합니다:

  • 파일 또는 디렉터리 내용 보기
  • 파일의 특정 범위 줄 보기
  • 파일 내 텍스트 교체
  • 새 파일 생성
  • 파일의 특정 줄에 텍스트 삽입

텍스트 편집 도구는 Claude에 내장되어 있지만 스키마만 내장되어 있으므로, 실제 도구의 구현은 사용자가 제공해야 합니다.

이를 통해 Claude의 능력이 크게 확장되며, 기본적으로 소프트웨어 엔지니어 역할을 바로 수행할 수 있는 힘을 갖게 됩니다.

구현 요구 사항 이해하기

여기서 다소 혼란스러울 수 있는 부분이 있습니다. 도구 스키마는 Claude에 내장되어 있지만, 실제 구현은 여전히 직접 제공해야 합니다. 이렇게 생각해 보세요. Claude는 파일 작업을 요청하는 방법은 알고 있지만, 실제로 그 작업을 수행하는 코드는 여러분이 작성해야 합니다.

text_editor_tool_schema JSON 스키마와, 물음표 세 개가 표시된 "함수" 상자. 이 함수는 여러분이 직접 작성해야 합니다.

사용자 정의 도구를 사용할 때는 일반적으로 JSON 스키마와 함수 구현을 모두 직접 작성합니다. 하지만 텍스트 편집 도구를 사용하면 Claude가 스키마 지식을 제공하지만, 파일 생성, 디렉터리 읽기, 텍스트 교체 등 Claude의 요청을 처리하는 함수는 여러분이 작성해야 합니다.

스키마 버전

텍스트 편집 도구를 사용할 때는 작은 스키마 스텁을 포함해야 하며, 정확한 스키마는 사용 중인 Claude 모델에 따라 다릅니다:

python
def get_text_edit_schema(model):
    if model.startswith("claude-haiku-4-5"):
        return {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool",
        }

Claude는 이 작은 스키마 스텁을 "command", "path", view_range, old_str, new_str, file_text를 포함하는 훨씬 더 길고 상세한 사양으로 확장합니다.

Claude는 이 작은 스키마를 자동으로 확장하여 사용 가능한 모든 매개변수와 작업을 포함하는 훨씬 더 크고 상세한 사양으로 만듭니다.

실전 예제

텍스트 편집 도구가 실제로 작동하는 모습을 살펴보겠습니다. Claude에게 파일 작업을 요청하면, 필요에 따라 이 도구를 사용해 파일을 읽고, 수정하고, 생성합니다.

예를 들어, Claude에게 "./main.py 파일을 열어서 내용을 요약해줘"라고 요청하면 Claude는 다음과 같이 동작합니다:

  1. 텍스트 편집 도구를 사용해 파일을 확인합니다
  2. 내용을 읽습니다
  3. 요약을 제공합니다

여기서 한 걸음 더 나아가 Claude에게 파일을 수정하도록 요청할 수도 있습니다. 예를 들어: "./main.py 파일을 열어서 pi를 소수점 5번째 자리까지 계산하는 함수를 작성해줘. 그런 다음 ./test.py 파일을 만들어서 이 구현을 테스트해줘."

Claude는 다음과 같이 동작합니다:

  1. 기존 main.py 파일을 확인합니다
  2. pi 계산 함수를 포함한 새로운 구현으로 내용을 교체합니다
  3. 적절한 단위 테스트가 포함된 새로운 test.py 파일을 생성합니다

텍스트 편집 도구를 사용하는 이유는 무엇일까요?

최신 코드 편집기에는 이미 AI 어시스턴트가 내장되어 있는데 왜 이 도구가 필요한지 궁금할 수 있습니다. 텍스트 편집 도구는 다음과 같은 상황에서 유용해집니다:

  • 파일을 프로그래밍 방식으로 편집해야 하는 애플리케이션을 구축하는 경우
  • 완전한 기능을 갖춘 코드 편집기에 접근할 수 없는 환경에서 작업하는 경우
  • 파일 편집 기능을 Claude 기반 애플리케이션에 직접 통합하고 싶은 경우

결국 텍스트 편집 도구를 사용하면 고급 AI 기반 코드 편집기의 기능 상당 부분을 여러분 자신의 애플리케이션 안에서 재현할 수 있으며, Claude에게 파일 시스템의 파일을 읽고, 쓰고, 수정할 수 있는 진정한 코딩 어시스턴트로서의 능력을 부여할 수 있습니다.