Loading...
    • Panduan Pengembang
    • Referensi API
    • MCP
    • Sumber daya
    • Catatan rilis
    Search...
    ⌘K
    Langkah pertama
    Pengenalan ClaudeMulai cepat
    Model & harga
    Ikhtisar modelMemilih modelYang baru di Claude 4.6Panduan migrasiPenghentian modelHarga
    Bangun dengan Claude
    Ikhtisar fiturMenggunakan Messages APIMenangani alasan berhentiPraktik terbaik prompting
    Manajemen konteks
    Jendela konteksKompresiPengeditan konteks
    Kemampuan
    Caching promptPemikiran diperpanjangPemikiran adaptifUpayaStreaming pesanPemrosesan batchKutipanDukungan multibahasaPenghitungan tokenEmbeddingsVisiDukungan PDFFiles APIHasil pencarianOutput terstruktur
    Alat
    IkhtisarCara mengimplementasikan penggunaan alatStreaming alat berbutir halusAlat BashAlat eksekusi kodePemanggilan alat terprogramAlat penggunaan komputerAlat editor teksAlat pengambilan webAlat pencarian webAlat memoriAlat pencarian alat
    Keterampilan Agen
    IkhtisarMulai cepatPraktik terbaikKeterampilan untuk perusahaanMenggunakan Keterampilan dengan API
    Agent SDK
    IkhtisarMulai cepatTypeScript SDKTypeScript V2 (pratinjau)Python SDKPanduan migrasi
    MCP di API
    Konektor MCPServer MCP jarak jauh
    Claude di platform pihak ketiga
    Amazon BedrockMicrosoft FoundryVertex AI
    Rekayasa prompt
    IkhtisarGenerator promptGunakan template promptPenyempurna promptJadilah jelas dan langsungGunakan contoh (prompting multishot)Biarkan Claude berpikir (CoT)Gunakan tag XMLBerikan Claude peran (prompt sistem)Rantai prompt kompleksTips konteks panjangTips pemikiran diperpanjang
    Uji & evaluasi
    Tentukan kriteria kesuksesanKembangkan kasus ujiMenggunakan alat evaluasiMengurangi latensi
    Perkuat penjaga
    Kurangi halusinasiTingkatkan konsistensi outputMitigasi jailbreakStreaming penolakanKurangi kebocoran promptJaga Claude tetap dalam karakter
    Administrasi dan pemantauan
    Ikhtisar Admin APIResidensi dataRuang kerjaAPI penggunaan dan biayaClaude Code Analytics APIRetensi data nol
    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
    Model & harga

    Panduan migrasi

    Panduan untuk bermigrasi ke model Claude 4.6 dari versi Claude sebelumnya

    Bermigrasi ke Claude 4.6

    Claude Opus 4.6 adalah pengganti yang hampir drop-in untuk Claude 4.5, dengan beberapa perubahan yang merusak yang perlu diperhatikan. Untuk daftar lengkap fitur baru, lihat Apa yang baru di Claude 4.6.

    Perbarui nama model Anda

    # Migrasi Opus
    model="claude-opus-4-5"     # Sebelum
    model="claude-opus-4-6"       # Sesudah

    Perubahan yang merusak

    1. Penghapusan prefill: Mengisi pesan asisten sebelumnya mengembalikan kesalahan 400 pada model Claude 4.6. Gunakan keluaran terstruktur, instruksi prompt sistem, atau output_config.format sebagai gantinya.

    2. Penawaran parameter alat: Model Claude 4.6 mungkin menghasilkan pelarian string JSON yang sedikit berbeda dalam argumen panggilan alat (misalnya, penanganan pelarian Unicode atau pelarian garis miring yang berbeda). Jika Anda mengurai input panggilan alat sebagai string mentah daripada menggunakan pengurai JSON, verifikasi logika penguraian Anda. Pengurai JSON standar (seperti json.loads() atau JSON.parse()) menangani perbedaan ini secara otomatis.

    Perubahan yang direkomendasikan

    Ini tidak diperlukan tetapi akan meningkatkan pengalaman Anda:

    1. Bermigrasi ke pemikiran adaptif: thinking: {type: "enabled", budget_tokens: N} sudah usang pada model Claude 4.6 dan akan dihapus dalam rilis model di masa depan. Beralih ke thinking: {type: "adaptive"} dan gunakan parameter effort untuk mengontrol kedalaman pemikiran. Lihat Pemikiran adaptif.

      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=[...]
      )

      Perhatikan bahwa migrasi juga bergerak dari client.beta.messages.create ke client.messages.create — pemikiran adaptif dan effort adalah fitur GA dan tidak memerlukan namespace SDK beta atau header beta apa pun.

    2. Hapus header beta effort: Parameter effort sekarang GA. Hapus betas=["effort-2025-11-24"] dari permintaan Anda.

    3. Hapus header beta streaming alat berbutir halus: Streaming alat berbutir halus sekarang GA. Hapus betas=["fine-grained-tool-streaming-2025-05-14"] dari permintaan Anda.

    4. Hapus header beta pemikiran interleaved: Pemikiran adaptif secara otomatis mengaktifkan pemikiran interleaved. Hapus betas=["interleaved-thinking-2025-05-14"] dari permintaan Anda.

    5. Bermigrasi ke output_config.format: Jika menggunakan keluaran terstruktur, perbarui output_format={...} ke output_config={"format": {...}}. Parameter lama tetap berfungsi tetapi sudah usang dan akan dihapus dalam rilis model di masa depan.

    Bermigrasi dari Claude 4.1 atau lebih awal ke Claude 4.6

    Jika Anda bermigrasi dari Opus 4.1, Sonnet 4, atau model lebih awal langsung ke Claude 4.6, terapkan perubahan yang merusak Claude 4.6 di atas ditambah perubahan tambahan di bagian ini.

    # Dari Opus 4.1
    model="claude-opus-4-1-20250805"    # Sebelum
    model="claude-opus-4-6"               # Sesudah
    
    # Dari Sonnet 4
    model="claude-sonnet-4-20250514"    # Sebelum
    model="claude-opus-4-6"              # Sesudah
    
    # Dari Sonnet 3.7
    model="claude-3-7-sonnet-20250219"  # Sebelum
    model="claude-opus-4-6"              # Sesudah

    Perubahan yang merusak tambahan

    1. Parameter sampling

      Ini adalah perubahan yang merusak dari model Claude 3.x.

      Gunakan hanya temperature ATAU top_p, bukan keduanya:

      # Sebelum - Ini akan error di model Claude 4+
      response = client.messages.create(
          model="claude-3-7-sonnet-20250219",
          temperature=0.7,
          top_p=0.9,  # Tidak dapat menggunakan keduanya
          ...
      )
      
      # Sesudah
      response = client.messages.create(
          model="claude-opus-4-6",
          temperature=0.7,  # Gunakan temperature ATAU top_p, bukan keduanya
          ...
      )
    2. Versi alat

      Ini adalah perubahan yang merusak dari model Claude 3.x.

      Perbarui ke versi alat terbaru. Hapus kode apa pun yang menggunakan perintah undo_edit.

      # Sebelum
      tools=[{"type": "text_editor_20250124", "name": "str_replace_editor"}]
      
      # Sesudah
      tools=[{"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"}]
      • Editor teks: Gunakan text_editor_20250728 dan str_replace_based_edit_tool. Lihat Dokumentasi alat editor teks untuk detail.
      • Eksekusi kode: Tingkatkan ke code_execution_20250825. Lihat Dokumentasi alat eksekusi kode untuk instruksi migrasi.
    3. Tangani alasan penghentian refusal

      Perbarui aplikasi Anda untuk menangani alasan penghentian refusal:

      response = client.messages.create(...)
      
      if response.stop_reason == "refusal":
          # Tangani penolakan dengan tepat
          pass
    4. Tangani alasan penghentian model_context_window_exceeded

      Model Claude 4.5+ mengembalikan alasan penghentian model_context_window_exceeded ketika generasi berhenti karena mencapai batas jendela konteks, bukan batas max_tokens yang diminta. Perbarui aplikasi Anda untuk menangani alasan penghentian baru ini:

      response = client.messages.create(...)
      
      if response.stop_reason == "model_context_window_exceeded":
          # Tangani batas jendela konteks dengan tepat
          pass
    5. Penanganan parameter alat (trailing newlines)

      Model Claude 4.5+ mempertahankan trailing newline dalam parameter string panggilan alat yang sebelumnya dihapus. Jika alat Anda mengandalkan pencocokan string yang tepat terhadap parameter panggilan alat, verifikasi logika Anda menangani trailing newline dengan benar.

    6. Perbarui prompt Anda untuk perubahan perilaku

      Model Claude 4+ memiliki gaya komunikasi yang lebih ringkas dan langsung serta memerlukan arahan eksplisit. Tinjau praktik terbaik prompting untuk panduan optimasi.

    Perubahan yang direkomendasikan tambahan

    • Hapus header beta warisan: Hapus token-efficient-tools-2025-02-19 dan output-128k-2025-02-19 — semua model Claude 4+ memiliki penggunaan alat yang efisien token bawaan dan header ini tidak berpengaruh.

    Daftar periksa migrasi Claude 4.6

    • Perbarui ID model ke claude-opus-4-6
    • MERUSAK: Hapus prefill pesan asisten (mengembalikan kesalahan 400); gunakan keluaran terstruktur atau output_config.format sebagai gantinya
    • Direkomendasikan: Bermigrasi dari thinking: {type: "enabled", budget_tokens: N} ke thinking: {type: "adaptive"} dengan parameter effort (budget_tokens sudah usang dan akan dihapus dalam rilis model di masa depan)
    • Verifikasi penguraian JSON panggilan alat menggunakan pengurai JSON standar
    • Hapus header beta effort-2025-11-24 (effort sekarang GA)
    • Hapus header beta fine-grained-tool-streaming-2025-05-14
    • Hapus header beta interleaved-thinking-2025-05-14
    • Bermigrasi output_format ke output_config.format (jika berlaku)
    • Jika bermigrasi dari Claude 4.1 atau lebih awal: perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p
    • Jika bermigrasi dari Claude 4.1 atau lebih awal: perbarui versi alat (text_editor_20250728, code_execution_20250825)
    • Jika bermigrasi dari Claude 4.1 atau lebih awal: tangani alasan penghentian refusal
    • Jika bermigrasi dari Claude 4.1 atau lebih awal: tangani alasan penghentian model_context_window_exceeded
    • Jika bermigrasi dari Claude 4.1 atau lebih awal: verifikasi penanganan parameter string alat untuk trailing newline
    • Jika bermigrasi dari Claude 4.1 atau lebih awal: hapus header beta warisan (token-efficient-tools-2025-02-19, output-128k-2025-02-19)
    • Tinjau dan perbarui prompt mengikuti praktik terbaik prompting
    • Uji di lingkungan pengembangan sebelum penerapan produksi

    Bermigrasi ke Claude Sonnet 4.5

    Claude Sonnet 4.5 menggabungkan intelijen yang kuat dengan kinerja cepat, menjadikannya ideal untuk tugas pengkodean, analisis, dan konten sehari-hari.

    Untuk gambaran lengkap kemampuan, lihat ikhtisar model.

    Harga Sonnet 4.5 adalah $3 per juta token input, $15 per juta token output. Lihat harga Claude untuk detail.

    Perbarui nama model Anda:

    # Dari Sonnet 4
    model="claude-sonnet-4-20250514"        # Sebelum
    model="claude-sonnet-4-5-20250929"      # Sesudah
    
    # Dari Sonnet 3.7
    model="claude-3-7-sonnet-20250219"      # Sebelum
    model="claude-sonnet-4-5-20250929"      # Sesudah

    Pertimbangkan mengaktifkan pemikiran diperpanjang untuk peningkatan kinerja yang signifikan pada tugas pengkodean dan penalaran (dinonaktifkan secara default):

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

    Perubahan yang merusak

    Perubahan yang merusak ini berlaku saat bermigrasi dari model Claude 3.x Sonnet.

    1. Parameter sampling

      Ini adalah perubahan yang merusak dari model Claude 3.x.

      Gunakan hanya temperature ATAU top_p, bukan keduanya.

    2. Versi alat

      Ini adalah perubahan yang merusak dari model Claude 3.x.

      Perbarui ke versi alat terbaru (text_editor_20250728, code_execution_20250825). Hapus kode apa pun yang menggunakan perintah undo_edit.

    3. Tangani alasan penghentian refusal

      Perbarui aplikasi Anda untuk menangani alasan penghentian refusal.

    4. Perbarui prompt Anda untuk perubahan perilaku

      Model Claude 4 memiliki gaya komunikasi yang lebih ringkas dan langsung. Tinjau praktik terbaik prompting untuk panduan optimasi.

    Daftar periksa migrasi Sonnet 4.5

    • Perbarui ID model ke claude-sonnet-4-5-20250929
    • MERUSAK: Perbarui versi alat ke terbaru (text_editor_20250728, code_execution_20250825) — versi warisan tidak didukung (jika bermigrasi dari 3.x)
    • MERUSAK: Hapus kode apa pun yang menggunakan perintah undo_edit (jika berlaku)
    • MERUSAK: Perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p, bukan keduanya (jika bermigrasi dari 3.x)
    • Tangani alasan penghentian refusal baru di aplikasi Anda
    • Tinjau dan perbarui prompt mengikuti praktik terbaik prompting
    • Pertimbangkan mengaktifkan pemikiran diperpanjang untuk tugas penalaran kompleks
    • Uji di lingkungan pengembangan sebelum penerapan produksi

    Bermigrasi ke Claude Haiku 4.5

    Claude Haiku 4.5 adalah model Haiku kami yang tercepat dan paling cerdas dengan kinerja mendekati frontier, memberikan kualitas model premium untuk aplikasi interaktif dan pemrosesan volume tinggi.

    Untuk gambaran lengkap kemampuan, lihat ikhtisar model.

    Harga Haiku 4.5 adalah $1 per juta token input, $5 per juta token output. Lihat harga Claude untuk detail.

    Perbarui nama model Anda:

    # Dari Haiku 3.5
    model="claude-3-5-haiku-20241022"      # Sebelum
    model="claude-haiku-4-5-20251001"      # Sesudah

    Tinjau batas laju baru: Haiku 4.5 memiliki batas laju terpisah dari Haiku 3.5. Lihat dokumentasi batas laju untuk detail.

    Pertimbangkan mengaktifkan pemikiran diperpanjang untuk peningkatan kinerja yang signifikan pada tugas pengkodean dan penalaran (dinonaktifkan secara default):

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

    Pemikiran diperpanjang berdampak pada efisiensi caching prompt.

    Jelajahi kemampuan baru: Lihat ikhtisar model untuk detail tentang kesadaran konteks, kapasitas output yang meningkat (64K token), intelijen yang lebih tinggi, dan kecepatan yang ditingkatkan.

    Perubahan yang merusak

    Perubahan yang merusak ini berlaku saat bermigrasi dari model Claude 3.x Haiku.

    1. Parameter sampling

      Ini adalah perubahan yang merusak dari model Claude 3.x.

      Gunakan hanya temperature ATAU top_p, bukan keduanya.

    2. Versi alat

      Ini adalah perubahan yang merusak dari model Claude 3.x.

      Perbarui ke versi alat terbaru (text_editor_20250728, code_execution_20250825). Hapus kode apa pun yang menggunakan perintah undo_edit.

    3. Tangani alasan penghentian refusal

      Perbarui aplikasi Anda untuk menangani alasan penghentian refusal.

    4. Perbarui prompt Anda untuk perubahan perilaku

      Model Claude 4 memiliki gaya komunikasi yang lebih ringkas dan langsung. Tinjau praktik terbaik prompting untuk panduan optimasi.

    Daftar periksa migrasi Haiku 4.5

    • Perbarui ID model ke claude-haiku-4-5-20251001
    • MERUSAK: Perbarui versi alat ke terbaru (text_editor_20250728, code_execution_20250825) — versi warisan tidak didukung
    • MERUSAK: Hapus kode apa pun yang menggunakan perintah undo_edit (jika berlaku)
    • MERUSAK: Perbarui parameter sampling untuk menggunakan hanya temperature ATAU top_p, bukan keduanya
    • Tangani alasan penghentian refusal baru di aplikasi Anda
    • Tinjau dan sesuaikan untuk batas laju baru (terpisah dari Haiku 3.5)
    • Tinjau dan perbarui prompt mengikuti praktik terbaik prompting
    • Pertimbangkan mengaktifkan pemikiran diperpanjang untuk tugas penalaran kompleks
    • Uji di lingkungan pengembangan sebelum penerapan produksi

    Butuh bantuan?

    • Periksa dokumentasi API kami untuk spesifikasi terperinci
    • Tinjau kemampuan model untuk perbandingan kinerja
    • Tinjau catatan rilis API untuk pembaruan API
    • Hubungi dukungan jika Anda mengalami masalah apa pun selama migrasi

    Was this page helpful?

    • Bermigrasi ke Claude 4.6
    • Perbarui nama model Anda
    • Perubahan yang merusak
    • Perubahan yang direkomendasikan
    • Bermigrasi dari Claude 4.1 atau lebih awal ke Claude 4.6
    • Daftar periksa migrasi Claude 4.6
    • Bermigrasi ke Claude Sonnet 4.5
    • Perubahan yang merusak
    • Daftar periksa migrasi Sonnet 4.5
    • Bermigrasi ke Claude Haiku 4.5
    • Perubahan yang merusak
    • Daftar periksa migrasi Haiku 4.5
    • Butuh bantuan?