로드 중

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

로드 중

Claude에는 처음부터 직접 만들 필요가 없는 내장 도구가 하나 있습니다. 바로 텍스트 편집 도구입니다. 이 도구는 Claude가 일반적인 텍스트 편집기에서 작업하는 것과 마찬가지로 파일과 디렉터리를 다룰 수 있는 능력을 부여합니다.

텍스트 편집 도구로 할 수 있는 일

텍스트 편집 도구는 Claude에게 파일 조작을 위한 포괄적인 기능 세트를 제공합니다:

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

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

이는 Claude의 능력을 극적으로 확장시켜, 사실상 Claude가 곧바로 소프트웨어 엔지니어로서 행동할 수 있는 힘을 부여합니다.

구현 요구 사항 이해하기

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

text_editor_tool_schema JSON 스키마와 세 개의 물음표가 표시된 "Function" 상자는 여러분이 작성해야 하는 함수를 보여줍니다.

커스텀 도구를 사용할 때는 일반적으로 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는 필요에 따라 파일을 읽고, 수정하고, 생성하기 위해 이 도구를 사용합니다.

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

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

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

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

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

텍스트 편집 도구를 사용하는 이유

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

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

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