Loading...
    • 개발자 가이드
    • API 레퍼런스
    • MCP
    • 리소스
    • 릴리스 노트
    Search...
    ⌘K
    시작하기
    Claude 소개빠른 시작
    모델 및 가격
    모델 개요모델 선택Claude 4.6의 새로운 기능마이그레이션 가이드모델 지원 중단가격
    Claude로 구축하기
    기능 개요Messages API 사용중지 사유 처리프롬프트 모범 사례
    컨텍스트 관리
    컨텍스트 윈도우압축컨텍스트 편집
    기능
    프롬프트 캐싱확장 사고적응형 사고노력 수준메시지 스트리밍배치 처리인용다국어 지원토큰 카운팅임베딩비전PDF 지원Files API검색 결과구조화된 출력
    도구
    개요도구 사용 구현 방법세분화된 도구 스트리밍Bash 도구코드 실행 도구프로그래밍 방식 도구 호출컴퓨터 사용 도구텍스트 편집기 도구웹 페치 도구웹 검색 도구메모리 도구도구 검색 도구
    Agent Skills
    개요빠른 시작모범 사례엔터프라이즈용 SkillsAPI로 Skills 사용
    Agent SDK
    개요빠른 시작TypeScript SDKTypeScript V2 (미리보기)Python SDK마이그레이션 가이드
    API에서 MCP
    MCP 커넥터원격 MCP 서버
    서드파티 플랫폼의 Claude
    Amazon BedrockMicrosoft FoundryVertex AI
    프롬프트 엔지니어링
    개요프롬프트 생성기프롬프트 템플릿 사용프롬프트 개선기명확하고 직접적으로 작성예시 사용 (멀티샷 프롬프팅)Claude에게 생각하게 하기 (CoT)XML 태그 사용Claude에게 역할 부여 (시스템 프롬프트)복잡한 프롬프트 연결긴 컨텍스트 팁확장 사고 팁
    테스트 및 평가
    성공 기준 정의테스트 케이스 개발평가 도구 사용지연 시간 줄이기
    가드레일 강화
    환각 줄이기출력 일관성 높이기탈옥 방지스트리밍 거부프롬프트 유출 줄이기Claude 캐릭터 유지
    관리 및 모니터링
    Admin API 개요데이터 상주워크스페이스사용량 및 비용 APIClaude Code Analytics API제로 데이터 보존
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

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

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    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

    Learn

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

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    모델 및 가격

    마이그레이션 가이드

    이전 Claude 버전에서 Claude 4.6 모델로 마이그레이션하기 위한 가이드

    Claude 4.6으로 마이그레이션

    Claude Opus 4.6은 Claude 4.5의 거의 드롭인 대체 모델이지만, 알아야 할 몇 가지 주요 변경 사항이 있습니다. 새로운 기능의 전체 목록은 Claude 4.6의 새로운 기능을 참조하세요.

    모델 이름 업데이트

    # Opus 마이그레이션
    model="claude-opus-4-5"     # 이전
    model="claude-opus-4-6"       # 이후

    주요 변경 사항

    1. 프리필 제거: Claude 4.6 모델에서 어시스턴트 메시지 프리필은 400 오류를 반환합니다. 대신 구조화된 출력, 시스템 프롬프트 지침 또는 output_config.format을 사용하세요.

    2. 도구 매개변수 따옴표 처리: Claude 4.6 모델은 도구 호출 인수에서 약간 다른 JSON 문자열 이스케이프를 생성할 수 있습니다(예: 유니코드 이스케이프 또는 슬래시 이스케이프의 다른 처리). JSON 파서 대신 원시 문자열로 도구 호출 input을 파싱하는 경우, 파싱 로직을 확인하세요. 표준 JSON 파서(json.loads() 또는 JSON.parse() 등)는 이러한 차이를 자동으로 처리합니다.

    권장 변경 사항

    필수는 아니지만 경험을 개선할 수 있습니다:

    1. 적응형 사고로 마이그레이션: thinking: {type: "enabled", budget_tokens: N}은 Claude 4.6 모델에서 더 이상 사용되지 않으며 향후 모델 릴리스에서 제거될 예정입니다. thinking: {type: "adaptive"}로 전환하고 effort 매개변수를 사용하여 사고 깊이를 제어하세요. 적응형 사고를 참조하세요.

      response = client.beta.messages.create(
          model="claude-opus-4-5",
          max_tokens=16000,
          thinking={
              "type": "enabled",
              "budget_tokens": 32000
          },
          betas=["interleaved-thinking-2025-05-14"],
          messages=[...]
      )

      이 마이그레이션은 client.beta.messages.create에서 client.messages.create로도 이동합니다 — 적응형 사고와 effort는 GA 기능이며 베타 SDK 네임스페이스나 베타 헤더가 필요하지 않습니다.

    2. effort 베타 헤더 제거: effort 매개변수는 이제 GA입니다. 요청에서 betas=["effort-2025-11-24"]를 제거하세요.

    3. 세분화된 도구 스트리밍 베타 헤더 제거: 세분화된 도구 스트리밍은 이제 GA입니다. 요청에서 betas=["fine-grained-tool-streaming-2025-05-14"]를 제거하세요.

    4. 인터리브 사고 베타 헤더 제거: 적응형 사고는 자동으로 인터리브 사고를 활성화합니다. 요청에서 betas=["interleaved-thinking-2025-05-14"]를 제거하세요.

    5. output_config.format으로 마이그레이션: 구조화된 출력을 사용하는 경우, output_format={...}을 output_config={"format": {...}}로 업데이트하세요. 이전 매개변수는 계속 작동하지만 더 이상 사용되지 않으며 향후 모델 릴리스에서 제거될 예정입니다.

    Claude 4.1 이하에서 Claude 4.6으로 마이그레이션

    Opus 4.1, Sonnet 4 또는 이전 모델에서 직접 Claude 4.6으로 마이그레이션하는 경우, 위의 Claude 4.6 주요 변경 사항과 이 섹션의 추가 변경 사항을 적용하세요.

    # Opus 4.1에서
    model="claude-opus-4-1-20250805"    # 이전
    model="claude-opus-4-6"               # 이후
    
    # Sonnet 4에서
    model="claude-sonnet-4-20250514"    # 이전
    model="claude-opus-4-6"              # 이후
    
    # Sonnet 3.7에서
    model="claude-3-7-sonnet-20250219"  # 이전
    model="claude-opus-4-6"              # 이후

    추가 주요 변경 사항

    1. 샘플링 매개변수

      이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.

      temperature 또는 top_p 중 하나만 사용하세요. 둘 다 사용하지 마세요:

      # 이전 - Claude 4+ 모델에서 오류가 발생합니다
      response = client.messages.create(
          model="claude-3-7-sonnet-20250219",
          temperature=0.7,
          top_p=0.9,  # 둘 다 사용할 수 없음
          ...
      )
      
      # 이후
      response = client.messages.create(
          model="claude-opus-4-6",
          temperature=0.7,  # temperature 또는 top_p 중 하나만 사용, 둘 다 사용하지 않음
          ...
      )
    2. 도구 버전

      이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.

      최신 도구 버전으로 업데이트하세요. undo_edit 명령을 사용하는 코드를 제거하세요.

      # 이전
      tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
      
      # 이후
      tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
      • 텍스트 편집기: text_editor_20250728과 str_replace_based_edit_tool을 사용하세요. 자세한 내용은 텍스트 편집기 도구 문서를 참조하세요.
      • 코드 실행: code_execution_20250825로 업그레이드하세요. 마이그레이션 지침은 코드 실행 도구 문서를 참조하세요.
    3. refusal 중지 사유 처리

      애플리케이션을 업데이트하여 refusal 중지 사유를 처리하세요:

      response = client.messages.create(...)
      
      if response.stop_reason == "refusal":
          # 거부를 적절히 처리
          pass
    4. model_context_window_exceeded 중지 사유 처리

      Claude 4.5+ 모델은 요청된 max_tokens 제한이 아닌 컨텍스트 윈도우 제한에 도달하여 생성이 중지될 때 model_context_window_exceeded 중지 사유를 반환합니다. 이 새로운 중지 사유를 처리하도록 애플리케이션을 업데이트하세요:

      response = client.messages.create(...)
      
      if response.stop_reason == "model_context_window_exceeded":
          # 컨텍스트 윈도우 제한을 적절히 처리
          pass
    5. 도구 매개변수 처리 (후행 줄바꿈)

      Claude 4.5+ 모델은 이전에 제거되었던 도구 호출 문자열 매개변수의 후행 줄바꿈을 보존합니다. 도구가 도구 호출 매개변수에 대한 정확한 문자열 매칭에 의존하는 경우, 로직이 후행 줄바꿈을 올바르게 처리하는지 확인하세요.

    6. 동작 변경에 맞게 프롬프트 업데이트

      Claude 4+ 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가지며 명시적인 지시가 필요합니다. 최적화 가이드는 프롬프팅 모범 사례를 검토하세요.

    추가 권장 변경 사항

    • 레거시 베타 헤더 제거: token-efficient-tools-2025-02-19와 output-128k-2025-02-19를 제거하세요 — 모든 Claude 4+ 모델에는 토큰 효율적 도구 사용이 내장되어 있으며 이러한 헤더는 효과가 없습니다.

    Claude 4.6 마이그레이션 체크리스트

    • 모델 ID를 claude-opus-4-6으로 업데이트
    • 주요 변경: 어시스턴트 메시지 프리필 제거 (400 오류 반환); 대신 구조화된 출력 또는 output_config.format 사용
    • 권장: thinking: {type: "enabled", budget_tokens: N}에서 thinking: {type: "adaptive"}로 마이그레이션하고 effort 매개변수 사용 (budget_tokens는 더 이상 사용되지 않으며 향후 릴리스에서 제거 예정)
    • 도구 호출 JSON 파싱이 표준 JSON 파서를 사용하는지 확인
    • effort-2025-11-24 베타 헤더 제거 (effort는 이제 GA)
    • fine-grained-tool-streaming-2025-05-14 베타 헤더 제거
    • interleaved-thinking-2025-05-14 베타 헤더 제거
    • output_format을 output_config.format으로 마이그레이션 (해당하는 경우)
    • Claude 4.1 이하에서 마이그레이션하는 경우: 샘플링 매개변수를 temperature 또는 top_p 중 하나만 사용하도록 업데이트
    • Claude 4.1 이하에서 마이그레이션하는 경우: 도구 버전 업데이트 (text_editor_20250728, code_execution_20250825)
    • Claude 4.1 이하에서 마이그레이션하는 경우: refusal 중지 사유 처리
    • Claude 4.1 이하에서 마이그레이션하는 경우: model_context_window_exceeded 중지 사유 처리
    • Claude 4.1 이하에서 마이그레이션하는 경우: 후행 줄바꿈에 대한 도구 문자열 매개변수 처리 확인
    • Claude 4.1 이하에서 마이그레이션하는 경우: 레거시 베타 헤더 제거 (token-efficient-tools-2025-02-19, output-128k-2025-02-19)
    • 프롬프팅 모범 사례에 따라 프롬프트 검토 및 업데이트
    • 프로덕션 배포 전 개발 환경에서 테스트

    Claude Sonnet 4.5로 마이그레이션

    Claude Sonnet 4.5는 강력한 지능과 빠른 성능을 결합하여 일상적인 코딩, 분석 및 콘텐츠 작업에 이상적입니다.

    기능의 전체 개요는 모델 개요를 참조하세요.

    Sonnet 4.5 가격은 입력 토큰 100만 개당 $3, 출력 토큰 100만 개당 $15입니다. 자세한 내용은 Claude 가격을 참조하세요.

    모델 이름 업데이트:

    # Sonnet 4에서
    model="claude-sonnet-4-20250514"        # 이전
    model="claude-sonnet-4-5-20250929"      # 이후
    
    # Sonnet 3.7에서
    model="claude-3-7-sonnet-20250219"      # 이전
    model="claude-sonnet-4-5-20250929"      # 이후

    확장 사고 활성화 고려 — 코딩 및 추론 작업에서 상당한 성능 향상을 제공합니다 (기본적으로 비활성화):

    response = client.messages.create(
        model="claude-sonnet-4-5-20250929",
        max_tokens=16000,
        thinking={"type": "enabled", "budget_tokens": 10000},
        messages=[...]
    )

    주요 변경 사항

    이러한 주요 변경 사항은 Claude 3.x Sonnet 모델에서 마이그레이션할 때 적용됩니다.

    1. 샘플링 매개변수

      이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.

      temperature 또는 top_p 중 하나만 사용하세요. 둘 다 사용하지 마세요.

    2. 도구 버전

      이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.

      최신 도구 버전(text_editor_20250728, code_execution_20250825)으로 업데이트하세요. undo_edit 명령을 사용하는 코드를 제거하세요.

    3. refusal 중지 사유 처리

      애플리케이션을 업데이트하여 refusal 중지 사유를 처리하세요.

    4. 동작 변경에 맞게 프롬프트 업데이트

      Claude 4 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가집니다. 최적화 가이드는 프롬프팅 모범 사례를 검토하세요.

    Sonnet 4.5 마이그레이션 체크리스트

    • 모델 ID를 claude-sonnet-4-5-20250929으로 업데이트
    • 주요 변경: 도구 버전을 최신으로 업데이트 (text_editor_20250728, code_execution_20250825) — 레거시 버전 미지원 (3.x에서 마이그레이션하는 경우)
    • 주요 변경: undo_edit 명령을 사용하는 코드 제거 (해당하는 경우)
    • 주요 변경: 샘플링 매개변수를 temperature 또는 top_p 중 하나만 사용하도록 업데이트 (3.x에서 마이그레이션하는 경우)
    • 애플리케이션에서 새로운 refusal 중지 사유 처리
    • 프롬프팅 모범 사례에 따라 프롬프트 검토 및 업데이트
    • 복잡한 추론 작업을 위한 확장 사고 활성화 고려
    • 프로덕션 배포 전 개발 환경에서 테스트

    Claude Haiku 4.5로 마이그레이션

    Claude Haiku 4.5는 거의 최첨단 성능을 갖춘 가장 빠르고 지능적인 Haiku 모델로, 대화형 애플리케이션과 대량 처리를 위한 프리미엄 모델 품질을 제공합니다.

    기능의 전체 개요는 모델 개요를 참조하세요.

    Haiku 4.5 가격은 입력 토큰 100만 개당 $1, 출력 토큰 100만 개당 $5입니다. 자세한 내용은 Claude 가격을 참조하세요.

    모델 이름 업데이트:

    # Haiku 3.5에서
    model="claude-3-5-haiku-20241022"      # 이전
    model="claude-haiku-4-5-20251001"      # 이후

    새로운 속도 제한 검토: Haiku 4.5는 Haiku 3.5와 별도의 속도 제한을 가집니다. 자세한 내용은 속도 제한 문서를 참조하세요.

    확장 사고 활성화 고려 — 코딩 및 추론 작업에서 상당한 성능 향상을 제공합니다 (기본적으로 비활성화):

    response = client.messages.create(
        model="claude-haiku-4-5-20251001",
        max_tokens=16000,
        thinking={"type": "enabled", "budget_tokens": 5000},
        messages=[...]
    )

    확장 사고는 프롬프트 캐싱 효율성에 영향을 미칩니다.

    새로운 기능 탐색: 컨텍스트 인식, 증가된 출력 용량(64K 토큰), 더 높은 지능 및 향상된 속도에 대한 자세한 내용은 모델 개요를 참조하세요.

    주요 변경 사항

    이러한 주요 변경 사항은 Claude 3.x Haiku 모델에서 마이그레이션할 때 적용됩니다.

    1. 샘플링 매개변수

      이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.

      temperature 또는 top_p 중 하나만 사용하세요. 둘 다 사용하지 마세요.

    2. 도구 버전

      이것은 Claude 3.x 모델에서의 주요 변경 사항입니다.

      최신 도구 버전(text_editor_20250728, code_execution_20250825)으로 업데이트하세요. undo_edit 명령을 사용하는 코드를 제거하세요.

    3. refusal 중지 사유 처리

      애플리케이션을 업데이트하여 refusal 중지 사유를 처리하세요.

    4. 동작 변경에 맞게 프롬프트 업데이트

      Claude 4 모델은 더 간결하고 직접적인 커뮤니케이션 스타일을 가집니다. 최적화 가이드는 프롬프팅 모범 사례를 검토하세요.

    Haiku 4.5 마이그레이션 체크리스트

    • 모델 ID를 claude-haiku-4-5-20251001로 업데이트
    • 주요 변경: 도구 버전을 최신으로 업데이트 (text_editor_20250728, code_execution_20250825) — 레거시 버전 미지원
    • 주요 변경: undo_edit 명령을 사용하는 코드 제거 (해당하는 경우)
    • 주요 변경: 샘플링 매개변수를 temperature 또는 top_p 중 하나만 사용하도록 업데이트
    • 애플리케이션에서 새로운 refusal 중지 사유 처리
    • 새로운 속도 제한 검토 및 조정 (Haiku 3.5와 별도)
    • 프롬프팅 모범 사례에 따라 프롬프트 검토 및 업데이트
    • 복잡한 추론 작업을 위한 확장 사고 활성화 고려
    • 프로덕션 배포 전 개발 환경에서 테스트

    도움이 필요하신가요?

    • 자세한 사양은 API 문서를 확인하세요
    • 성능 비교는 모델 기능을 검토하세요
    • API 업데이트는 API 릴리스 노트를 검토하세요
    • 마이그레이션 중 문제가 발생하면 지원팀에 문의하세요

    Was this page helpful?

    • Claude 4.6으로 마이그레이션
    • Claude 4.1 이하에서 Claude 4.6으로 마이그레이션
    • Claude 4.6 마이그레이션 체크리스트
    • Claude Sonnet 4.5로 마이그레이션
    • Sonnet 4.5 마이그레이션 체크리스트
    • Claude Haiku 4.5로 마이그레이션
    • Haiku 4.5 마이그레이션 체크리스트