The text edit tool · Google Cloud의 Vertex AI를 활용한 Claude

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

Claude에는 처음부터 직접 만들 필요가 없는 내장 도구가 하나 제공됩니다: 바로 텍스트 편집 도구입니다. 이 도구는 Claude가 표준 텍스트 편집기에서처럼 파일 및 디렉터리를 다룰 수 있는 능력을 제공합니다.

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

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

파일 또는 디렉터리 내용 보기
파일 내 특정 줄 범위 보기
파일 내 텍스트 교체
새 파일 생성
파일 내 특정 줄에 텍스트 삽입
파일에 대한 최근 편집 취소

이는 Claude의 능력을 극적으로 확장시키며, 본질적으로 처음부터 소프트웨어 엔지니어로서 행동할 수 있는 힘을 부여합니다.

구현 요구 사항 이해하기

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

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

스키마 버전

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

python

def get_text_edit_schema(model):
    if model.startswith("claude-3-7-sonnet"):
        return {
            "type": "text_editor_20250124",
            "name": "str_replace_editor",
        }
    elif model.startswith("claude-3-5-sonnet"):
        return {
            "type": "text_editor_20241022", 
            "name": "str_replace_editor",
        }

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

실전 예제

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

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

텍스트 편집 도구를 사용하여 파일 보기
내용 읽기
요약 제공

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

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

기존 main.py 파일 보기
파이 계산 함수를 포함한 새로운 구현으로 내용 교체
적절한 단위 테스트가 포함된 새로운 test.py 파일 생성

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

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

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

본질적으로, 텍스트 편집 도구는 고급 AI 기반 코드 편집기의 많은 기능을 자신의 애플리케이션 내에서 재현할 수 있게 해주며, Claude가 파일 시스템에서 파일을 읽고, 쓰고, 수정할 수 있는 진정한 코딩 어시스턴트가 될 수 있는 능력을 부여합니다.