Loading...
    • 개발자 가이드
    • API 참고자료
    • MCP
    • 리소스
    • 릴리스 노트
    Search...
    ⌘K

    첫 번째 단계

    Claude 소개빠른 시작

    모델 및 가격

    모델 개요모델 선택하기Claude 4.5의 새로운 기능Claude 4.5로 마이그레이션모델 지원 중단가격 정책

    Claude로 빌드하기

    기능 개요Messages API 작업컨텍스트 윈도우프롬프트 작성 모범 사례

    기능

    프롬프트 캐싱컨텍스트 편집확장된 사고스트리밍 메시지배치 처리인용다국어 지원토큰 카운팅임베딩비전PDF 지원Files API검색 결과Google Sheets 애드온

    도구

    개요도구 사용을 구현하는 방법토큰 효율적인 도구 사용세밀한 도구 스트리밍Bash 도구코드 실행 도구컴퓨터 사용 도구텍스트 편집기 도구웹 페치 도구웹 검색 도구메모리 도구

    에이전트 스킬

    개요빠른 시작Skill 작성 모범 사례Skills 사용하기

    Agent SDK

    개요Agent SDK 참조 - TypeScriptPython SDK

    가이드

    스트리밍 입력권한 처리세션 관리Agent SDK 호스팅시스템 프롬프트 수정하기SDK에서의 MCP사용자 정의 도구SDK의 서브에이전트SDK의 슬래시 명령어SDK의 에이전트 스킬비용 및 사용량 추적할 일 목록SDK의 플러그인

    API의 MCP

    MCP 커넥터원격 MCP 서버

    타사 플랫폼의 Claude

    Amazon BedrockVertex AI

    프롬프트 엔지니어링

    개요프롬프트 생성기프롬프트 템플릿 사용하기프롬프트 개선기명확하고 직접적으로예시(멀티샷 프롬프팅) 사용Claude가 생각하도록 하기(CoT)XML 태그 사용Claude에게 역할 부여하기 (시스템 프롬프트)Claude의 응답 미리 채우기복잡한 프롬프트 체이닝긴 컨텍스트 팁확장 사고 팁

    테스트 및 평가

    성공 기준 정의하기테스트 케이스 개발평가 도구 사용하기지연 시간 줄이기

    보안 강화

    환각 현상 줄이기출력 일관성 높이기탈옥 완화handle-streaming-refusals프롬프트 유출 감소Claude의 캐릭터 유지

    관리 및 모니터링

    Admin API 개요사용량 및 비용 APIClaude Code Analytics API
    Console
    도구

    텍스트 편집기 도구

    Claude가 텍스트 파일을 보고 수정할 수 있는 Anthropic 정의 텍스트 편집기 도구를 사용하여 코드 또는 기타 텍스트 문서를 디버깅, 수정 및 개선하도록 도와줍니다.

    Claude는 Anthropic 정의 텍스트 편집기 도구를 사용하여 텍스트 파일을 보고 수정할 수 있으며, 코드 또는 기타 텍스트 문서를 디버깅, 수정 및 개선하는 데 도움을 줍니다. 이를 통해 Claude는 파일과 직접 상호작용하여 변경 사항을 제안하는 것이 아니라 실제 지원을 제공할 수 있습니다.

    모델 호환성

    모델도구 버전
    Claude 4.x 모델text_editor_20250728
    Claude Sonnet 3.7 (deprecated)text_editor_20250124

    Claude 4 모델용 text_editor_20250728 도구에는 undo_edit 명령이 포함되지 않습니다. 이 기능이 필요한 경우 Claude Sonnet 3.7 (deprecated)을 사용해야 합니다.

    이전 도구 버전은 최신 모델과의 하위 호환성이 보장되지 않습니다. 항상 모델 버전에 해당하는 도구 버전을 사용하세요.

    텍스트 편집기 도구를 사용할 때

    텍스트 편집기 도구를 사용할 때의 몇 가지 예시는 다음과 같습니다:

    • 코드 디버깅: Claude가 구문 오류부터 논리 오류까지 코드의 버그를 식별하고 수정하도록 합니다.
    • 코드 리팩토링: Claude가 대상 편집을 통해 코드 구조, 가독성 및 성능을 개선하도록 합니다.
    • 문서 생성: Claude가 코드베이스에 docstring, 주석 또는 README 파일을 추가하도록 요청합니다.
    • 테스트 생성: Claude가 구현에 대한 이해를 바탕으로 코드에 대한 단위 테스트를 생성하도록 합니다.

    텍스트 편집기 도구 사용

    텍스트 편집기 도구는 다음과 같은 방식으로 사용할 수 있습니다:

    1. 1

      Claude에 텍스트 편집기 도구와 사용자 프롬프트 제공

      • API 요청에 텍스트 편집기 도구를 포함합니다
      • 파일을 검사하거나 수정해야 할 수 있는 사용자 프롬프트를 제공합니다(예: "코드의 구문 오류를 수정할 수 있나요?")
    2. 2

      Claude가 도구를 사용하여 파일 또는 디렉토리 검사

      • Claude는 무엇을 살펴봐야 하는지 평가하고 view 명령을 사용하여 파일 내용을 검사하거나 디렉토리 내용을 나열합니다
      • API 응답에는 view 명령이 포함된 tool_use 콘텐츠 블록이 포함됩니다
    3. 3

      view 명령 실행 및 결과 반환

      • Claude의 도구 사용 요청에서 파일 또는 디렉토리 경로를 추출합니다
      • 파일의 내용을 읽거나 디렉토리 내용을 나열합니다
      • 도구 구성에서 max_characters 매개변수를 지정한 경우 파일 내용을 해당 길이로 자릅니다
      • tool_result 콘텐츠 블록이 포함된 새 user 메시지로 대화를 계속하여 결과를 Claude에게 반환합니다
    4. 4

      Claude가 도구를 사용하여 파일 수정

      • 파일 또는 디렉토리를 검사한 후 Claude는 변경을 수행하기 위해 str_replace와 같은 명령이나 특정 줄 번호에 텍스트를 추가하기 위해 insert를 사용할 수 있습니다
      • Claude가 str_replace 명령을 사용하면 Claude는 이전 텍스트와 이를 대체할 새 텍스트를 사용하여 올바르게 형식화된 도구 사용 요청을 구성합니다
    5. 5

      편집 실행 및 결과 반환

      • Claude의 도구 사용 요청에서 파일 경로, 이전 텍스트 및 새 텍스트를 추출합니다
      • 파일에서 텍스트 교체를 수행합니다
      • 결과를 Claude에게 반환합니다
    6. 6

      Claude가 분석 및 설명 제공

      • 파일을 검사하고 가능하면 편집한 후 Claude는 발견한 내용과 수행한 변경 사항에 대한 완전한 설명을 제공합니다

    텍스트 편집기 도구 명령

    텍스트 편집기 도구는 파일을 보고 수정하기 위한 여러 명령을 지원합니다:

    view

    view 명령을 사용하면 Claude가 파일의 내용을 검사하거나 디렉토리의 내용을 나열할 수 있습니다. 전체 파일 또는 특정 줄 범위를 읽을 수 있습니다.

    매개변수:

    • command: "view"여야 합니다
    • path: 보려는 파일 또는 디렉토리의 경로
    • view_range (선택사항): 보려는 시작 및 끝 줄 번호를 지정하는 두 개의 정수 배열입니다. 줄 번호는 1부터 시작하며, 끝 줄에 -1을 사용하면 파일의 끝까지 읽습니다. 이 매개변수는 디렉토리가 아닌 파일을 볼 때만 적용됩니다.

    str_replace

    str_replace 명령을 사용하면 Claude가 파일의 특정 문자열을 새 문자열로 바꿀 수 있습니다. 이는 정확한 편집을 수행하는 데 사용됩니다.

    매개변수:

    • command: "str_replace"여야 합니다
    • path: 수정할 파일의 경로
    • old_str: 바꿀 텍스트(공백 및 들여쓰기 포함하여 정확히 일치해야 함)
    • new_str: 이전 텍스트 대신 삽입할 새 텍스트

    create

    create 명령을 사용하면 Claude가 지정된 내용으로 새 파일을 만들 수 있습니다.

    매개변수:

    • command: "create"여야 합니다
    • path: 새 파일을 만들 경로
    • file_text: 새 파일에 쓸 내용

    insert

    insert 명령을 사용하면 Claude가 파일의 특정 위치에 텍스트를 삽입할 수 있습니다.

    매개변수:

    • command: "insert"여야 합니다
    • path: 수정할 파일의 경로
    • insert_line: 텍스트를 삽입할 줄 번호(파일 시작 부분의 경우 0)
    • new_str: 삽입할 텍스트

    undo_edit

    undo_edit 명령을 사용하면 Claude가 파일에 대한 마지막 편집을 되돌릴 수 있습니다.

    이 명령은 Claude Sonnet 3.7 (deprecated)에서만 사용 가능합니다. text_editor_20250728을 사용하는 Claude 4 모델에서는 지원되지 않습니다.

    매개변수:

    • command: "undo_edit"여야 합니다
    • path: 마지막 편집을 취소할 파일의 경로

    예시: 텍스트 편집기 도구로 구문 오류 수정


    텍스트 편집기 도구 구현

    텍스트 편집기 도구는 스키마 없는 도구로 구현됩니다. 이 도구를 사용할 때 다른 도구와 달리 입력 스키마를 제공할 필요가 없습니다. 스키마는 Claude의 모델에 내장되어 있으며 수정할 수 없습니다.

    도구 유형은 모델 버전에 따라 다릅니다:

    • Claude 4: type: "text_editor_20250728"
    • Claude Sonnet 3.7: type: "text_editor_20250124"
    1. 1

      편집기 구현 초기화

      파일 읽기, 쓰기 및 수정과 같은 파일 작업을 처리하는 도우미 함수를 만듭니다. 실수로부터 복구하기 위해 백업 기능을 구현하는 것을 고려하세요.

    2. 2

      편집기 도구 호출 처리

      명령 유형에 따라 Claude의 도구 호출을 처리하는 함수를 만듭니다:

      def handle_editor_tool(tool_call, model_version):
          input_params = tool_call.input
          command = input_params.get('command', '')
          file_path = input_params.get('path', '')
          
          if command == 'view':
              # Read and return file contents
              pass
          elif command == 'str_replace':
              # Replace text in file
              pass
          elif command == 'create':
              # Create new file
              pass
          elif command == 'insert':
              # Insert text at location
              pass
          elif command == 'undo_edit':
              # Check if it's a Claude 4 model
              if 'str_replace_based_edit_tool' in model_version:
                  return {"error": "undo_edit command is not supported in Claude 4"}
              # Restore from backup for Claude 3.7
              pass
    3. 3

      보안 조치 구현

      검증 및 보안 검사를 추가합니다:

      • 디렉토리 순회를 방지하기 위해 파일 경로를 검증합니다
      • 변경 전에 백업을 만듭니다
      • 오류를 정상적으로 처리합니다
      • 권한 검사를 구현합니다
    4. 4

      Claude의 응답 처리

      Claude의 응답에서 도구 호출을 추출하고 처리합니다:

      # Process tool use in Claude's response
      for content in response.content:
          if content.type == "tool_use":
              # Execute the tool based on command
              result = handle_editor_tool(content)
              
              # Return result to Claude
              tool_result = {
                  "type": "tool_result",
                  "tool_use_id": content.id,
                  "content": result
              }

    텍스트 편집기 도구를 구현할 때 다음을 염두에 두세요:

    1. 보안: 도구는 로컬 파일 시스템에 액세스할 수 있으므로 적절한 보안 조치를 구현하세요.
    2. 백업: 중요한 파일을 편집하기 전에 항상 백업을 만드세요.
    3. 검증: 의도하지 않은 변경을 방지하기 위해 모든 입력을 검증하세요.
    4. 고유 일치: 교체가 정확히 한 위치와 일치하는지 확인하여 의도하지 않은 편집을 방지하세요.

    오류 처리

    텍스트 편집기 도구를 사용할 때 다양한 오류가 발생할 수 있습니다. 다음은 이를 처리하는 방법에 대한 지침입니다:

    구현 모범 사례 따르기


    가격 및 토큰 사용

    The text editor tool uses the same pricing structure as other tools used with Claude. It follows the standard input and output token pricing based on the Claude model you're using.

    In addition to the base tokens, the following additional input tokens are needed for the text editor tool:

    ToolAdditional input tokens
    text_editor_20250429 (Claude 4.x)700 tokens
    text_editor_20250124 (Claude Sonnet 3.7 (deprecated))700 tokens

    도구 가격에 대한 자세한 정보는 도구 사용 가격을 참조하세요.

    텍스트 편집기 도구를 다른 도구와 통합

    텍스트 편집기 도구는 다른 Claude 도구와 함께 사용할 수 있습니다. 도구를 결합할 때 다음을 확인하세요:

    • 도구 버전을 사용 중인 모델과 일치시킵니다
    • 요청에 포함된 모든 도구에 대한 추가 토큰 사용을 고려합니다

    변경 로그

    날짜버전변경 사항
    2025년 7월 28일text_editor_20250728일부 문제를 수정하고 선택적 max_characters 매개변수를 추가하는 업데이트된 텍스트 편집기 도구 출시. text_editor_20250429와 동일합니다.
    2025년 4월 29일text_editor_20250429Claude 4용 텍스트 편집기 도구 출시. 이 버전은 undo_edit 명령을 제거하지만 다른 모든 기능을 유지합니다. 도구 이름이 str_replace 기반 아키텍처를 반영하도록 업데이트되었습니다.
    2025년 3월 13일text_editor_20250124독립형 텍스트 편집기 도구 문서 소개. 이 버전은 Claude Sonnet 3.7에 최적화되어 있지만 이전 버전과 동일한 기능을 가지고 있습니다.
    2024년 10월 22일text_editor_20241022Claude Sonnet 3.5 (retired)를 사용한 텍스트 편집기 도구의 초기 출시. view, create, str_replace, insert 및 undo_edit 명령을 통해 파일을 보고, 만들고, 편집할 수 있는 기능을 제공합니다.

    다음 단계

    텍스트 편집기 도구를 더 편리하고 강력한 방식으로 사용하는 방법에 대한 몇 가지 아이디어는 다음과 같습니다:

    • 개발 워크플로우와 통합: 텍스트 편집기 도구를 개발 도구 또는 IDE에 통합합니다
    • 코드 검토 시스템 만들기: Claude가 코드를 검토하고 개선하도록 합니다
    • 디버깅 어시스턴트 구축: Claude가 코드의 문제를 진단하고 수정하는 데 도움을 주는 시스템을 만듭니다
    • 파일 형식 변환 구현: Claude가 파일을 한 형식에서 다른 형식으로 변환하는 데 도움을 주도록 합니다
    • 문서 자동화: Claude가 코드를 자동으로 문서화하는 워크플로우를 설정합니다

    텍스트 편집기 도구를 사용하여 애플리케이션을 구축할 때 Claude의 기능을 활용하여 개발 워크플로우와 생산성을 향상시키는 방법을 보는 것을 기대합니다.

    도구 사용 개요

    Claude와 함께 사용할 도구 워크플로우를 구현하는 방법을 알아봅니다.

    토큰 효율적인 도구 사용

    Claude Sonnet 3.7을 사용할 때 도구 사용으로 인한 지연 시간과 비용을 줄입니다.

    Bash 도구

    Claude로 셸 명령을 실행합니다.

      © 2025 ANTHROPIC PBC

      Products

      • Claude
      • Claude Code
      • Max plan
      • Team plan
      • Enterprise plan
      • Download app
      • Pricing
      • Log in

      Features

      • Claude and Slack
      • Claude in Excel

      Models

      • Opus
      • Sonnet
      • Haiku

      Solutions

      • AI agents
      • Code modernization
      • Coding
      • Customer support
      • Education
      • Financial services
      • Government
      • Life sciences

      Claude Developer Platform

      • Overview
      • Developer docs
      • Pricing
      • Amazon Bedrock
      • Google Cloud’s Vertex AI
      • Console login

      Learn

      • Blog
      • Catalog
      • Courses
      • Use cases
      • Connectors
      • Customer stories
      • Engineering at Anthropic
      • Events
      • Powered by Claude
      • Service partners
      • Startups program

      Company

      • Anthropic
      • Careers
      • Economic Futures
      • Research
      • News
      • Responsible Scaling Policy
      • Security and compliance
      • Transparency

      Help and security

      • Availability
      • Status
      • Support center

      Terms and policies

      • Privacy policy
      • Responsible disclosure policy
      • Terms of service: Commercial
      • Terms of service: Consumer
      • Usage policy

      Products

      • Claude
      • Claude Code
      • Max plan
      • Team plan
      • Enterprise plan
      • Download app
      • Pricing
      • Log in

      Features

      • Claude and Slack
      • Claude in Excel

      Models

      • Opus
      • Sonnet
      • Haiku

      Solutions

      • AI agents
      • Code modernization
      • Coding
      • Customer support
      • Education
      • Financial services
      • Government
      • Life sciences

      Claude Developer Platform

      • Overview
      • Developer docs
      • Pricing
      • Amazon Bedrock
      • Google Cloud’s Vertex AI
      • Console login

      Learn

      • Blog
      • Catalog
      • Courses
      • Use cases
      • Connectors
      • Customer stories
      • Engineering at Anthropic
      • Events
      • Powered by Claude
      • Service partners
      • Startups program

      Company

      • Anthropic
      • Careers
      • Economic Futures
      • Research
      • News
      • Responsible Scaling Policy
      • Security and compliance
      • Transparency

      Help and security

      • Availability
      • Status
      • Support center

      Terms and policies

      • Privacy policy
      • Responsible disclosure policy
      • Terms of service: Commercial
      • Terms of service: Consumer
      • Usage policy
      © 2025 ANTHROPIC PBC