Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
"zero data retention"(제로 데이터 보존), 즉 ZDR이 이 기능에 어떻게 적용되는지는 API 및 데이터 보존을 참조하세요.
Claude는 Anthropic 스키마 텍스트 편집기 도구를 사용하여 텍스트 파일을 보고 수정할 수 있으며, 코드나 기타 텍스트 문서를 디버깅하고, 수정하고, 개선하는 데 도움을 줄 수 있습니다. 이를 통해 Claude는 단순히 변경 사항을 제안하는 것이 아니라 파일과 직접 상호작용하여 실질적인 지원을 제공할 수 있습니다.
모델 지원에 대해서는 도구 참조를 참조하세요.
텍스트 편집기 도구를 사용하는 몇 가지 예시는 다음과 같습니다:
Messages API를 사용하여 Claude에게 텍스트 편집기 도구(이름: str_replace_based_edit_tool)를 제공합니다.
큰 파일을 볼 때 잘림(truncation)을 제어하기 위해 선택적으로 max_characters 매개변수를 지정할 수 있습니다.
max_characters는 text_editor_20250728 및 이후 버전의 텍스트 편집기 도구에서만 호환됩니다.
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
tools=[
{
"type": "text_editor_20250728",
"name": "str_replace_based_edit_tool",
"max_characters": 10000,
}
],
messages=[
{
"role": "user",
"content": "There's a syntax error in my primes.py file. Can you help me fix it?",
}
],
)
print(response)텍스트 편집기 도구는 다음과 같은 방식으로 사용합니다:
Claude에게 텍스트 편집기 도구와 사용자 프롬프트 제공
Claude가 도구를 사용하여 파일 또는 디렉터리 검토
view 명령을 사용하여 파일 내용을 검토하거나 디렉터리 내용을 나열합니다view 명령이 포함된 tool_use 콘텐츠 블록이 포함됩니다view 명령 실행 및 결과 반환
max_characters 매개변수가 지정된 경우, 파일 내용을 해당 길이로 잘라냅니다tool_result 콘텐츠 블록이 포함된 새 user 메시지로 대화를 계속하여 결과를 Claude에게 반환합니다Claude가 도구를 사용하여 파일 수정
str_replace와 같은 명령을 사용하여 변경하거나 insert를 사용하여 특정 줄 번호에 텍스트를 추가할 수 있습니다.str_replace 명령을 사용하는 경우, Claude는 이전 텍스트와 이를 대체할 새 텍스트로 올바른 형식의 도구 사용 요청을 구성합니다편집 실행 및 결과 반환
Claude가 분석 및 설명 제공
텍스트 편집기 도구는 파일을 보고 수정하기 위한 여러 명령을 지원합니다:
view 명령을 사용하면 Claude가 파일의 내용을 검토하거나 디렉터리의 내용을 나열할 수 있습니다. 전체 파일 또는 특정 범위의 줄을 읽을 수 있습니다.
매개변수:
command: "view"여야 합니다path: 볼 파일 또는 디렉터리의 경로view_range (선택 사항): 볼 시작 및 끝 줄 번호를 지정하는 두 정수의 배열입니다. 줄 번호는 1부터 시작하며, 끝 줄에 -1을 지정하면 파일 끝까지 읽습니다. 이 매개변수는 디렉터리가 아닌 파일을 볼 때만 적용됩니다.str_replace 명령을 사용하면 Claude가 파일의 특정 문자열을 새 문자열로 교체할 수 있습니다. 이는 정밀한 편집을 수행하는 데 사용됩니다.
매개변수:
command: "str_replace"여야 합니다path: 수정할 파일의 경로old_str: 교체할 텍스트(공백과 들여쓰기를 포함하여 정확히 일치해야 함)new_str: 이전 텍스트 대신 삽입할 새 텍스트create 명령을 사용하면 Claude가 지정된 내용으로 새 파일을 생성할 수 있습니다.
매개변수:
command: "create"여야 합니다path: 새 파일이 생성될 경로file_text: 새 파일에 쓸 내용insert 명령을 사용하면 Claude가 파일의 특정 위치에 텍스트를 삽입할 수 있습니다.
매개변수:
command: "insert"여야 합니다path: 수정할 파일의 경로insert_line: 텍스트를 삽입할 기준이 되는 줄 번호(파일 시작 부분은 0)insert_text: 삽입할 텍스트이 예시는 Claude가 텍스트 편집기 도구를 사용하여 Python 파일의 구문 오류를 수정하는 방법을 보여줍니다.
먼저, 애플리케이션이 Claude에게 텍스트 편집기 도구와 구문 오류를 수정하라는 프롬프트를 제공합니다:
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}],
messages=[
{
"role": "user",
"content": "There's a syntax error in my primes.py file. Can you help me fix it?",
}
],
)
print(response)Claude는 먼저 텍스트 편집기 도구를 사용하여 파일을 봅니다:
{
"id": "msg_01XAbCDeFgHiJkLmNoPQrStU",
"model": "claude-opus-5",
"stop_reason": "tool_use",
"role": "assistant",
"content": [
{
"type": "text",
"text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue."
},
{
"type": "tool_use",
"id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
"name": "str_replace_based_edit_tool",
"input": {
"command": "view",
"path": "primes.py"
}
}
]
}그런 다음 애플리케이션은 파일을 읽고 그 내용을 Claude에게 반환해야 합니다:
response = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}],
messages=[
{
"role": "user",
"content": "There's a syntax error in my primes.py file. Can you help me fix it?",
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": "I'll help you fix the syntax error in your primes.py file. First, let me take a look at the file to identify the issue.",
},
{
"type": "tool_use",
"id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
"name": "str_replace_based_edit_tool",
"input": {"command": "view", "path": "primes.py"},
},
],
},
{
"role": "user",
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrStU",
"content": '1: def is_prime(n):\n2: """Check if a number is prime."""\n3: if n <= 1:\n4: return False\n5: if n <= 3:\n6: return True\n7: if n % 2 == 0 or n % 3 == 0:\n8: return False\n9: i = 5\n10: while i * i <= n:\n11: if n % i == 0 or n % (i + 2) == 0:\n12: return False\n13: i += 6\n14: return True\n15: \n16: def get_primes(limit):\n17: """Generate a list of prime numbers up to the given limit."""\n18: primes = []\n19: for num in range(2, limit + 1)\n20: if is_prime(num):\n21: primes.append(num)\n22: return primes\n23: \n24: def main():\n25: """Main function to demonstrate prime number generation."""\n26: limit = 100\n27: prime_list = get_primes(limit)\n28: print(f"Prime numbers up to {limit}:")\n29: print(prime_list)\n30: print(f"Found {len(prime_list)} prime numbers.")\n31: \n32: if __name__ == "__main__":\n33: main()',
}
],
},
],
)
print(response)줄 번호
앞의 예시에서 view 도구 결과에는 각 줄 앞에 줄 번호가 붙은 파일 내용이 포함되어 있습니다(예: "1: def is_prime(n):"). 줄 번호는 필수는 아니지만, 파일의 특정 섹션을 검토하기 위한 view_range 매개변수와 정확한 위치에 내용을 추가하기 위한 insert_line 매개변수를 성공적으로 사용하는 데 필수적입니다.
Claude는 구문 오류를 식별하고 str_replace 명령을 사용하여 수정합니다:
{
"id": "msg_01VwXyZAbCdEfGhIjKlMnO",
"model": "claude-opus-5",
"stop_reason": "tool_use",
"role": "assistant",
"content": [
{
"type": "text",
"text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you."
},
{
"type": "tool_use",
"id": "toolu_01PqRsTuVwXyZAbCdEfGh",
"name": "str_replace_based_edit_tool",
"input": {
"command": "str_replace",
"path": "primes.py",
"old_str": " for num in range(2, limit + 1)",
"new_str": " for num in range(2, limit + 1):"
}
}
]
}그런 다음 애플리케이션은 편집을 수행하고 결과를 반환해야 합니다:
response = client.messages.create(
model="claude-opus-5",
max_tokens=1024,
tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}],
messages=[
# 이전 메시지들...
{
"role": "assistant",
"content": [
{
"type": "text",
"text": "I found the syntax error in your primes.py file. In the `get_primes` function, there is a missing colon (:) at the end of the for loop line. Let me fix that for you.",
},
{
"type": "tool_use",
"id": "toolu_01PqRsTuVwXyZAbCdEfGh",
"name": "str_replace_based_edit_tool",
"input": {
"command": "str_replace",
"path": "primes.py",
"old_str": " for num in range(2, limit + 1)",
"new_str": " for num in range(2, limit + 1):",
},
},
],
},
{
"role": "user",
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_01PqRsTuVwXyZAbCdEfGh",
"content": "Successfully replaced text at exactly one location.",
}
],
},
],
)
print(response)마지막으로, Claude는 수정 사항에 대한 완전한 설명을 제공합니다:
{
"id": "msg_01IjKlMnOpQrStUvWxYzAb",
"model": "claude-opus-5",
"stop_reason": "end_turn",
"role": "assistant",
"content": [
{
"type": "text",
"text": "I've fixed the syntax error in your primes.py file. The issue was in the `get_primes` function at line 19. There was a missing colon (:) at the end of the for loop line.\n\nHere's what I changed:\n\nFrom:\n```python\nfor num in range(2, limit + 1)\n```\n\nTo:\n```python\nfor num in range(2, limit + 1):\n```\n\nIn Python, a colon is required at the end of statements that start a new code block, such as for loops, if statements, function definitions, etc. Without the colon, Python raises a syntax error because it doesn't know where the code block begins.\n\nYour code should now run correctly. The function will properly generate a list of prime numbers up to the specified limit."
}
]
}텍스트 편집기 도구는 스키마가 없는(schema-less) 도구로 구현됩니다. 이 도구를 사용할 때는 다른 도구처럼 입력 스키마를 제공할 필요가 없습니다. 스키마는 Claude 모델에 내장되어 있으며 수정할 수 없습니다.
도구 유형은 Claude 4 및 이후 모델의 경우 type: "text_editor_20250728"입니다.
편집기 구현 초기화
파일 읽기, 쓰기, 수정과 같은 파일 작업을 처리하는 헬퍼 함수를 만듭니다. 실수로부터 복구할 수 있도록 백업 기능 구현을 고려하세요.
편집기 도구 호출 처리
명령 유형에 따라 Claude의 도구 호출을 처리하는 함수를 만듭니다:
def handle_editor_tool(tool_call):
input_params = tool_call.input
command = input_params.get("command", "")
file_path = input_params.get("path", "")
if command == "view":
# 파일 내용을 읽고 반환
pass
elif command == "str_replace":
# 파일의 텍스트를 교체
pass
elif command == "create":
# 새 파일 생성
pass
elif command == "insert":
# 지정 위치에 텍스트 삽입
pass보안 조치 구현
검증 및 보안 검사를 추가합니다:
Claude의 응답 처리
Claude의 응답에서 도구 호출을 추출하고 처리합니다:
# Claude의 응답에서 도구 사용 처리
for content in response.content:
if content.type == "tool_use":
# 명령에 따라 도구 실행
result = handle_editor_tool(content)
# 결과를 Claude에 반환
tool_result = {
"type": "tool_result",
"tool_use_id": content.id,
"content": result,
}텍스트 편집기 도구를 구현할 때 다음 사항을 유의하세요:
텍스트 편집기 도구를 사용할 때 다양한 오류가 발생할 수 있습니다. 다음은 이를 처리하는 방법에 대한 안내입니다:
텍스트 편집기 도구는 Claude와 함께 사용되는 다른 도구와 동일한 가격 구조를 사용합니다. 사용 중인 Claude 모델을 기준으로 표준 입력 및 출력 토큰 가격 책정을 따릅니다.
기본 토큰 외에도 텍스트 편집기 도구에는 다음과 같은 추가 입력 토큰이 필요합니다:
| 도구 | 추가 입력 토큰 |
|---|---|
text_editor_20250429 (Claude 4.x) | 700 토큰 |
도구 가격에 대한 자세한 내용은 도구 사용 가격을 참조하세요.
텍스트 편집기 도구를 다른 Claude 도구와 함께 사용할 수 있습니다. 도구를 결합할 때는 다음을 확인하세요:
| 날짜 | 버전 | 변경 사항 |
|---|---|---|
| 2025년 7월 28일 | text_editor_20250728 | 일부 문제를 수정하고 선택적 max_characters 매개변수를 추가한 업데이트된 텍스트 편집기 도구 출시. 그 외에는 text_editor_20250429와 동일합니다. |
| 2025년 4월 29일 | text_editor_20250429 | Claude 4용 텍스트 편집기 도구 출시. 이 버전은 undo_edit 명령을 제거했지만 다른 모든 기능은 유지합니다. 도구 이름이 str_replace 기반 아키텍처를 반영하도록 업데이트되었습니다. |
| 2025년 3월 13일 | text_editor_20250124 | 독립적인 텍스트 편집기 도구 문서 도입. 이 버전은 Claude Sonnet 3.7에 최적화되어 있지만 이전 버전과 동일한 기능을 가지고 있습니다. |
| 2024년 10월 22일 | text_editor_20241022 | Claude Sonnet 3.5와 함께 텍스트 편집기 도구 최초 출시(지원 종료됨, 모델 지원 중단 참조). view, create, str_replace, insert, undo_edit 명령을 통해 파일을 보고, 생성하고, 편집하는 기능을 제공합니다. |
텍스트 편집기 도구를 더 편리하고 강력하게 사용하는 방법에 대한 몇 가지 아이디어는 다음과 같습니다:
텍스트 편집기 도구를 사용하면 Claude가 코드 베이스와 직접 작업할 수 있으며, 디버깅부터 자동화된 문서화까지 다양한 워크플로우를 지원합니다.
Was this page helpful?