Claude Platform Docs
PesanAlat

Alat penggunaan komputer

Berikan Claude kendali tangkapan layar, mouse, dan keyboard atas lingkungan desktop dengan alat penggunaan komputer, yaitu toolset klien computer_toolset_20260801.

Claude dapat berinteraksi dengan lingkungan komputer melalui alat penggunaan komputer, yang menyediakan kemampuan tangkapan layar dan kendali mouse/keyboard untuk interaksi desktop secara otonom.

Alat penggunaan komputer adalah toolset klien yang didefinisikan oleh Anthropic: satu entri {"type": "computer_toolset_20260801"} di tools memberi Claude 17 alat anggota seperti screenshot, left_click, type, dan zoom, dan aplikasi Anda menjalankan setiap panggilan di lingkungan yang Anda kendalikan. Alat ini saat ini tidak tersedia di Claude Managed Agents. Panggilan Claude berupa blok tool_use yang name-nya adalah anggota tersebut dan yang membawa "toolset_name": "computer", sering kali beberapa sekaligus dalam satu giliran (sebuah tindakan batch).

Untuk tugas yang tetap berada di dalam halaman web, alat penggunaan browser lebih cocok: alat anggotanya membaca dan bertindak pada halaman itu sendiri, dan tidak memerlukan lingkungan desktop penuh.

Lihat Dukungan API untuk model dan platform yang mendukung toolset ini. Versi alat sebelumnya mencantumkan header beta untuk setiap versi sebelumnya beserta model yang dapat digunakan dengannya.

Pertimbangan keamanan

Penggunaan komputer memiliki risiko unik yang berbeda dari fitur API standar. Risiko ini meningkat saat berinteraksi dengan internet.

Dalam beberapa keadaan, Claude mengikuti perintah yang ditemukan dalam konten bahkan ketika perintah tersebut bertentangan dengan instruksi Anda. Misalnya, instruksi di halaman web atau yang terkandung dalam gambar dapat menimpa instruksi Anda atau menyebabkan Claude membuat kesalahan. Ambil langkah pencegahan untuk mengisolasi Claude dari data dan tindakan sensitif guna menghindari risiko terkait “prompt injection” (injeksi prompt).

Anthropic telah melatih model untuk menahan injeksi prompt ini dan telah menambahkan lapisan pertahanan ekstra. Jika Anda menggunakan alat penggunaan komputer, classifier secara otomatis memindai apa yang dikembalikan alat, seperti tangkapan layar, untuk menandai potensi injeksi prompt. Ketika classifier ini mengidentifikasi potensi injeksi prompt, classifier mengarahkan model untuk memeriksa apakah instruksi tersebut benar-benar berasal dari Anda sebelum menindaklanjutinya.

Perlindungan ekstra ini tidak ideal untuk setiap kasus penggunaan (misalnya, kasus penggunaan tanpa manusia dalam loop), jadi jika Anda ingin memilih keluar dan menonaktifkannya, hubungi dukungan. Langkah pencegahan yang tercantum sebelumnya tetap penting bahkan dengan adanya classifier ini.

Informasikan kepada pengguna akhir tentang risiko yang relevan dan dapatkan persetujuan mereka sebelum mengaktifkan penggunaan komputer di produk Anda sendiri.

Mulai cepat

Tambahkan toolset penggunaan komputer ke array tools dari permintaan Messages APIPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. sebagai {"type": "computer_toolset_20260801"}. Permintaan ini tidak memerlukan header beta. Contoh ini juga mendeklarasikan alat editor teks dan alat bash, yang biasanya digunakan Claude bersama penggunaan komputer:

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    tools=[
        {"type": "computer_toolset_20260801"},
        {"type": "text_editor_20250728", "name": "str_replace_based_edit_tool"},
        {"type": "bash_20250124", "name": "bash"},
    ],
    messages=[{"role": "user", "content": "Save a picture of a cat to my desktop."}],
)
print(response)

Ketika Claude bertindak pada desktop, respons memiliki stop_reason bernilai tool_use dan berisi satu atau lebih blok tool_use anggota, masing-masing menyebutkan alat anggota dan membawa "toolset_name": "computer". Di tengah tugas ini, setelah Claude menerima tangkapan layar desktop, respons mungkin terlihat seperti ini:

Output
{
  "id": "msg_01UZ3bXcQH8mTqNhVfL9eK2p",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [
    {
      "type": "text",
      "text": "I'll open the web browser to find a picture of a cat."
    },
    {
      "type": "tool_use",
      "id": "toolu_01WkoTUvSHDzTBu2xnGk8Ep8",
      "name": "left_click",
      "toolset_name": "computer",
      "input": { "coordinate": [512, 742] }
    },
    {
      "type": "tool_use",
      "id": "toolu_017nJn3RgSCkTMwuZDb4uUov",
      "name": "screenshot",
      "toolset_name": "computer",
      "input": {}
    }
  ],
  "stop_reason": "tool_use",
  "stop_sequence": null
}

Aplikasi Anda menjalankan setiap panggilan secara berurutan di lingkungan Anda sendiri, mengembalikan satu blok tool_result untuk setiap blok tool_use, dan memanggil API lagi; Cara kerja penggunaan komputer menjelaskan loop tersebut, dan bagian lain dari halaman ini menunjukkan cara mengimplementasikannya.


Cara kerja penggunaan komputer

  1. Berikan Claude alat penggunaan komputer dan prompt pengguna

    • Tambahkan toolset penggunaan komputer (dan opsional alat lain) ke array tools dari permintaan API Anda.
    • Sertakan prompt pengguna yang memerlukan interaksi desktop, misalnya, “Simpan gambar kucing ke desktop saya.”
  2. Claude merespons dengan panggilan alat anggota

    • Claude menilai apakah bertindak pada desktop dapat membantu menjawab kueri pengguna.
    • Jika ya, Claude merespons dengan satu atau lebih blok tool_use anggota, seperti screenshot, left_click, atau type, masing-masing membawa "toolset_name": "computer". Respons dengan beberapa blok seperti ini adalah sebuah tindakan batch.
    • Respons API memiliki stop_reason bernilai tool_use, yang menandakan permintaan penggunaan alat.
  3. Jalankan panggilan secara berurutan dan kembalikan hasil

    • Iterasi setiap blok tool_use dalam respons, secara berurutan. Untuk setiap blok, lakukan dispatch berdasarkan name anggota bersama dengan toolset_name, dan lakukan tindakan tersebut dengan input blok pada container atau mesin virtual Anda.
    • Lanjutkan percakapan dengan pesan user baru yang berisi satu blok tool_result untuk setiap blok tool_use, dicocokkan berdasarkan tool_use_id dan masing-masing menyertakan kembali "toolset_name": "computer". Kembalikan gambar untuk screenshot dan zoom; teks singkat seperti OK sudah cukup untuk tindakan lainnya.
    • Jika suatu tindakan gagal, kembalikan is_error: true untuk blok tersebut dan jawab sisa batch seperti yang dijelaskan di Tindakan batch.
  4. Claude melanjutkan hingga tugas selesai

    • Claude menganalisis hasil alat untuk menentukan apakah diperlukan lebih banyak tindakan atau tugas telah selesai.
    • Jika Claude menentukan bahwa diperlukan lebih banyak tindakan, Claude merespons dengan stop_reason tool_use lainnya; kembali ke langkah 3.
    • Jika tidak, Claude mengembalikan respons teks kepada pengguna.

Langkah 3 dan 4, yang diulang tanpa input pengguna, membentuk “agent loop” (loop agen): Claude merespons dengan permintaan penggunaan alat, dan aplikasi Anda merespons Claude dengan hasil evaluasi permintaan tersebut.

Tindakan batch

Claude dapat merencanakan urutan tindakan singkat, seperti klik, mengetik, lalu mengambil tangkapan layar, dan mengembalikannya bersama-sama dalam satu respons. Ini disebut “batch action” (tindakan batch); ini menggunakan bentuk respons yang sama dengan penggunaan alat paralel dengan satu perbedaan: Anda menjalankan blok secara berurutan, bukan secara bersamaan.

Respons dengan batch tiga tindakan terlihat seperti ini:

{
  "role": "assistant",
  "content": [
    {
      "type": "tool_use",
      "id": "toolu_01HqCF3nJ4Vzr8sTkPZ2wxYA",
      "name": "left_click",
      "toolset_name": "computer",
      "input": { "coordinate": [640, 60] }
    },
    {
      "type": "tool_use",
      "id": "toolu_01Ppr3sZ3TnE9m6VUu4RyH2K",
      "name": "type",
      "toolset_name": "computer",
      "input": { "text": "pictures of cats" }
    },
    {
      "type": "tool_use",
      "id": "toolu_01Xf5W1sD8Q9aBcJ7kLmN2pQ",
      "name": "screenshot",
      "toolset_name": "computer",
      "input": {}
    }
  ]
}

Kembalikan satu blok tool_result untuk setiap blok tool_use, dicocokkan berdasarkan tool_use_id, semuanya dalam pesan user berikutnya. Setiap hasil untuk alat anggota harus membawa "toolset_name": "computer"; hasil yang menghilangkannya, atau yang menyebutkan toolset berbeda dari blok tool_use-nya, akan ditolak. Hanya hasil screenshot dan zoom yang memerlukan gambar; untuk anggota lainnya, pengakuan teks singkat seperti OK sudah cukup (cursor_position mengembalikan koordinat sebagai teks):

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01HqCF3nJ4Vzr8sTkPZ2wxYA",
      "toolset_name": "computer",
      "content": [{ "type": "text", "text": "OK" }]
    },
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01Ppr3sZ3TnE9m6VUu4RyH2K",
      "toolset_name": "computer",
      "content": [{ "type": "text", "text": "OK" }]
    },
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01Xf5W1sD8Q9aBcJ7kLmN2pQ",
      "toolset_name": "computer",
      "content": [
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": "iVBORw0KGgo..."
          }
        }
      ]
    }
  ]
}

Jalankan blok secara berurutan dan berhenti pada kegagalan pertama. Tindakan selanjutnya dalam batch biasanya bergantung pada tindakan sebelumnya: type dalam contoh ini memasukkan teks ke elemen apa pun yang difokuskan oleh klik sebelumnya. Jalankan blok secara berurutan sesuai urutan kemunculannya di content, dan jika salah satunya gagal, jangan jalankan sisanya. Setiap blok tool_use tetap memerlukan tool_result, jadi jawab batch sebagai berikut:

  • Untuk setiap tindakan yang berhasil, kembalikan hasil normalnya.
  • Untuk tindakan yang gagal, kembalikan is_error: true dengan deskripsi teks tentang apa yang salah.
  • Untuk setiap tindakan selanjutnya dalam batch, kembalikan is_error: true dengan teks persis ini (alat penggunaan browser menggunakan teks penghentian miliknya sendiri):
{
  "type": "tool_result",
  "tool_use_id": "toolu_01Xf5W1sD8Q9aBcJ7kLmN2pQ",
  "toolset_name": "computer",
  "is_error": true,
  "content": "Not executed: an earlier computer action in this turn failed."
}

Claude kemudian membaca tindakan mana yang berhasil, mana yang gagal, dan mana yang dilewati, lalu merencanakan ulang pada giliran berikutnya. Permintaan yang membiarkan blok tool_use mana pun dalam batch tidak terjawab akan ditolak dengan invalid_request_error, sehingga loop agen yang hanya membaca blok pertama akan gagal pada panggilan berikutnya. Jika aplikasi Anda meminta manusia untuk mengonfirmasi tindakan yang berdampak, lakukan pemeriksaan tersebut sebelum setiap blok dijalankan, karena sebuah batch dapat menyelesaikan tindakan multilangkah dalam satu giliran.

Claude biasanya mengakhiri batch dengan screenshot sehingga dapat mengamati hasilnya sebelum menentukan apa yang harus dilakukan selanjutnya. Ketika batch tidak diakhiri dengan tangkapan layar, aplikasi Anda dapat melampirkan tangkapan layar sebagai blok image tambahan pada hasil terakhir dalam batch sehingga Claude selalu menerima keadaan layar saat ini, yang menghemat satu perjalanan bolak-balik dibandingkan menunggu Claude memintanya. Anda juga dapat memberi prompt kepada Claude untuk mengakhiri setiap batch dengan tangkapan layar (lihat Optimalkan kinerja model dengan prompting).

Lingkungan komputasi

Penggunaan komputer memerlukan lingkungan komputasi sandbox tempat Claude dapat berinteraksi dengan aplikasi dan web secara aman. Lingkungan ini mencakup:

  1. Tampilan virtual: Server tampilan X11 virtual (menggunakan Xvfb) yang merender antarmuka desktop yang diterima Claude sebagai tangkapan layar dan dikendalikan dengan tindakan mouse/keyboard.

  2. Lingkungan desktop: UI ringan dengan pengelola jendela (Mutter) dan panel (Tint2) yang berjalan di Linux, yang menyediakan antarmuka grafis yang konsisten untuk diinteraksikan oleh Claude.

  3. Aplikasi: Aplikasi Linux yang sudah terpasang seperti Firefox, LibreOffice, editor teks, dan pengelola file yang dapat digunakan Claude untuk menyelesaikan tugas.

  4. Implementasi alat: Kode integrasi yang menerjemahkan permintaan alat abstrak Claude (seperti “gerakkan mouse” atau “ambil tangkapan layar”) menjadi operasi nyata di lingkungan virtual.

  5. Loop agen: Program yang menangani komunikasi antara Claude dan lingkungan, mengirimkan tindakan Claude ke lingkungan dan mengembalikan hasilnya (tangkapan layar, output perintah) kembali ke Claude.

Saat Anda menggunakan penggunaan komputer, Claude tidak terhubung langsung ke lingkungan ini. Sebaliknya, aplikasi Anda:

  1. Menerima permintaan penggunaan alat dari Claude.
  2. Menerjemahkannya menjadi tindakan di lingkungan komputasi Anda.
  3. Menangkap hasilnya (seperti tangkapan layar dan output perintah).
  4. Mengembalikan hasil ini ke Claude.

Untuk keamanan dan isolasi, implementasi referensi menjalankan semua ini di dalam container Docker dengan pemetaan port yang sesuai untuk melihat dan berinteraksi dengan lingkungan.


Cara mengimplementasikan penggunaan komputer

Meng-upgrade integrasi computer_20251124 yang sudah ada? Mulailah dengan Migrasi dari computer_20251124; sisa bagian ini berlaku untuk integrasi baru maupun yang dimigrasikan.

Memahami loop agen

Inti dari penggunaan komputer adalah “loop agen”: sebuah siklus di mana Claude meminta tindakan alat, lalu aplikasi Anda menjalankannya dan mengembalikan hasilnya ke Claude. Loop ini menggunakan klien yang Anda buat di Mulai cepat, array tools yang hanya mendeklarasikan toolset penggunaan komputer, dan helper pemrosesan panggilan alat di bawah Implementasikan alat penggunaan komputer. Jika Anda juga mendeklarasikan alat lain, seperti alat bash dan editor teks dari Mulai cepat, lakukan dispatch blok tool_use mereka dalam proses yang sama; helper hanya menjawab panggilan anggota penggunaan komputer, dan loop menganggap giliran tanpa panggilan yang dijawab sebagai selesai. Berikut contoh yang disederhanakan:

def sampling_loop(model: str, messages: list[MessageParam], max_iterations: int = 10):
    """
    Run the computer-use agent loop until Claude stops requesting tools
    or the iteration limit is reached.
    """
    for _ in range(max_iterations):
        response = client.messages.create(
            model=model,
            max_tokens=4096,
            messages=messages,
            tools=TOOLS,
        )

        # Add Claude's response to the conversation history
        messages.append({"role": "assistant", "content": response.content})

        # Run the actions Claude requested, in order, and collect the results
        tool_results = process_tool_calls(response)
        if not tool_results:
            return messages  # No more tool use; task complete

        # Send every result back to Claude in a single user message
        messages.append({"role": "user", "content": tool_results})

    return messages

Loop berlanjut hingga Claude merespons tanpa meminta alat apa pun (tugas selesai) atau batas iterasi maksimum tercapai. Pengaman ini mencegah potensi loop tak terbatas yang dapat mengakibatkan biaya API yang tidak terduga.

Optimalkan kinerja model dengan prompting

  1. Tentukan tugas yang terdefinisi dengan baik, serta berikan instruksi eksplisit untuk setiap langkah.
  2. Claude terkadang bertindak seolah-olah tindakannya berhasil tanpa memeriksa hasilnya secara eksplisit. Untuk mencegah hal ini, Anda dapat memberi prompt kepada Claude dengan After each step, take a screenshot and carefully evaluate if you have achieved the right outcome. State in one sentence what the screenshot shows and whether the step succeeded. If it didn't, try again. Only when you confirm a step was executed correctly should you move on to the next one.
  3. Beberapa elemen UI (seperti dropdown dan scrollbar) mungkin sulit dimanipulasi oleh Claude menggunakan gerakan mouse. Jika Anda mengalami hal ini, coba beri prompt kepada model untuk menggunakan pintasan keyboard.
  4. Untuk tugas atau interaksi UI yang berulang, sertakan contoh tangkapan layar dan panggilan alat dari hasil yang berhasil dalam prompt Anda.
  5. Jika Anda memerlukan model untuk login, berikan nama pengguna dan kata sandi dalam prompt Anda di dalam tag XML seperti <robot_credentials>. Menggunakan penggunaan komputer dalam aplikasi yang memerlukan login meningkatkan risiko hasil buruk akibat injeksi prompt. Tinjau Mitigasi jailbreak dan injeksi prompt sebelum memberikan kredensial login kepada model.
  6. Saat menyusun array content giliran pengguna, tempatkan teks instruksi sebelum gambar tangkapan layar. Memberikan deskripsi target sebelum gambar diproses meningkatkan akurasi klik.
  7. Claude menggunakan tindakan zoom untuk memeriksa suatu wilayah pada resolusi penuh ketika ditanya tentang teks kecil atau elemen UI tertentu yang tidak terbaca pada resolusi default tangkapan layar, seperti nama file di sidebar, judul tab, teks status bar, nomor baris, atau label tombol. Jika Claude tidak melakukan zoom saat Anda mengharapkannya, tanyakan tentang wilayah atau elemen tertentu, bukan layar secara keseluruhan.
  8. Jika Anda ingin setiap tindakan batch diakhiri dengan tangkapan layar, nyatakan hal tersebut dalam prompt sistem, misalnya, End each group of actions with a screenshot so you can verify the result before continuing.

Jika Anda berulang kali menemui serangkaian masalah yang jelas, atau mengetahui sebelumnya tugas yang harus diselesaikan Claude, berikan Claude tips atau instruksi eksplisit untuk tugas-tugas tersebut dalam prompt sistem.

Untuk agen yang mencakup beberapa sesi, jalankan verifikasi end-to-end di awal setiap sesi, tidak hanya setelah implementasi. Pemeriksaan berbasis browser menangkap regresi dari sesi sebelumnya yang terlewat oleh tinjauan tingkat kode saja. Lihat Effective harnesses for long-running agents untuk detailnya.

Prompt sistem

Saat Anda menyertakan alat penggunaan komputer dalam permintaan, API menghasilkan “system prompt” (prompt sistem) khusus penggunaan komputer. Prompt ini mirip dengan prompt sistem penggunaan alat tetapi dimulai dengan:

You have access to a set of functions you can use to answer the user’s question. This includes access to a sandboxed computing environment. You do NOT currently have the ability to inspect files or interact with external resources, except by invoking the below functions.

Seperti penggunaan alat biasa, parameter system yang diberikan pengguna tetap dihormati dan digunakan dalam penyusunan prompt sistem gabungan.

Tindakan yang tersedia

Setiap tindakan adalah alat anggota dari toolset penggunaan komputer: Claude menyebutkan anggota dalam blok tool_use yang membawa "toolset_name": "computer", dan input blok hanya berisi parameter anggota tersebut, tanpa field action. Toolset ini memiliki 17 alat anggota:

AnggotaInputDeskripsi
screenshotTidak ada ({})Menangkap seluruh tampilan dan mengembalikannya sebagai gambar.
zoomregion: [x0, y0, x1, y1], sudut kiri atas dan kanan bawah dari area yang akan diperiksaMenangkap hanya wilayah tampilan tersebut pada resolusi penuh dan mengembalikannya sebagai gambar, diskalakan agar muat dalam dimensi tangkapan layar Anda yang biasa dengan rasio aspek dipertahankan. Ini memungkinkan Claude membaca teks kecil atau UI padat yang tidak terbaca dalam tangkapan layar penuh yang diperkecil.
left_clickcoordinate (opsional): [x, y]; text (opsional): tombol modifier yang ditahan selama klik: shift, ctrl, alt, super (tombol Command atau Windows), atau kombinasi yang digabungkan dengan + seperti ctrl+shiftMengklik tombol kiri mouse di coordinate, atau di posisi kursor saat ini jika coordinate dihilangkan.
right_click, middle_click, double_click, triple_clickSama seperti left_clickTombol mouse lainnya dan klik berganda.
left_click_dragstart_coordinate: [x, y]; coordinate: [x, y]; text (opsional): tombol modifierMenekan di start_coordinate, menyeret ke coordinate, dan melepaskan.
mouse_movecoordinate: [x, y]Menggerakkan kursor tanpa mengklik, misalnya, untuk mengarahkan kursor ke suatu elemen.
left_mouse_down, left_mouse_upTidak ada ({})Menekan atau melepaskan tombol kiri mouse di posisi kursor saat ini, untuk gerakan seret yang tidak dapat diekspresikan oleh left_click_drag. Gerakkan kursor dengan mouse_move terlebih dahulu.
cursor_positionTidak ada ({})Melaporkan posisi [x, y] kursor saat ini sebagai teks.
scrollscroll_direction: "up", "down", "left", atau "right"; scroll_amount: jumlah klik roda gulir; coordinate (opsional): [x, y]; text (opsional): tombol modifierMenggulir di coordinate, atau di posisi kursor saat ini.
typetext: string yang akan diketikMengetik teks literal pada fokus keyboard saat ini.
keytext: sebuah tombol atau kombinasi yang digabungkan dengan + seperti "Return", "ctrl+s", atau "alt+Tab"; repeat (opsional): 1 hingga 100, default 1Menekan tombol atau kombinasi tombol sebanyak repeat kali.
hold_keytext: sebuah tombol atau kombinasi; duration: detik, hingga 300Menahan tombol selama durasi yang ditentukan.
waitduration: detik, hingga 300Menjeda sebelum tindakan berikutnya, misalnya, saat aplikasi sedang dimuat.

Perhatikan hal-hal berikut saat mengimplementasikan anggota:

  • Koordinat dalam piksel tangkapan layar. Setiap nilai coordinate, start_coordinate, dan region, serta posisi yang dilaporkan cursor_position, berada dalam ruang piksel tangkapan layar tampilan penuh yang Anda kembalikan, dengan titik asal di kiri atas. Gambar zoom tidak mengubah hal ini: setelah zoom, Claude tetap menyatakan koordinat dalam ruang tangkapan layar penuh, tidak pernah relatif terhadap gambar yang di-zoom. Jika Anda memperkecil tangkapan layar sebelum mengembalikannya, skalakan kembali koordinat Claude sebelum menerapkannya ke tampilan sebenarnya (lihat Sesuaikan ukuran tangkapan layar agar sesuai batas gambar).
  • Semua anggota diaktifkan secara default, termasuk zoom. Jika lingkungan Anda tidak dapat menghasilkan gambar zoom, kecualikan anggota tersebut dengan configs (lihat Parameter alat) daripada membiarkannya aktif dan mengembalikan error. Jika Claude memanggil anggota yang Anda kecualikan atau tidak Anda implementasikan, kembalikan tool_result dengan is_error: true untuk blok tersebut.
  • Lakukan dispatch berdasarkan pasangan (toolset_name, name). toolset_name adalah yang menandai blok sebagai tindakan komputer: alat kustom dalam permintaan yang sama dapat berbagi nama dengan anggota, dan versi toolset berikutnya dapat menambahkan anggota (lihat Toolset klien).

Parameter alat

Entri toolset dalam array tools menerima empat parameter; aturan yang dibagikan dengan toolset penggunaan browser tercantum di bawah Toolset klien.

ParameterWajibDeskripsi
typeYacomputer_toolset_20260801
configsTidakPengaturan per anggota yang dikunci berdasarkan nama anggota; setiap anggota menerima enabled (default true untuk ke-17 anggota, termasuk zoom) dan defer_loading (default false, untuk pencarian alat), dan anggota yang Anda hilangkan mempertahankan nilai default-nya.
cache_controlTidakBreakpoint caching prompt pada definisi toolset; hanya pada entri. Breakpoint pada blok tool_use atau tool_result mana pun dalam batch berlaku di akhir batch tersebut; lihat Penggunaan alat dengan caching prompt.
allowed_callersTidakHanya ["direct"].

Misalnya, entri ini mengecualikan zoom untuk lingkungan yang tidak mengimplementasikannya dan menetapkan breakpoint cache pada definisi toolset:

{
  "type": "computer_toolset_20260801",
  "configs": {
    "zoom": { "enabled": false }
  },
  "cache_control": { "type": "ephemeral" }
}

Jika loop agen Anda hanya dapat menjalankan satu tindakan untuk setiap perjalanan bolak-balik, tetapkan disable_parallel_tool_use ke true di tool_choice; Claude kemudian mengembalikan paling banyak satu blok tool_use anggota untuk setiap giliran (lihat Menonaktifkan penggunaan alat paralel).

Entri ini menolak parameter berikut dari versi alat sebelumnya, dan permintaan yang menyertakan salah satunya akan mengembalikan invalid_request_error:

  • name: nama anggota ditetapkan oleh versi toolset.
  • display_width_px, display_height_px, dan display_number: koordinat selalu berada dalam ruang piksel tangkapan layar yang Anda kembalikan.
  • enable_zoom: zoom adalah alat anggota yang Anda kendalikan melalui configs.

Entri ini juga tidak dapat dideklarasikan dalam permintaan yang sama dengan entri computer_20251124 atau alat lain bernama computer. Untuk strict, input_examples, penempatan defer_loading, tool_choice, streaming, dan pembatasan pemanggil, lihat Toolset klien.

Menggabungkan dengan pemikiran

Untuk menggabungkan penggunaan komputer dengan pemikiran, lihat Pemikiran.

Memperkaya penggunaan komputer dengan alat lain

Untuk menambahkan alat lain bersama penggunaan komputer, sertakan alat tersebut dalam array tools yang sama. Bagian Mulai cepat menunjukkan pola ini dengan alat bash dan alat editor teks. Anda dapat menambahkan definisi alat kustom Anda sendiri dengan cara yang sama.

Untuk tugas yang tetap berada di dalam halaman web, Anda juga dapat mendeklarasikan alat penggunaan browser dalam permintaan yang sama. Kedua toolset bekerja secara independen, masing-masing dalam kerangka koordinatnya sendiri. Nilai toolset_name membedakan panggilan ke anggota yang memiliki nama yang sama, seperti screenshot atau key.

Bangun lingkungan penggunaan komputer kustom

Implementasi referensi dimaksudkan untuk membantu Anda memulai dengan penggunaan komputer. Implementasi ini mencakup semua komponen yang diperlukan agar Claude dapat menggunakan komputer. Namun, Anda dapat membangun lingkungan Anda sendiri untuk penggunaan komputer sesuai kebutuhan Anda. Anda memerlukan:

  • Lingkungan tervirtualisasi atau dalam container yang cocok untuk penggunaan komputer dengan Claude
  • Implementasi tindakan alat penggunaan komputer
  • Loop agen yang berinteraksi dengan Claude API dan menjalankan hasil tool_use menggunakan implementasi alat Anda
  • API atau UI yang memungkinkan input pengguna untuk memulai loop agen

Implementasikan alat penggunaan komputer

Alat penggunaan komputer diimplementasikan sebagai alat tanpa skema. Saat menggunakan alat ini, Anda tidak perlu menyediakan skema input seperti pada alat lain; skema sudah tertanam dalam model Claude dan tidak dapat dimodifikasi.

  1. Siapkan lingkungan komputasi Anda

    Buat tampilan virtual atau hubungkan ke tampilan yang sudah ada yang diinteraksikan oleh Claude. Ini biasanya melibatkan penyiapan Xvfb (X Virtual Framebuffer) atau teknologi serupa.

  2. Implementasikan handler tindakan

    Buat fungsi untuk menangani setiap jenis tindakan yang mungkin diminta Claude:

    # Placeholder image data; a real executor captures the screen and returns the PNG bytes
    PLACEHOLDER_PNG = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="
    
    
    def capture_screenshot() -> list[ImageBlockParam]:
        # screenshot answers with an image block rather than text: return the result content list
        return [
            {
                "type": "image",
                "source": {
                    "type": "base64",
                    "media_type": "image/png",
                    "data": PLACEHOLDER_PNG,
                },
            }
        ]
    
    
    def click(coordinate=None):
        if coordinate is None:
            return "clicked at current cursor"
        x, y = coordinate
        return f"clicked at ({x}, {y})"
    
    
    def type_text(text):
        return f"typed: {text}"
    
    
    def handle_computer_action(name, tool_input):
        match name:
            case "screenshot":
                return capture_screenshot()
            case "left_click":
                # coordinate is optional; without it, click where the cursor already is
                return click(tool_input.get("coordinate"))
            case "type":
                return type_text(tool_input["text"])
        # Handle other actions as needed
        raise ValueError(f"Unknown or unimplemented member: {name}")
  3. Proses panggilan alat Claude

    Ekstrak dan jalankan panggilan alat dari respons Claude:

    NOT_EXECUTED = "Not executed: an earlier computer action in this turn failed."
    
    
    def process_tool_calls(response: Message) -> list[ToolResultBlockParam]:
        """
        Run the computer actions in Claude's response in order and answer each
        one. After the first failure the rest are skipped, because Claude planned
        them assuming the earlier actions succeeded.
        """
        tool_results: list[ToolResultBlockParam] = []
        failed = False
        for block in response.content:
            # Only the computer toolset is declared; route other tools here if you add them
            if block.type != "tool_use" or block.toolset_name != "computer":
                continue
            result: ToolResultBlockParam = {
                "type": "tool_result",
                "tool_use_id": block.id,
                "toolset_name": "computer",
            }
            if failed:
                result["content"] = NOT_EXECUTED
                result["is_error"] = True
            else:
                try:
                    # A string, or a list of content blocks such as the screenshot image
                    result["content"] = handle_computer_action(block.name, block.input)
                except Exception as err:
                    result["content"] = f"Error: {err}"
                    result["is_error"] = True
                    failed = True
            tool_results.append(result)
        return tool_results
  4. Implementasikan loop agen

    Bungkus dua langkah sebelumnya dalam loop yang mengirimkan hasil kembali dan mengulanginya hingga Claude tidak mengembalikan panggilan alat anggota; Memahami loop agen menunjukkan loop ini.

Menangani error

Laporkan tindakan yang gagal kepada Claude sebagai tool_result dengan is_error: true dan deskripsi singkat, serta sertakan "toolset_name": "computer" seperti pada hasil anggota lainnya. Jika tindakan yang gagal merupakan bagian dari tindakan batch, jawab blok yang tersisa dalam batch dengan teks penghentian yang ditunjukkan di sana alih-alih menjalankannya.

Misalnya, ketika pengambilan tangkapan layar gagal:

{
  "role": "user",
  "content": [
    {
      "type": "tool_result",
      "tool_use_id": "toolu_01A09q90qw90lq917835lq9",
      "toolset_name": "computer",
      "content": "Error: Failed to capture screenshot. Display may be locked or unavailable.",
      "is_error": true
    }
  ]
}

Gunakan bentuk yang sama untuk koordinat di luar batas tampilan dan untuk tindakan yang gagal dijalankan, dengan pesan yang menyatakan apa yang salah.

Sesuaikan ukuran screenshot agar sesuai batas gambar

Screenshot dan gambar zoom yang Anda kembalikan ke toolset penggunaan komputer harus sudah sesuai dengan batas ukuran gambar model Anda: toolset tidak menerima dimensi layar dan API tidak melakukan downscale untuk Anda, sehingga gambar tool_result yang terlalu besar akan ditolak dengan kesalahan validasi. Karena Claude mengembalikan koordinat dalam ruang piksel gambar yang diterimanya, simpan faktor skala yang Anda gunakan agar Anda dapat memetakan koordinat tersebut kembali ke layar Anda.

Jika layar Anda lebih besar dari batas tersebut, ubah ukuran setiap screenshot sebelum mengembalikannya dan skalakan koordinat yang dikembalikan Claude kembali ke ruang layar asli. Karena toolset tidak menerima dimensi layar, perubahan ukuran dan penskalaan koordinat dalam kode aplikasi Anda adalah semua yang Anda perlukan:

import math

screen_width, screen_height = 1512, 982


def get_scale_factor(width, height):
    """Calculate scale factor to meet API constraints."""
    long_edge = max(width, height)
    total_pixels = width * height

    long_edge_scale = 1568 / long_edge
    total_pixels_scale = math.sqrt(1_150_000 / total_pixels)

    return min(1.0, long_edge_scale, total_pixels_scale)


# Saat mengambil tangkapan layar
scale = get_scale_factor(screen_width, screen_height)
scaled_width = int(screen_width * scale)
scaled_height = int(screen_height * scale)

# Ubah ukuran gambar ke dimensi yang diskalakan sebelum dikirim ke Claude
screenshot = capture_and_resize(scaled_width, scaled_height)


# Saat menangani koordinat dari Claude, skalakan kembali ke ukuran semula
def execute_click(x, y):
    screen_x = x / scale
    screen_y = y / scale
    perform_click(screen_x, screen_y)

Saat Anda memilih resolusi layar dan mengembalikan screenshot:

  • Untuk tugas desktop umum, gunakan 1024x768 atau 1280x720; untuk aplikasi web, gunakan 1280x800 atau 1366x768.
  • Hindari resolusi di atas 1920x1080 untuk mencegah masalah performa.
  • Enkode screenshot sebagai PNG atau JPEG base64, dan pertimbangkan untuk mengompresi screenshot besar untuk meningkatkan performa.
  • Sertakan metadata yang relevan seperti timestamp atau status layar.
  • Jika Anda menggunakan resolusi yang lebih tinggi, pastikan koordinat diskalakan secara akurat.

Kelola riwayat screenshot

“Agent loop” (loop agen) yang panjang mengakumulasi screenshot dengan cepat (kira-kira 1.000–1.800 token input masing-masing). Batas permintaan API juga berlaku.

Setelah satu permintaan membawa lebih dari 20 gambar, setiap gambar di dalamnya dikenai batas per sisi yang lebih ketat. Loop yang menyimpan riwayat screenshot-nya dapat mencapai jumlah tersebut. Ubah ukuran setiap screenshot agar tetap di bawah batas tersebut, atau pangkas screenshot lama agar permintaan berisi 20 gambar atau kurang.

Untuk menjaga caching prompt tetap efektif sambil membatasi konteks:

  • Tempatkan satu breakpoint cache_control setelah prompt sistem dan definisi alat, dan hingga tiga lagi pada blok tool_result terakhir dari masing-masing giliran terbaru, dan geser setiap giliran. Dalam sebuah tindakan batch, penanda pada beberapa blok bertindak sebagai satu breakpoint, tetapi masing-masing tetap dihitung terhadap batas empat, jadi gunakan paling banyak satu di setiap giliran.
  • Pangkas screenshot lama secara batch, bukan satu per giliran. Menghapus satu screenshot pada setiap giliran mengubah prefiks setiap giliran dan membatalkan cache. Default yang wajar adalah menyimpan tiga screenshot terakhir dan memangkas setiap 25 giliran, sehingga prefiks tetap identik secara byte di antara peristiwa pemangkasan; jika screenshot Anda melebihi batas yang lebih ketat, pilih interval yang menjaga setiap permintaan berisi 20 gambar atau kurang.
  • Hindari pemangkasan di sisi klien pada Claude Fable 5.2, Claude Mythos 5.2, Claude Fable 5.1, dan Claude Mythos 5.1. Hal yang sama berlaku untuk Claude Opus 5.5, Claude Sonnet 5.5, dan Claude Haiku 5.5. Pada model-model ini, menghapus screenshot sebelumnya dari sebuah permintaan membatalkan setiap blok pemikiran berikutnya yang sudah ada dalam riwayat dari permintaan tersebut dan setiap permintaan berikutnya.
    • Sebagai gantinya: Ubah ukuran screenshot agar tetap di bawah batas yang lebih ketat. Pembersihan hasil alat menghemat token, tetapi screenshot yang dibersihkan tetap dihitung terhadap batas permintaan, jadi gunakan compaction sesuai permintaan sebelum loop mencapai batas tersebut.
    • Jika Anda harus memangkas: Tetap atur prefix_mismatch_behavior: "drop_block" sejak saat itu. Setelah setiap pemangkasan, API tidak menyertakan blok pemikiran yang dibatalkan, pada permintaan tersebut dan setiap permintaan berikutnya. Jadi Claude melanjutkan tanpa pemikiran yang dihasilkannya setelah screenshot yang dipangkas.
    • Jika Anda harus memangkas pada Claude Sonnet 5.5 atau Claude Haiku 5.5: prefix_mismatch_behavior hanya berfungsi dengan thinking: {"type": "adaptive"}. Dengan pengaturan pemikiran lainnya pada model-model tersebut, pertahankan riwayat tetap append-only (hanya ditambah di akhir) atau hapus setiap blok thinking dan redacted_thinking setelah screenshot yang dipangkas.

Diagnosis masalah klik

Jika klik meleset dari targetnya, penyebabnya biasanya salah satu dari berikut:

GejalaKemungkinan penyebabCoba
Klik secara konsisten bergeser ke satu arahKoordinat Claude, yang berada dalam ruang piksel screenshot yang Anda kembalikan, diterapkan ke layar dengan ukuran berbeda tanpa penskalaanSkalakan setiap koordinat dengan rasio ukuran layar Anda terhadap ukuran screenshot Anda sebelum mengklik (lihat Sesuaikan ukuran screenshot agar sesuai batas gambar); pada layar macOS Retina, perhitungkan rasio piksel perangkat 2x
Klik mendarat di area yang benar tetapi meleset dari targetTarget sangat kecil, detail hilang saat downscale dari sumber 4K+, atau rasio aspek terdistorsiTetap aktifkan anggota zoom dan implementasikan agar Claude dapat memeriksa wilayah tersebut pada resolusi penuh; ambil pada DPI lebih rendah atau crop ke wilayah yang relevan; pertahankan rasio aspek saat mengubah ukuran
Claude mengklik elemen yang sepenuhnya salahInstruksi ambigu, atau elemen yang mirip secara visual di dekatnyaGunakan prompt posisional (“tombol Submit biru di kanan bawah”); pecah interaksi menjadi langkah-langkah yang lebih kecil
Akurasi secara konsisten burukResolusi terlalu rendahCoba 1280x720 sebagai baseline

Ikuti praktik terbaik implementasi


Migrasi dari computer_20251124

Integrasi computer_20251124 berfungsi tanpa perubahan pada model yang tercantum untuk versi tersebut di bawah Versi alat sebelumnya. Tingkatkan integrasi tersebut sebelum Anda memindahkannya ke model yang tidak menerima computer_20251124, seperti Claude Opus 5.5 di Claude API.

Untuk melakukan peningkatan, terapkan perubahan berikut secara bersamaan:

  1. Hapus header beta. Jangan sertakan lagi anthropic-beta: computer-use-2025-11-24 dalam permintaan Anda. Dengan SDK, hapus betas dan panggil Messages API melalui klien standar, bukan namespace beta.
  2. Ubah entri tools. Atur type ke computer_toolset_20260801 dan hapus name, display_width_px, display_height_px, display_number, dan enable_zoom. Toolset menolak setiap field tersebut.
  3. Pilih apakah zoom tetap diaktifkan. Zoom diaktifkan secara default pada toolset, sedangkan enable_zoom default-nya false. Jika lingkungan Anda tidak mengimplementasikan zoom, tambahkan "configs": {"zoom": {"enabled": false}} untuk mempertahankan perilaku sebelumnya; jika tidak, implementasikan zoom (lihat Tindakan yang tersedia).
  4. Tangani setiap blok dalam satu giliran. Perbarui loop agen Anda untuk melakukan iterasi atas setiap blok tool_use dalam respons alih-alih hanya membaca yang pertama, dan untuk melakukan dispatch berdasarkan name blok bersama dengan toolset_name, bukan berdasarkan input.action. Input anggota tidak lagi berisi field action; field lainnya tidak berubah.
  5. Jalankan blok secara berurutan dan gunakan teks penghentian. Jalankan blok secara berurutan, berhenti pada kegagalan pertama, dan jawab blok yang tersisa dengan Not executed: an earlier computer action in this turn failed. seperti yang dijelaskan di Tindakan batch. Jika loop Anda belum dapat menjalankan batch, Parameter alat menjelaskan cara membatasi Claude ke satu aksi untuk setiap giliran.
  6. Sertakan kembali toolset_name pada hasil. Tambahkan "toolset_name": "computer" ke setiap tool_result yang menjawab panggilan anggota. Hasil hanya boleh berisi konten text dan image.
  7. Dukung repeat pada key. Anggota key menerima jumlah repeat opsional dari 1 hingga 100. Handler yang mengabaikan field yang tidak dikenali akan menekan tombol sekali saja, jadi pastikan handler key Anda mematuhi repeat.
  8. Ubah ukuran screenshot sendiri. Toolset menolak screenshot atau gambar zoom yang melebihi batas gambar model alih-alih melakukan downscale. Ubah ukuran sebelum mengembalikan gambar dan tetap skalakan koordinat seperti yang dijelaskan di Sesuaikan ukuran screenshot agar sesuai batas gambar.
  9. Hapus opsi yang tidak didukung. Pindahkan defer_loading apa pun dari entri ke configs, dengan nilai yang sama pada setiap anggota yang diaktifkan. Opsi lain yang tidak didukung pada entri toolset tercantum di Toolset klien.

Ini adalah entri tools sebelum perubahan, dikirim dengan header anthropic-beta: computer-use-2025-11-24:

{
  "type": "computer_20251124",
  "name": "computer",
  "display_width_px": 1024,
  "display_height_px": 768,
  "display_number": 1
}

Ini adalah entri tools setelah perubahan, dikirim tanpa header beta. Objek configs menjaga zoom tetap nonaktif agar sesuai dengan entri sebelumnya, yang tidak mengatur enable_zoom; hilangkan configs sepenuhnya untuk menerima default dan membiarkan Claude melakukan zoom:

{
  "type": "computer_toolset_20260801",
  "configs": {
    "zoom": { "enabled": false }
  }
}

Pasangan berikut menunjukkan blok tool_use sebelum dan sesudah perubahan. Nama aksi berpindah dari input.action ke name, dan blok mendapatkan toolset_name:

{
  "type": "tool_use",
  "id": "toolu_01A9r5kQm2LxWc7vT3nZ4bJs",
  "name": "computer",
  "input": { "action": "left_click", "coordinate": [500, 300] }
}
{
  "type": "tool_use",
  "id": "toolu_01A9r5kQm2LxWc7vT3nZ4bJs",
  "name": "left_click",
  "toolset_name": "computer",
  "input": { "coordinate": [500, 300] }
}

Versi alat sebelumnya

Dua versi sebelumnya dari alat penggunaan komputer tersedia dalam beta. Masing-masing memerlukan header beta miliknya pada setiap permintaan, dan parameternya didokumentasikan dalam referensi Messages API betaPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali.. Dengan SDK, teruskan header melalui betas dan gunakan namespace beta; hanya alat penggunaan komputer yang memerlukan header tersebut, bukan alat bash atau editor teks dalam permintaan yang sama.

Versi alatHeader betaGunakan denganParameter
computer_20251124computer-use-2025-11-24Claude Fable 5.1, Claude Mythos 5.1, Claude Fable 5, Claude Mythos 5, Claude Opus 5, Claude Sonnet 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 4.6, dan Claude Opus 4.5Referensi APIPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali.
computer_20250124computer-use-2025-01-24Claude Sonnet 4.5 (tidak digunakan lagi), Claude Haiku 4.5, Claude Opus 4.1 (dihentikan, kecuali di Claude Models on Google Cloud (Google managed) dan Bedrock), Claude Sonnet 4 (dihentikan, kecuali di Claude Models on Google Cloud (Google managed) dan Bedrock), dan Claude Opus 4 (dihentikan, kecuali di Claude Models on Google Cloud (Google managed))Referensi APIPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali.

Di Amazon Bedrock, Claude Fable 5.2, Claude Mythos 5.2, Claude Opus 5.5, Claude Sonnet 5.5, dan Claude Haiku 5.5 juga menerima alat computer_20251124 dengan header beta computer-use-2025-11-24. Dengan InvokeModel API dari Amazon Bedrock, kirimkan computer-use-2025-11-24 dalam array anthropic_beta pada body permintaan, bukan dalam header. Untuk API tersebut, lihat Claude di Amazon Bedrock (bedrock-runtime).


Keterbatasan

  1. Latensi: “Latency” (latensi) penggunaan komputer untuk interaksi manusia-AI mungkin terlalu lambat dibandingkan dengan aksi komputer reguler yang diarahkan manusia. Fokus pada kasus penggunaan di mana kecepatan tidak kritis (misalnya, pengumpulan informasi latar belakang, pengujian perangkat lunak otomatis) di lingkungan tepercaya.
  2. Akurasi dan keandalan computer vision: Claude mungkin membuat kesalahan atau berhalusinasi saat mengeluarkan koordinat tertentu ketika menghasilkan aksi. Output pemikiran yang diringkas Claude dapat membantu Anda memahami penalaran model dan mengidentifikasi potensi masalah; atur display: "summarized" pada konfigurasi pemikiran, karena model yang mendukung toolset menghilangkan teks pemikiran secara default.
  3. Akurasi dan keandalan pemilihan alat: Claude mungkin membuat kesalahan atau berhalusinasi saat memilih alat ketika menghasilkan aksi atau mengambil aksi yang tidak terduga untuk menyelesaikan masalah. Selain itu, keandalan mungkin lebih rendah saat berinteraksi dengan aplikasi khusus atau beberapa aplikasi sekaligus. Berikan prompt kepada model dengan hati-hati saat meminta tugas yang kompleks.
  4. Keandalan scrolling: Aksi gulir mendukung kontrol arah (atas, bawah, kiri, kanan) dan jumlah yang ditentukan. Dalam aplikasi di mana scrolling tidak berpengaruh, alternatif keyboard seperti Page Down dapat membantu.
  5. Interaksi spreadsheet: Gunakan aksi kontrol mouse yang lebih terperinci (left_mouse_down, left_mouse_up) dan kombinasi tombol modifier untuk memilih sel individual. Operasi spreadsheet yang kompleks mungkin masih memerlukan beberapa kali percobaan.
  6. Pembuatan akun dan pembuatan konten di platform sosial dan komunikasi: Meskipun Claude mengunjungi situs web, kemampuannya untuk membuat akun, menghasilkan dan membagikan konten, atau terlibat dalam peniruan identitas manusia di situs web dan platform media sosial terbatas.
  7. Kerentanan: Jailbreak dan injeksi prompt dapat memengaruhi penggunaan komputer sebagaimana dapat memengaruhi sistem AI frontier mana pun, termasuk melalui instruksi yang disematkan di halaman web atau gambar; terapkan tindakan pencegahan di Pertimbangan keamanan.
  8. Aksi yang tidak pantas atau ilegal: Berdasarkan Ketentuan Layanan Anthropic, Anda tidak boleh menggunakan penggunaan komputer untuk melanggar hukum apa pun atau Kebijakan Penggunaan yang Dapat Diterima.

Selalu tinjau dan verifikasi dengan cermat aksi dan log penggunaan komputer Claude. Jangan gunakan Claude untuk tugas yang memerlukan presisi sempurna atau informasi pengguna yang sensitif tanpa pengawasan manusia.

Retensi data

Penggunaan komputer adalah alat sisi klien. Semua screenshot, aksi mouse, input keyboard, dan file apa pun yang terlibat dalam sesi diambil dan disimpan di lingkungan Anda, bukan oleh Anthropic. Anthropic memproses gambar screenshot dan permintaan aksi secara real time sebagai bagian dari panggilan API. Retensi untuk permintaan API tersebut diatur oleh API dan retensi data.

Karena aplikasi Anda mengontrol di mana dan bagaimana data penggunaan komputer disimpan, penggunaan komputer memenuhi syarat ZDR.

Harga

Penggunaan komputer mengikuti harga penggunaan alat standar. Saat menggunakan alat penggunaan komputer:

Overhead definisi toolset: Mendeklarasikan computer_toolset_20260801 dengan anggota default-nya menambahkan sekitar 4.500 token input ke sebuah permintaan (sekitar 4.590 pada Claude Sonnet 5 dan sekitar 4.520 pada model lain yang didukung), yang mencakup definisi alat anggota dan prompt sistem penggunaan alat. Menonaktifkan zoom dengan configs menghapus sekitar 410 dari token tersebut. Jumlah pasti untuk sebuah permintaan dilaporkan dalam usage respons, dan Anda dapat memperkirakannya terlebih dahulu dengan endpoint penghitungan token.

Versi alat sebelumnya: Angka-angka berikut berlaku untuk versi alat computer_20251124 dan computer_20250124, bukan untuk computer_toolset_20260801:

  • Overhead prompt sistem: 466–499 token ditambahkan ke prompt sistem
  • Definisi alat: sekitar 735 token input per definisi alat (diukur dengan computer_20250124)

Konsumsi token tambahan:

  • Gambar tangkapan layar dan zoom yang dikembalikan dalam hasil alat, ditagih sebagai input gambar (lihat Harga Vision)
  • Hasil eksekusi alat yang dikembalikan ke Claude

Langkah selanjutnya

Mulai dari driver mitra, atau tulis driver Anda sendiri dalam Python atau TypeScript. SDK menjalankan loop dan callback persetujuan yang Anda berikan.

Perbaiki kesalahan penggunaan alat yang paling umum dengan tabel diagnostik gejala-ke-perbaikan.

Mulai dengan implementasi lengkap berbasis Docker.

Hubungkan Claude ke alat dan API eksternal. Lihat di mana alat berjalan, kapan Claude memanggilnya, dan alat mana yang sesuai dengan tugas Anda.

Rekomendasi berbasis benchmark untuk resolusi, effort pemikiran, dan manajemen konteks.

Biarkan Claude menavigasi, membaca, dan berinteraksi dengan halaman web di lingkungan browser Anda sendiri, untuk tugas yang tetap berada di dalam browser.

Ketersediaan

Alat penggunaan komputer
API
  • Messages API
  • Managed Agents Tidak didukung
Model
  • Claude Fable 5.2, Fable 5.1, Fable 5
  • Claude Mythos 5.2, Mythos 5.1, Mythos 5, Mythos Preview
  • Claude Opus 5.5, Opus 5, Opus 4.8
  • Claude Opus 4.7, Opus 4.6, Opus 4.5 Beta memerlukan
  • Claude Sonnet 5.5, Sonnet 5
  • Claude Sonnet 4.6 Beta memerlukan
  • Claude Sonnet 4.5 Beta memerlukan
  • Claude Haiku 5.5
  • Claude Haiku 4.5 Beta memerlukan

Endpoint yang berlaku

  • /v1/messages dengan toolset atau alat computer
Retensi data nolLayak

Tidak termasuk Model yang dicakup

Alat sisi klien tempat screenshot dan file diambil dan disimpan di environment Anda, bukan oleh Anthropic. Pelajari lebih lanjut

HIPAALayak

Apakah halaman ini membantu?