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.5Migrasi ke Claude 4.5Penghentian modelHarga
    Bangun dengan Claude
    Ikhtisar fiturMenggunakan Messages APIJendela konteksPraktik terbaik prompting
    Kemampuan
    Prompt cachingPengeditan konteksPemikiran diperpanjangUpayaStreaming PesanPemrosesan batchKutipanDukungan multibahasaPenghitungan tokenEmbeddingsVisiDukungan PDFFiles APIHasil pencarianOutput terstrukturAdd-on Google Sheets
    Alat
    IkhtisarCara mengimplementasikan penggunaan alatPenggunaan alat yang efisien tokenStreaming alat berbutir halusAlat BashAlat eksekusi kodePemanggilan alat terprogramAlat penggunaan komputerAlat editor teksAlat pengambilan webAlat pencarian webAlat memoriAlat pencarian alat
    Keterampilan Agen
    IkhtisarMulai cepatPraktik terbaikMenggunakan Keterampilan dengan API
    Agent SDK
    IkhtisarTypeScript SDKPython SDKPanduan Migrasi
    Panduan
    Input StreamingMenangani IzinManajemen SesiOutput terstruktur di SDKHosting Agent SDKMemodifikasi prompt sistemMCP di SDKAlat KustomSubagen di SDKPerintah Garis Miring di SDKKeterampilan Agen di SDKMelacak Biaya dan PenggunaanDaftar TugasPlugin di SDK
    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)Isi sebelumnya respons ClaudeRantai 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 berkarakter
    Administrasi dan pemantauan
    Ikhtisar Admin APIAPI Penggunaan dan BiayaClaude Code Analytics API
    Console
    Log in
    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
    Alat

    Alat penggunaan komputer

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

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

    Penggunaan komputer saat ini dalam beta dan memerlukan header beta:

    • "computer-use-2025-11-24" (Claude Opus 4.5)
    • "computer-use-2025-01-24" (Model Claude 4 dan Claude Sonnet 3.7 (tidak direkomendasikan))

    Ikhtisar

    Penggunaan komputer adalah fitur beta yang memungkinkan Claude berinteraksi dengan lingkungan desktop. Alat ini menyediakan:

    • Tangkapan layar: Lihat apa yang saat ini ditampilkan di layar
    • Kontrol mouse: Klik, seret, dan pindahkan kursor
    • Input keyboard: Ketik teks dan gunakan pintasan keyboard
    • Otomasi desktop: Berinteraksi dengan aplikasi atau antarmuka apa pun

    Meskipun penggunaan komputer dapat ditingkatkan dengan alat lain seperti bash dan editor teks untuk alur kerja otomasi yang lebih komprehensif, penggunaan komputer secara khusus mengacu pada kemampuan alat penggunaan komputer untuk melihat dan mengontrol lingkungan desktop.

    Kompatibilitas model

    Penggunaan komputer tersedia untuk model Claude berikut:

    ModelVersi AlatBendera Beta
    Claude Opus 4.5computer_20251124computer-use-2025-11-24
    Model Claude 4computer_20250124computer-use-2025-01-24
    Claude Sonnet 3.7 (tidak direkomendasikan)computer_20250124computer-use-2025-01-24

    Claude Opus 4.5 memperkenalkan versi alat computer_20251124 dengan kemampuan baru termasuk tindakan zoom untuk inspeksi wilayah layar terperinci. Model Claude 4 menggunakan versi alat yang diperbarui dan dioptimalkan untuk arsitektur baru. Claude Sonnet 3.7 (tidak direkomendasikan) memperkenalkan kemampuan tambahan termasuk fitur pemikiran untuk wawasan lebih lanjut tentang proses penalaran model.

    Versi alat yang lebih lama tidak dijamin kompatibel ke belakang dengan model yang lebih baru. Selalu gunakan versi alat yang sesuai dengan versi model Anda.

    Pertimbangan keamanan

    Penggunaan komputer adalah fitur beta dengan risiko unik yang berbeda dari fitur API standar. Risiko ini meningkat ketika berinteraksi dengan internet. Untuk meminimalkan risiko, pertimbangkan untuk mengambil tindakan pencegahan seperti:

    1. Gunakan mesin virtual atau kontainer khusus dengan hak istimewa minimal untuk mencegah serangan sistem langsung atau kecelakaan.
    2. Hindari memberikan model akses ke data sensitif, seperti informasi login akun, untuk mencegah pencurian informasi.
    3. Batasi akses internet ke daftar putih domain untuk mengurangi paparan terhadap konten berbahaya.
    4. Minta manusia untuk mengonfirmasi keputusan yang mungkin menghasilkan konsekuensi dunia nyata yang bermakna serta tugas apa pun yang memerlukan persetujuan afirmatif, seperti menerima cookie, melaksanakan transaksi keuangan, atau menyetujui syarat layanan.

    Dalam beberapa keadaan, Claude akan mengikuti perintah yang ditemukan dalam konten bahkan jika bertentangan dengan instruksi pengguna. Misalnya, instruksi Claude di halaman web atau yang terdapat dalam gambar dapat mengganti instruksi atau menyebabkan Claude membuat kesalahan. Kami menyarankan untuk mengambil tindakan pencegahan untuk mengisolasi Claude dari data dan tindakan sensitif untuk menghindari risiko terkait injeksi prompt.

    Kami telah melatih model untuk menahan injeksi prompt ini dan telah menambahkan lapisan pertahanan ekstra. Jika Anda menggunakan alat penggunaan komputer kami, kami akan secara otomatis menjalankan pengklasifikasi pada prompt Anda untuk menandai kemungkinan contoh injeksi prompt. Ketika pengklasifikasi ini mengidentifikasi kemungkinan injeksi prompt dalam tangkapan layar, mereka akan secara otomatis mengarahkan model untuk meminta konfirmasi pengguna sebelum melanjutkan dengan tindakan berikutnya. Kami menyadari bahwa perlindungan ekstra ini tidak akan ideal untuk setiap kasus penggunaan (misalnya, kasus penggunaan tanpa manusia dalam loop), jadi jika Anda ingin menolak dan mematikannya, silakan hubungi kami.

    Kami masih menyarankan untuk mengambil tindakan pencegahan untuk mengisolasi Claude dari data dan tindakan sensitif untuk menghindari risiko terkait injeksi prompt.

    Implementasi referensi penggunaan komputer

    Mulai dengan cepat dengan implementasi referensi penggunaan komputer kami yang mencakup antarmuka web, kontainer Docker, implementasi alat contoh, dan loop agen.

    Catatan: Implementasi telah diperbarui untuk menyertakan alat baru untuk model Claude 4 dan Claude Sonnet 3.7. Pastikan untuk menarik versi terbaru repo untuk mengakses fitur baru ini.

    Silakan gunakan formulir ini untuk memberikan umpan balik tentang kualitas respons model, API itu sendiri, atau kualitas dokumentasi - kami tidak sabar untuk mendengar dari Anda!

    Mulai cepat

    Berikut cara memulai dengan penggunaan komputer:

    Header beta hanya diperlukan untuk alat penggunaan komputer.

    Contoh di atas menunjukkan ketiga alat digunakan bersama-sama, yang memerlukan header beta karena mencakup alat penggunaan komputer.


    Cara kerja penggunaan komputer

    Kami menyebut pengulangan langkah 3 dan 4 tanpa input pengguna sebagai "loop agen" - yaitu, Claude merespons dengan permintaan penggunaan alat dan aplikasi Anda merespons Claude dengan hasil evaluasi permintaan tersebut.

    Claude dapat berinteraksi dengan lingkungan komputer melalui alat computer use, yang menyediakan kemampuan tangkapan layar dan kontrol mouse/keyboard untuk interaksi desktop otonom.

    Computer use saat ini dalam beta dan memerlukan beta header:

    • "computer-use-2025-11-24" (Claude Opus 4.5)
    • "computer-use-2025-01-24" (Claude 4 models dan Claude Sonnet 3.7 (deprecated))

    Ikhtisar

    Computer use adalah fitur beta yang memungkinkan Claude untuk berinteraksi dengan lingkungan desktop. Alat ini menyediakan:

    • Tangkapan layar: Lihat apa yang saat ini ditampilkan di layar
    • Kontrol mouse: Klik, seret, dan pindahkan kursor
    • Input keyboard: Ketik teks dan gunakan pintasan keyboard
    • Otomasi desktop: Berinteraksi dengan aplikasi atau antarmuka apa pun

    Meskipun computer use dapat ditingkatkan dengan alat lain seperti bash dan editor teks untuk alur kerja otomasi yang lebih komprehensif, computer use secara khusus mengacu pada kemampuan alat computer use untuk melihat dan mengontrol lingkungan desktop.

    Kompatibilitas model

    Computer use tersedia untuk model Claude berikut:

    ModelVersi AlatBendera Beta
    Claude Opus 4.5computer_20251124computer-use-2025-11-24
    Claude 4 modelscomputer_20250124computer-use-2025-01-24
    Claude Sonnet 3.7 (deprecated)computer_20250124computer-use-2025-01-24

    Claude Opus 4.5 memperkenalkan versi alat computer_20251124 dengan kemampuan baru termasuk aksi zoom untuk inspeksi wilayah layar terperinci. Claude 4 models menggunakan versi alat yang diperbarui dan dioptimalkan untuk arsitektur baru. Claude Sonnet 3.7 (deprecated) memperkenalkan kemampuan tambahan termasuk fitur thinking untuk wawasan lebih dalam tentang proses penalaran model.

    Versi alat yang lebih lama tidak dijamin kompatibel mundur dengan model yang lebih baru. Selalu gunakan versi alat yang sesuai dengan versi model Anda.

    Pertimbangan keamanan

    Computer use adalah fitur beta dengan risiko unik yang berbeda dari fitur API standar. Risiko ini meningkat ketika berinteraksi dengan internet. Untuk meminimalkan risiko, pertimbangkan untuk mengambil tindakan pencegahan seperti:

    1. Gunakan mesin virtual atau kontainer khusus dengan hak istimewa minimal untuk mencegah serangan sistem langsung atau kecelakaan.
    2. Hindari memberikan model akses ke data sensitif, seperti informasi login akun, untuk mencegah pencurian informasi.
    3. Batasi akses internet ke daftar putih domain untuk mengurangi paparan terhadap konten berbahaya.
    4. Minta manusia untuk mengkonfirmasi keputusan yang mungkin menghasilkan konsekuensi dunia nyata yang bermakna serta tugas apa pun yang memerlukan persetujuan afirmatif, seperti menerima cookie, melaksanakan transaksi keuangan, atau menyetujui syarat layanan.

    Dalam beberapa keadaan, Claude akan mengikuti perintah yang ditemukan dalam konten bahkan jika bertentangan dengan instruksi pengguna. Misalnya, instruksi Claude di halaman web atau yang terdapat dalam gambar dapat mengganti instruksi atau menyebabkan Claude membuat kesalahan. Kami menyarankan untuk mengambil tindakan pencegahan untuk mengisolasi Claude dari data dan tindakan sensitif untuk menghindari risiko yang terkait dengan prompt injection.

    Kami telah melatih model untuk menahan prompt injection ini dan telah menambahkan lapisan pertahanan ekstra. Jika Anda menggunakan alat computer use kami, kami akan secara otomatis menjalankan pengklasifikasi pada prompt Anda untuk menandai kemungkinan contoh prompt injection. Ketika pengklasifikasi ini mengidentifikasi kemungkinan prompt injection dalam tangkapan layar, mereka akan secara otomatis mengarahkan model untuk meminta konfirmasi pengguna sebelum melanjutkan dengan tindakan berikutnya. Kami menyadari bahwa perlindungan ekstra ini tidak akan ideal untuk setiap kasus penggunaan (misalnya, kasus penggunaan tanpa manusia dalam loop), jadi jika Anda ingin memilih keluar dan mematikannya, silakan hubungi kami.

    Kami masih menyarankan untuk mengambil tindakan pencegahan untuk mengisolasi Claude dari data dan tindakan sensitif untuk menghindari risiko yang terkait dengan prompt injection.

    Implementasi referensi computer use

    Mulai dengan cepat dengan implementasi referensi computer use kami yang mencakup antarmuka web, kontainer Docker, implementasi alat contoh, dan loop agen.

    Catatan: Implementasi telah diperbarui untuk menyertakan alat baru untuk Claude 4 models dan Claude Sonnet 3.7. Pastikan untuk menarik versi terbaru repo untuk mengakses fitur baru ini.

    Silakan gunakan formulir ini untuk memberikan umpan balik tentang kualitas respons model, API itu sendiri, atau kualitas dokumentasi - kami tidak sabar untuk mendengar dari Anda!

    Mulai cepat

    Berikut cara memulai dengan computer use:

    Header beta hanya diperlukan untuk alat computer use.

    Contoh di atas menunjukkan ketiga alat digunakan bersama-sama, yang memerlukan header beta karena mencakup alat computer use.


    Cara kerja computer use

    Kami merujuk pada pengulangan langkah 3 dan 4 tanpa input pengguna sebagai "agent loop" - yaitu, Claude merespons dengan permintaan penggunaan alat dan aplikasi Anda merespons Claude dengan hasil evaluasi permintaan tersebut.

    Lingkungan komputasi

    Computer use memerlukan lingkungan komputasi bersandal di mana Claude dapat dengan aman berinteraksi dengan aplikasi dan web. Lingkungan ini mencakup:

    1. Tampilan virtual: Server tampilan X11 virtual (menggunakan Xvfb) yang merender antarmuka desktop yang akan dilihat Claude melalui tangkapan layar dan dikontrol 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 Claude berinteraksi.

    3. Aplikasi: Aplikasi Linux yang telah diinstal sebelumnya 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 "pindahkan mouse" atau "ambil tangkapan layar") menjadi operasi aktual di lingkungan virtual.

    5. Agent loop: Program yang menangani komunikasi antara Claude dan lingkungan, mengirim tindakan Claude ke lingkungan dan mengembalikan hasil (tangkapan layar, output perintah) kembali ke Claude.

    Ketika Anda menggunakan computer use, Claude tidak terhubung langsung ke lingkungan ini. Sebaliknya, aplikasi Anda:

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

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


    Cara mengimplementasikan computer use

    Mulai dengan implementasi referensi kami

    Kami telah membangun implementasi referensi yang mencakup semua yang Anda butuhkan untuk memulai dengan cepat dengan computer use:

    • Lingkungan terkontainerisasi yang cocok untuk computer use dengan Claude
    • Implementasi alat computer use
    • Agent loop yang berinteraksi dengan Claude API dan menjalankan alat computer use
    • Antarmuka web untuk berinteraksi dengan kontainer, agent loop, dan alat.

    Memahami agent loop multi-agen

    Inti dari computer use adalah "agent loop" - siklus di mana Claude meminta tindakan alat, aplikasi Anda menjalankannya, dan mengembalikan hasil ke Claude. Berikut adalah contoh yang disederhanakan:

    async def sampling_loop(
        *,
        model: str,
        messages: list[dict],
        api_key: str,
        max_tokens: int = 4096,
        tool_version: str,
        thinking_budget: int | None = None,
        max_iterations: int = 10,  # Tambahkan batas iterasi untuk mencegah loop tak terbatas
    ):
        """
        Agent loop sederhana untuk interaksi computer use Claude.
    
        Fungsi ini menangani bolak-balik antara:
        1. Mengirim pesan pengguna ke Claude
        2. Claude meminta untuk menggunakan alat
        3. Aplikasi Anda menjalankan alat tersebut
        4. Mengirim hasil alat kembali ke Claude
        """
        # Siapkan alat dan parameter API
        client = Anthropic(api_key=api_key)
        beta_flag = "computer-use-2025-01-24" if "20250124" in tool_version else "computer-use-2024-10-22"
    
        # Konfigurasi alat - Anda seharusnya sudah menginisialisasi ini di tempat lain
        tools = [
            {"type": f"computer_{tool_version}", "name": "computer", "display_width_px": 1024, "display_height_px": 768},
            {"type": f"text_editor_{tool_version}", "name": "str_replace_editor"},
            {"type": f"bash_{tool_version}", "name": "bash"}
        ]
    
        # Agent loop utama (dengan batas iterasi untuk mencegah biaya API yang melonjak)
        iterations = 0
        while True and iterations < max_iterations:
            iterations += 1
            # Siapkan parameter thinking opsional (untuk Claude Sonnet 3.7)
            thinking = None
            if thinking_budget:
                thinking = {"type": "enabled", "budget_tokens": thinking_budget}
    
            # Panggil Claude API
            response = client.beta.messages.create(
                model=model,
                max_tokens=max_tokens,
                messages=messages,
                tools=tools,
                betas=[beta_flag],
                thinking=thinking
            )
    
            # Tambahkan respons Claude ke riwayat percakapan
            response_content = response.content
            messages.append({"role": "assistant", "content": response_content})
    
            # Periksa apakah Claude menggunakan alat apa pun
            tool_results = []
            for block in response_content:
                if block.type == "tool_use":
                    # Dalam aplikasi nyata, Anda akan menjalankan alat di sini
                    # Misalnya: result = run_tool(block.name, block.input)
                    result = {"result": "Tool executed successfully"}
    
                    # Format hasil untuk Claude
                    tool_results.append({
                        "type": "tool_result",
                        "tool_use_id": block.id,
                        "content": result
                    })
    
            # Jika tidak ada alat yang digunakan, Claude selesai - kembalikan pesan final
            if not tool_results:
                return messages
    
            # Tambahkan hasil alat ke pesan untuk iterasi berikutnya dengan Claude
            messages.append({"role": "user", "content": tool_results})

    Loop berlanjut hingga Claude merespons tanpa meminta alat apa pun (penyelesaian tugas) atau batas iterasi maksimum tercapai. Perlindungan ini mencegah loop tak terbatas yang mungkin menghasilkan biaya API yang tidak terduga.

    Saat menggunakan alat computer use, Anda harus menyertakan bendera beta yang sesuai untuk versi model Anda:

    Kami merekomendasikan untuk mencoba implementasi referensi terlebih dahulu sebelum membaca sisa dokumentasi ini.

    Optimalkan kinerja model dengan prompting

    Berikut adalah beberapa tips tentang cara mendapatkan output berkualitas terbaik:

    1. Tentukan tugas yang sederhana dan terdefinisi dengan baik serta berikan instruksi eksplisit untuk setiap langkah.
    2. Claude kadang-kadang mengasumsikan hasil tindakannya tanpa secara eksplisit memeriksa hasilnya. Untuk mencegah ini, Anda dapat memberi prompt Claude dengan After each step, take a screenshot and carefully evaluate if you have achieved the right outcome. Explicitly show your thinking: "I have evaluated step X..." If not correct, 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 untuk Claude manipulasi menggunakan gerakan mouse. Jika Anda mengalami ini, coba beri prompt model untuk menggunakan pintasan keyboard.
    4. Untuk tugas yang dapat diulang atau interaksi UI, sertakan tangkapan layar contoh dan panggilan alat hasil yang berhasil dalam prompt Anda.
    5. Jika Anda perlu model untuk masuk, berikan nama pengguna dan kata sandi dalam prompt Anda di dalam tag xml seperti <robot_credentials>. Menggunakan computer use dalam aplikasi yang memerlukan login meningkatkan risiko hasil buruk karena prompt injection. Silakan tinjau panduan kami tentang mitigasi prompt injection sebelum memberikan model kredensial login.

    Jika Anda berulang kali mengalami serangkaian masalah yang jelas atau mengetahui sebelumnya tugas yang perlu diselesaikan Claude, gunakan system prompt untuk memberikan Claude tips atau instruksi eksplisit tentang cara menyelesaikan tugas dengan sukses.

    System prompts

    Ketika salah satu alat yang ditentukan Anthropic diminta melalui Claude API, system prompt khusus computer use dihasilkan. Ini mirip dengan tool use system prompt 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 dengan tool use reguler, bidang system_prompt yang disediakan pengguna masih dihormati dan digunakan dalam konstruksi system prompt gabungan.

    Cara mengimplementasikan computer use

    Mulai dengan implementasi referensi kami

    Kami telah membangun implementasi referensi yang mencakup semua yang Anda butuhkan untuk memulai dengan cepat dengan computer use:

    • Lingkungan terkontainerisasi yang cocok untuk computer use dengan Claude
    • Implementasi alat computer use
    • Loop agen yang berinteraksi dengan Claude API dan menjalankan alat computer use
    • Antarmuka web untuk berinteraksi dengan kontainer, loop agen, dan alat.

    Memahami loop multi-agen

    Inti dari computer use adalah "agent loop" - siklus di mana Claude meminta tindakan alat, aplikasi Anda menjalankannya, dan mengembalikan hasil ke Claude. Berikut adalah contoh yang disederhanakan:

    async def sampling_loop(
        *,
        model: str,
        messages: list[dict],
        api_key: str,
        max_tokens: int = 4096,
        tool_version: str,
        thinking_budget: int | None = None,
        max_iterations: int = 10,  # Add iteration limit to prevent infinite loops
    ):
        """
        A simple agent loop for Claude computer use interactions.
    
        This function handles the back-and-forth between:
        1. Sending user messages to Claude
        2. Claude requesting to use tools
        3. Your app executing those tools
        4. Sending tool results back to Claude
        """
        # Set up tools and API parameters
        client = Anthropic(api_key=api_key)
        beta_flag = "computer-use-2025-01-24" if "20250124" in tool_version else "computer-use-2024-10-22"
    
        # Configure tools - you should already have these initialized elsewhere
        tools = [
            {"type": f"computer_{tool_version}", "name": "computer", "display_width_px": 1024, "display_height_px": 768},
            {"type": f"text_editor_{tool_version}", "name": "str_replace_editor"},
            {"type": f"bash_{tool_version}", "name": "bash"}
        ]
    
        # Main agent loop (with iteration limit to prevent runaway API costs)
        iterations = 0
        while True and iterations < max_iterations:
            iterations += 1
            # Set up optional thinking parameter (for Claude Sonnet 3.7)
            thinking = None
            if thinking_budget:
                thinking = {"type": "enabled", "budget_tokens": thinking_budget}
    
            # Call the Claude API
            response = client.beta.messages.create(
                model=model,
                max_tokens=max_tokens,
                messages=messages,
                tools=tools,
                betas=[beta_flag],
                thinking=thinking
            )
    
            # Add Claude's response to the conversation history
            response_content = response.content
            messages.append({"role": "assistant", "content": response_content})
    
            # Check if Claude used any tools
            tool_results = []
            for block in response_content:
                if block.type == "tool_use":
                    # In a real app, you would execute the tool here
                    # For example: result = run_tool(block.name, block.input)
                    result = {"result": "Tool executed successfully"}
    
                    # Format the result for Claude
                    tool_results.append({
                        "type": "tool_result",
                        "tool_use_id": block.id,
                        "content": result
                    })
    
            # If no tools were used, Claude is done - return the final messages
            if not tool_results:
                return messages
    
            # Add tool results to messages for the next iteration with Claude
            messages.append({"role": "user", "content": tool_results})

    Loop berlanjut sampai Claude merespons tanpa meminta alat apa pun (penyelesaian tugas) atau batas iterasi maksimum tercapai. Perlindungan ini mencegah loop tak terbatas potensial yang dapat menghasilkan biaya API yang tidak terduga.

    Saat menggunakan alat computer use, Anda harus menyertakan bendera beta yang sesuai untuk versi model Anda:

    Kami merekomendasikan untuk mencoba implementasi referensi terlebih dahulu sebelum membaca sisa dokumentasi ini.

    Optimalkan kinerja model dengan prompting

    Berikut adalah beberapa tips tentang cara mendapatkan output berkualitas terbaik:

    1. Tentukan tugas yang sederhana dan terdefinisi dengan baik serta berikan instruksi eksplisit untuk setiap langkah.
    2. Claude kadang-kadang mengasumsikan hasil tindakannya tanpa secara eksplisit memeriksa hasilnya. Untuk mencegah ini, Anda dapat memberi prompt Claude dengan After each step, take a screenshot and carefully evaluate if you have achieved the right outcome. Explicitly show your thinking: "I have evaluated step X..." If not correct, 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 untuk Claude manipulasi menggunakan gerakan mouse. Jika Anda mengalami ini, coba beri prompt model untuk menggunakan pintasan keyboard.
    4. Untuk tugas yang dapat diulang atau interaksi UI, sertakan tangkapan layar contoh dan panggilan alat hasil yang berhasil dalam prompt Anda.
    5. Jika Anda memerlukan model untuk masuk, berikan nama pengguna dan kata sandi dalam prompt Anda di dalam tag xml seperti <robot_credentials>. Menggunakan computer use dalam aplikasi yang memerlukan login meningkatkan risiko hasil yang buruk sebagai akibat dari prompt injection. Silakan tinjau panduan kami tentang mitigasi prompt injections sebelum memberikan model dengan kredensial login.

    Jika Anda berulang kali mengalami serangkaian masalah yang jelas atau mengetahui sebelumnya tugas-tugas yang perlu diselesaikan Claude, gunakan system prompt untuk memberikan Claude tips atau instruksi eksplisit tentang cara menyelesaikan tugas dengan sukses.

    System prompts

    Ketika salah satu alat yang ditentukan Anthropic diminta melalui Claude API, system prompt khusus computer use dibuat. Ini mirip dengan tool use system prompt 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 dengan tool use reguler, field system_prompt yang disediakan pengguna tetap dihormati dan digunakan dalam konstruksi system prompt gabungan.

    Tindakan yang tersedia

    Alat computer use mendukung tindakan-tindakan ini:

    Tindakan dasar (semua versi)

    • screenshot - Tangkap tampilan saat ini
    • left_click - Klik pada koordinat [x, y]
    • type - Ketik string teks
    • key - Tekan tombol atau kombinasi tombol (misalnya, "ctrl+s")
    • mouse_move - Pindahkan kursor ke koordinat

    Tindakan yang ditingkatkan (computer_20250124) Tersedia di Claude 4 models dan Claude Sonnet 3.7:

    • scroll - Gulir ke arah mana pun dengan kontrol jumlah
    • left_click_drag - Klik dan seret antar koordinat
    • right_click, middle_click - Tombol mouse tambahan
    • double_click, triple_click - Beberapa klik
    • left_mouse_down, left_mouse_up - Kontrol klik terperinci
    • hold_key - Tahan tombol sambil melakukan tindakan lain
    • wait - Jeda antar tindakan

    Tindakan yang ditingkatkan (computer_20251124) Tersedia di Claude Opus 4.5:

    • Semua tindakan dari computer_20250124
    • zoom - Lihat wilayah tertentu dari layar dengan resolusi penuh. Memerlukan enable_zoom: true dalam definisi alat. Mengambil parameter region dengan koordinat [x1, y1, x2, y2] yang menentukan sudut kiri atas dan kanan bawah area untuk diperiksa.

    Parameter alat

    ParameterDiperlukanDeskripsi
    typeYaVersi alat (computer_20251124, computer_20250124, atau computer_20241022)
    nameYaHarus "computer"
    display_width_pxYaLebar tampilan dalam piksel
    display_height_pxYaTinggi tampilan dalam piksel
    display_numberTidakNomor tampilan untuk lingkungan X11

    Jaga resolusi tampilan pada atau di bawah 1280x800 (WXGA) untuk kinerja terbaik. Resolusi lebih tinggi dapat menyebabkan masalah akurasi karena pengubahan ukuran gambar.

    Penting: Alat computer use harus dijalankan secara eksplisit oleh aplikasi Anda - Claude tidak dapat menjalankannya secara langsung. Anda bertanggung jawab untuk mengimplementasikan tangkapan layar, gerakan mouse, input keyboard, dan tindakan lain berdasarkan permintaan Claude.

    Parameter alat

    ParameterDiperlukanDeskripsi
    typeYaVersi alat (computer_20251124, computer_20250124, atau computer_20241022)
    nameYaHarus "computer"
    display_width_pxYaLebar tampilan dalam piksel
    display_height_pxYaTinggi tampilan dalam piksel
    display_numberTidakNomor tampilan untuk lingkungan X11

    Jaga resolusi tampilan pada atau di bawah 1280x800 (WXGA) untuk kinerja terbaik. Resolusi lebih tinggi dapat menyebabkan masalah akurasi karena pengubahan ukuran gambar.

    Penting: Alat computer use harus dijalankan secara eksplisit oleh aplikasi Anda - Claude tidak dapat menjalankannya secara langsung. Anda bertanggung jawab untuk mengimplementasikan tangkapan layar, gerakan mouse, input keyboard, dan tindakan lain berdasarkan permintaan Claude.

    Aktifkan kemampuan thinking di Claude 4 models dan Claude Sonnet 3.7

    Claude Sonnet 3.7 memperkenalkan kemampuan "thinking" baru yang memungkinkan Anda melihat proses penalaran model saat bekerja melalui tugas-tugas kompleks. Fitur ini membantu Anda memahami bagaimana Claude mendekati masalah dan dapat sangat berharga untuk tujuan debugging atau pendidikan.

    Untuk mengaktifkan thinking, tambahkan parameter thinking ke permintaan API Anda:

    "thinking": {
      "type": "enabled",
      "budget_tokens": 1024
    }

    Parameter budget_tokens menentukan berapa banyak token yang dapat digunakan Claude untuk thinking. Ini dikurangi dari anggaran max_tokens keseluruhan Anda.

    Ketika thinking diaktifkan, Claude akan mengembalikan proses penalarannya sebagai bagian dari respons, yang dapat membantu Anda:

    1. Memahami proses pengambilan keputusan model
    2. Mengidentifikasi masalah atau kesalahpahaman potensial
    3. Belajar dari pendekatan Claude terhadap pemecahan masalah
    4. Dapatkan lebih banyak visibilitas ke dalam operasi multi-langkah yang kompleks

    Berikut adalah contoh dari apa yang mungkin terlihat seperti output thinking:

    [Thinking]
    I need to save a picture of a cat to the desktop. Let me break this down into steps:
    
    1. First, I'll take a screenshot to see what's on the desktop
    2. Then I'll look for a web browser to search for cat images
    3. After finding a suitable image, I'll need to save it to the desktop
    
    Let me start by taking a screenshot to see what's available...

    Parameter alat

    ParameterDiperlukanDeskripsi
    typeYaVersi alat (computer_20251124, computer_20250124, atau computer_20241022)
    nameYaHarus "computer"
    display_width_pxYaLebar tampilan dalam piksel
    display_height_pxYaTinggi tampilan dalam piksel
    display_numberTidakNomor tampilan untuk lingkungan X11

    Jaga resolusi tampilan pada atau di bawah 1280x800 (WXGA) untuk kinerja terbaik. Resolusi lebih tinggi dapat menyebabkan masalah akurasi karena pengubahan ukuran gambar.

    Penting: Alat computer use harus dijalankan secara eksplisit oleh aplikasi Anda - Claude tidak dapat menjalankannya secara langsung. Anda bertanggung jawab untuk mengimplementasikan tangkapan layar, gerakan mouse, input keyboard, dan tindakan lain berdasarkan permintaan Claude.

    Augmentasi computer use dengan alat lain

    Alat computer use dapat dikombinasikan dengan alat lain untuk membuat alur kerja otomasi yang lebih kuat. Ini sangat berguna ketika Anda perlu:

    • Jalankan perintah sistem (alat bash)
    • Edit file konfigurasi atau skrip (alat editor teks)
    • Integrasikan dengan API atau layanan kustom (alat kustom)

    Parameter alat

    ParameterDiperlukanDeskripsi
    typeYaVersi alat (computer_20251124, computer_20250124, atau computer_20241022)
    nameYaHarus "computer"
    display_width_pxYaLebar tampilan dalam piksel
    display_height_pxYaTinggi tampilan dalam piksel
    display_numberTidakNomor tampilan untuk lingkungan X11

    Pertahankan resolusi tampilan pada atau di bawah 1280x800 (WXGA) untuk performa terbaik. Resolusi lebih tinggi dapat menyebabkan masalah akurasi karena pengubahan ukuran gambar.

    Penting: Alat penggunaan komputer harus dijalankan secara eksplisit oleh aplikasi Anda - Claude tidak dapat menjalankannya secara langsung. Anda bertanggung jawab untuk mengimplementasikan penangkapan tangkapan layar, gerakan mouse, masukan keyboard, dan tindakan lainnya berdasarkan permintaan Claude.

    Aktifkan kemampuan thinking di model Claude 4 dan Claude Sonnet 3.7

    Claude Sonnet 3.7 memperkenalkan kemampuan "thinking" baru yang memungkinkan Anda melihat proses penalaran model saat bekerja melalui tugas-tugas kompleks. Fitur ini membantu Anda memahami bagaimana Claude mendekati masalah dan dapat sangat berharga untuk tujuan debugging atau pendidikan.

    Untuk mengaktifkan thinking, tambahkan parameter thinking ke permintaan API Anda:

    "thinking": {
      "type": "enabled",
      "budget_tokens": 1024
    }

    Parameter budget_tokens menentukan berapa banyak token yang dapat digunakan Claude untuk thinking. Ini dikurangkan dari anggaran max_tokens keseluruhan Anda.

    Ketika thinking diaktifkan, Claude akan mengembalikan proses penalarannya sebagai bagian dari respons, yang dapat membantu Anda:

    1. Memahami proses pengambilan keputusan model
    2. Mengidentifikasi potensi masalah atau kesalahpahaman
    3. Belajar dari pendekatan Claude terhadap pemecahan masalah
    4. Mendapatkan visibilitas lebih besar ke dalam operasi multi-langkah yang kompleks

    Berikut adalah contoh dari apa yang mungkin terlihat seperti output thinking:

    [Thinking]
    Saya perlu menyimpan gambar kucing ke desktop. Mari saya uraikan ini menjadi langkah-langkah:
    
    1. Pertama, saya akan mengambil tangkapan layar untuk melihat apa yang ada di desktop
    2. Kemudian saya akan mencari browser web untuk mencari gambar kucing
    3. Setelah menemukan gambar yang sesuai, saya perlu menyimpannya ke desktop
    
    Mari saya mulai dengan mengambil tangkapan layar untuk melihat apa yang tersedia...

    Meningkatkan penggunaan komputer dengan alat lain

    Alat penggunaan komputer dapat digabungkan dengan alat lain untuk membuat alur kerja otomasi yang lebih kuat. Ini sangat berguna ketika Anda perlu:

    • Menjalankan perintah sistem (alat bash)
    • Mengedit file konfigurasi atau skrip (alat editor teks)
    • Mengintegrasikan dengan API atau layanan kustom (alat kustom)

    Bangun lingkungan penggunaan komputer kustom

    Implementasi referensi dimaksudkan untuk membantu Anda memulai dengan penggunaan komputer. 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 akan memerlukan:

    • Lingkungan virtual atau terkontainerisasi yang cocok untuk penggunaan komputer dengan Claude
    • Implementasi setidaknya satu dari alat penggunaan komputer yang ditentukan Anthropic
    • Lingkaran agen yang berinteraksi dengan API Claude dan menjalankan hasil tool_use menggunakan implementasi alat Anda
    • API atau UI yang memungkinkan masukan pengguna untuk memulai lingkaran agen

    Implementasikan alat penggunaan komputer

    Alat penggunaan komputer diimplementasikan sebagai alat tanpa skema. Saat menggunakan alat ini, Anda tidak perlu memberikan skema masukan seperti dengan alat lain; skema dibangun ke dalam model Claude dan tidak dapat dimodifikasi.

    Tangani kesalahan

    Saat mengimplementasikan alat penggunaan komputer, berbagai kesalahan dapat terjadi. Berikut cara menanganinya:

    Ikuti praktik terbaik implementasi


    Pahami keterbatasan penggunaan komputer

    Fungsionalitas penggunaan komputer masih dalam beta. Meskipun kemampuan Claude terdepan, pengembang harus menyadari keterbatasannya:

    1. Latensi: latensi penggunaan komputer saat ini untuk interaksi manusia-AI mungkin terlalu lambat dibandingkan dengan tindakan komputer yang diarahkan manusia biasa. Kami merekomendasikan fokus pada kasus penggunaan di mana kecepatan tidak kritis (misalnya, pengumpulan informasi latar belakang, pengujian perangkat lunak otomatis) di lingkungan terpercaya.
    2. Akurasi dan keandalan visi komputer: Claude mungkin membuat kesalahan atau mengalami halusinasi saat mengeluarkan koordinat spesifik sambil menghasilkan aksi. Claude Sonnet 3.7 memperkenalkan kemampuan thinking yang dapat membantu Anda memahami penalaran model dan mengidentifikasi potensi masalah.
    3. Akurasi dan keandalan pemilihan alat: Claude mungkin membuat kesalahan atau mengalami halusinasi saat memilih alat sambil menghasilkan aksi atau mengambil tindakan yang tidak terduga untuk menyelesaikan masalah. Selain itu, keandalan mungkin lebih rendah saat berinteraksi dengan aplikasi niche atau beberapa aplikasi sekaligus. Kami merekomendasikan agar pengguna dengan hati-hati meminta model saat meminta tugas-tugas kompleks.
    4. Keandalan pengguliran: Claude Sonnet 3.7 memperkenalkan aksi pengguliran khusus dengan kontrol arah yang meningkatkan keandalan. Model sekarang dapat secara eksplisit menggulir ke arah mana pun (atas/bawah/kiri/kanan) dengan jumlah yang ditentukan.
    5. Interaksi spreadsheet: Klik mouse untuk interaksi spreadsheet telah ditingkatkan di Claude Sonnet 3.7 dengan penambahan aksi kontrol mouse yang lebih presisi seperti left_mouse_down, left_mouse_up, dan dukungan tombol pengubah baru. Pemilihan sel dapat lebih andal dengan menggunakan kontrol butir halus ini dan menggabungkan tombol pengubah dengan klik.

    Selalu hati-hati meninjau dan memverifikasi aksi dan log penggunaan komputer Claude. Jangan gunakan Claude untuk tugas yang memerlukan presisi sempurna atau informasi pengguna sensitif tanpa pengawasan manusia.


    Pahami keterbatasan penggunaan komputer

    Fungsionalitas penggunaan komputer masih dalam beta. Meskipun kemampuan Claude terdepan, pengembang harus menyadari keterbatasannya:

    1. Latensi: latensi penggunaan komputer saat ini untuk interaksi manusia-AI mungkin terlalu lambat dibandingkan dengan tindakan komputer yang diarahkan manusia biasa. Kami merekomendasikan fokus pada kasus penggunaan di mana kecepatan tidak kritis (misalnya, pengumpulan informasi latar belakang, pengujian perangkat lunak otomatis) di lingkungan terpercaya.
    2. Akurasi dan keandalan visi komputer: Claude mungkin membuat kesalahan atau mengalami halusinasi saat mengeluarkan koordinat spesifik sambil menghasilkan aksi. Claude Sonnet 3.7 memperkenalkan kemampuan thinking yang dapat membantu Anda memahami penalaran model dan mengidentifikasi potensi masalah.
    3. Akurasi dan keandalan pemilihan alat: Claude mungkin membuat kesalahan atau mengalami halusinasi saat memilih alat sambil menghasilkan aksi atau mengambil tindakan yang tidak terduga untuk menyelesaikan masalah. Selain itu, keandalan mungkin lebih rendah saat berinteraksi dengan aplikasi niche atau beberapa aplikasi sekaligus. Kami merekomendasikan agar pengguna dengan hati-hati meminta model saat meminta tugas-tugas kompleks.
    4. Keandalan pengguliran: Claude Sonnet 3.7 memperkenalkan aksi pengguliran khusus dengan kontrol arah yang meningkatkan keandalan. Model sekarang dapat secara eksplisit menggulir ke arah mana pun (atas/bawah/kiri/kanan) dengan jumlah yang ditentukan.
    5. Interaksi spreadsheet: Klik mouse untuk interaksi spreadsheet telah ditingkatkan di Claude Sonnet 3.7 dengan penambahan aksi kontrol mouse yang lebih presisi seperti left_mouse_down, left_mouse_up, dan dukungan tombol pengubah baru. Pemilihan sel dapat lebih andal dengan menggunakan kontrol butir halus ini dan menggabungkan tombol pengubah dengan klik.

    Selalu hati-hati meninjau dan memverifikasi aksi dan log penggunaan komputer Claude. Jangan gunakan Claude untuk tugas yang memerlukan presisi sempurna atau informasi pengguna sensitif tanpa pengawasan manusia.


    Harga

    Computer use follows the standard tool use pricing. When using the computer use tool:

    System prompt overhead: The computer use beta adds 466-499 tokens to the system prompt

    Computer use tool token usage:

    ModelInput tokens per tool definition
    Claude 4.x models735 tokens
    Claude Sonnet 3.7 (deprecated)735 tokens

    Additional token consumption:

    • Screenshot images (see Vision pricing)
    • Tool execution results returned to Claude

    If you're also using bash or text editor tools alongside computer use, those tools have their own token costs as documented in their respective pages.

    Pahami keterbatasan penggunaan komputer

    Fungsionalitas penggunaan komputer masih dalam beta. Meskipun kemampuan Claude terdepan, pengembang harus menyadari keterbatasannya:

    1. Latensi: latensi penggunaan komputer saat ini untuk interaksi manusia-AI mungkin terlalu lambat dibandingkan dengan tindakan komputer yang diarahkan manusia biasa. Kami merekomendasikan fokus pada kasus penggunaan di mana kecepatan tidak kritis (misalnya, pengumpulan informasi latar belakang, pengujian perangkat lunak otomatis) di lingkungan terpercaya.
    2. Akurasi dan keandalan visi komputer: Claude mungkin membuat kesalahan atau mengalami halusinasi saat mengeluarkan koordinat spesifik sambil menghasilkan aksi. Claude Sonnet 3.7 memperkenalkan kemampuan thinking yang dapat membantu Anda memahami penalaran model dan mengidentifikasi potensi masalah.
    3. Akurasi dan keandalan pemilihan alat: Claude mungkin membuat kesalahan atau mengalami halusinasi saat memilih alat sambil menghasilkan aksi atau mengambil tindakan yang tidak terduga untuk menyelesaikan masalah. Selain itu, keandalan mungkin lebih rendah saat berinteraksi dengan aplikasi niche atau beberapa aplikasi sekaligus. Kami merekomendasikan agar pengguna dengan hati-hati meminta model saat meminta tugas-tugas kompleks.
    4. Keandalan pengguliran: Claude Sonnet 3.7 memperkenalkan aksi pengguliran khusus dengan kontrol arah yang meningkatkan keandalan. Model sekarang dapat secara eksplisit menggulir ke arah mana pun (atas/bawah/kiri/kanan) dengan jumlah yang ditentukan.
    5. Interaksi spreadsheet: Klik mouse untuk interaksi spreadsheet telah ditingkatkan di Claude Sonnet 3.7 dengan penambahan aksi kontrol mouse yang lebih presisi seperti left_mouse_down, left_mouse_up, dan dukungan tombol pengubah baru. Pemilihan sel dapat lebih andal dengan menggunakan kontrol butir halus ini dan menggabungkan tombol pengubah dengan klik.

    Selalu hati-hati meninjau dan memverifikasi aksi dan log penggunaan komputer Claude. Jangan gunakan Claude untuk tugas yang memerlukan presisi sempurna atau informasi pengguna sensitif tanpa pengawasan manusia.


    Harga

    Computer use follows the standard tool use pricing. When using the computer use tool:

    System prompt overhead: The computer use beta adds 466-499 tokens to the system prompt

    Computer use tool token usage:

    ModelInput tokens per tool definition
    Claude 4.x models735 tokens
    Claude Sonnet 3.7 (deprecated)735 tokens

    Additional token consumption:

    • Screenshot images (see Vision pricing)
    • Tool execution results returned to Claude

    If you're also using bash or text editor tools alongside computer use, those tools have their own token costs as documented in their respective pages.

    Langkah berikutnya

    Implementasi referensi

    Mulai dengan cepat dengan implementasi berbasis Docker lengkap kami

    • Ikhtisar
    • Kompatibilitas model
    • Pertimbangan keamanan
    • Mulai cepat
    • Cara kerja penggunaan komputer
    • Ikhtisar
    • Kompatibilitas model
    • Pertimbangan keamanan
    • Mulai cepat
    • Cara kerja computer use
    • Lingkungan komputasi
    • Cara mengimplementasikan computer use
    • Mulai dengan implementasi referensi kami
    • Memahami agent loop multi-agen
    • Optimalkan kinerja model dengan prompting
    • System prompts
    • Cara mengimplementasikan computer use
    • Mulai dengan implementasi referensi kami
    • Memahami loop multi-agen
    • Optimalkan kinerja model dengan prompting
    • System prompts
    • Tindakan yang tersedia
    • Parameter alat
    • Parameter alat
    • Aktifkan kemampuan thinking di Claude 4 models dan Claude Sonnet 3.7
    • Parameter alat
    • Augmentasi computer use dengan alat lain
    • Parameter alat
    • Aktifkan kemampuan thinking di model Claude 4 dan Claude Sonnet 3.7
    • Meningkatkan penggunaan komputer dengan alat lain
    • Bangun lingkungan penggunaan komputer kustom
    • Pahami keterbatasan penggunaan komputer
    • Pahami keterbatasan penggunaan komputer
    • Harga
    • Pahami keterbatasan penggunaan komputer
    • Harga
    • Langkah berikutnya

    Terakhir, harap beri tahu pengguna akhir tentang risiko yang relevan dan dapatkan persetujuan mereka sebelum mengaktifkan penggunaan komputer di produk Anda sendiri.

    import anthropic
    
    client = anthropic.Anthropic()
    
    response = client.beta.messages.create(
        model="claude-sonnet-4-5",  # atau model kompatibel lainnya
        max_tokens=1024,
        tools=[
            {
              "type": "computer_20250124",
              "name": "computer",
              "display_width_px": 1024,
              "display_height_px": 768,
              "display_number": 1,
            },
            {
              "type": "text_editor_20250728",
              "name": "str_replace_based_edit_tool"
            },
            {
              "type": "bash_20250124",
              "name": "bash"
            }
        ],
        messages=[{"role": "user", "content": "Simpan gambar kucing ke desktop saya."}],
        betas=["computer-use-2025-01-24"]
    )
    print(response)
    1. 1

      1. Berikan Claude dengan alat penggunaan komputer dan prompt pengguna

      • Tambahkan alat penggunaan komputer (dan secara opsional alat lain) ke permintaan API Anda.
      • Sertakan prompt pengguna yang memerlukan interaksi desktop, misalnya, "Simpan gambar kucing ke desktop saya."
    2. 2

      2. Claude memutuskan untuk menggunakan alat penggunaan komputer

      • Claude menilai apakah alat penggunaan komputer dapat membantu dengan kueri pengguna.
      • Jika ya, Claude membuat permintaan penggunaan alat yang diformat dengan benar.
      • Respons API memiliki stop_reason dari tool_use, menandakan niat Claude.
    3. 3

      3. Ekstrak input alat, evaluasi alat di komputer, dan kembalikan hasil

      • Di pihak Anda, ekstrak nama alat dan input dari permintaan Claude.
      • Gunakan alat di kontainer atau Mesin Virtual.
      • Lanjutkan percakapan dengan pesan user baru yang berisi blok konten tool_result.
    4. 4

      4. Claude terus memanggil alat penggunaan komputer sampai menyelesaikan tugas

      • Claude menganalisis hasil alat untuk menentukan apakah penggunaan alat lebih lanjut diperlukan atau tugas telah selesai.
      • Jika Claude memutuskan bahwa ia memerlukan alat lain, ia merespons dengan stop_reason tool_use lain dan Anda harus kembali ke langkah 3.
      • Jika tidak, ia membuat respons teks kepada pengguna.

    Terakhir, harap informasikan pengguna akhir tentang risiko yang relevan dan dapatkan persetujuan mereka sebelum mengaktifkan computer use di produk Anda sendiri.

    import anthropic
    
    client = anthropic.Anthropic()
    
    response = client.beta.messages.create(
        model="claude-sonnet-4-5",  # atau model kompatibel lainnya
        max_tokens=1024,
        tools=[
            {
              "type": "computer_20250124",
              "name": "computer",
              "display_width_px": 1024,
              "display_height_px": 768,
              "display_number": 1,
            },
            {
              "type": "text_editor_20250728",
              "name": "str_replace_based_edit_tool"
            },
            {
              "type": "bash_20250124",
              "name": "bash"
            }
        ],
        messages=[{"role": "user", "content": "Simpan gambar kucing ke desktop saya."}],
        betas=["computer-use-2025-01-24"]
    )
    print(response)
    1. 1

      1. Berikan Claude alat computer use dan prompt pengguna

      • Tambahkan alat computer use (dan secara opsional alat lain) ke permintaan API Anda.
      • Sertakan prompt pengguna yang memerlukan interaksi desktop, misalnya, "Simpan gambar kucing ke desktop saya."
    2. 2

      2. Claude memutuskan untuk menggunakan alat computer use

      • Claude menilai apakah alat computer use dapat membantu dengan kueri pengguna.
      • Jika ya, Claude membuat permintaan penggunaan alat yang diformat dengan benar.
      • Respons API memiliki stop_reason dari tool_use, menandakan niat Claude.
    3. 3

      3. Ekstrak input alat, evaluasi alat di komputer, dan kembalikan hasil

      • Di pihak Anda, ekstrak nama alat dan input dari permintaan Claude.
      • Gunakan alat di kontainer atau Mesin Virtual.
      • Lanjutkan percakapan dengan pesan user baru yang berisi blok konten tool_result.
    4. 4

      4. Claude terus memanggil alat computer use hingga menyelesaikan tugas

      • Claude menganalisis hasil alat untuk menentukan apakah penggunaan alat lebih lanjut diperlukan atau tugas telah selesai.
      • Jika Claude memutuskan memerlukan alat lain, ia merespons dengan stop_reason tool_use lain dan Anda harus kembali ke langkah 3.
      • Jika tidak, ia membuat respons teks kepada pengguna.
    enable_zoom
    Tidak
    Aktifkan tindakan zoom (computer_20251124 hanya). Atur ke true untuk memungkinkan Claude memperbesar wilayah layar tertentu. Default: false
    enable_zoom
    Tidak
    Aktifkan tindakan zoom (computer_20251124 hanya). Atur ke true untuk memungkinkan Claude memperbesar wilayah layar tertentu. Default: false
    enable_zoom
    Tidak
    Aktifkan tindakan zoom (computer_20251124 hanya). Atur ke true untuk memungkinkan Claude memperbesar wilayah layar tertentu. Default: false
    curl https://api.anthropic.com/v1/messages \
      -H "content-type: application/json" \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: computer-use-2025-01-24" \
      -d '{
        "model": "claude-sonnet-4-5",
        "max_tokens": 2000,
        "tools": [
          {
            "type": "computer_20250124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
            "display_number": 1
          },
          {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool"
          },
          {
            "type": "bash_20250124",
            "name": "bash"
          },
          {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
              "type": "object",
              "properties": {
                "location": {
                  "type": "string",
                  "description": "The city and state, e.g. San Francisco, CA"
                },
                "unit": {
                  "type": "string",
                  "enum": ["celsius", "fahrenheit"],
                  "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
                }
              },
              "required": ["location"]
            }
          }
        ],
        "messages": [
          {
            "role": "user",
            "content": "Find flights from San Francisco to a place with warmer weather."
          }
        ],
        "thinking": {
          "type": "enabled",
          "budget_tokens": 1024
        }
      }'
    enable_zoom
    Tidak
    Aktifkan aksi zoom (computer_20251124 saja). Atur ke true untuk memungkinkan Claude melakukan zoom ke wilayah layar tertentu. Default: false
    curl https://api.anthropic.com/v1/messages \
      -H "content-type: application/json" \
      -H "x-api-key: $ANTHROPIC_API_KEY" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: computer-use-2025-01-24" \
      -d '{
        "model": "claude-sonnet-4-5",
        "max_tokens": 2000,
        "tools": [
          {
            "type": "computer_20250124",
            "name": "computer",
            "display_width_px": 1024,
            "display_height_px": 768,
            "display_number": 1
          },
          {
            "type": "text_editor_20250728",
            "name": "str_replace_based_edit_tool"
          },
          {
            "type": "bash_20250124",
            "name": "bash"
          },
          {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
              "type": "object",
              "properties": {
                "location": {
                  "type": "string",
                  "description": "The city and state, e.g. San Francisco, CA"
                },
                "unit": {
                  "type": "string",
                  "enum": ["celsius", "fahrenheit"],
                  "description": "The unit of temperature, either 'celsius' or 'fahrenheit'"
                }
              },
              "required": ["location"]
            }
          }
        ],
        "messages": [
          {
            "role": "user",
            "content": "Find flights from San Francisco to a place with warmer weather."
          }
        ],
        "thinking": {
          "type": "enabled",
          "budget_tokens": 1024
        }
      }'
    1. 1

      Siapkan lingkungan komputasi Anda

      Buat tampilan virtual atau sambungkan ke tampilan yang ada yang akan berinteraksi dengan Claude. Ini biasanya melibatkan pengaturan Xvfb (X Virtual Framebuffer) atau teknologi serupa.

    2. 2

      Implementasikan penangan aksi

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

      def handle_computer_action(action_type, params):
          if action_type == "screenshot":
              return capture_screenshot()
          elif action_type == "left_click":
              x, y = params["coordinate"]
              return click_at(x, y)
          elif action_type == "type":
              return type_text(params["text"])
          # ... handle other actions
    3. 3

      Proses panggilan alat Claude

      Ekstrak dan jalankan panggilan alat dari respons Claude:

      for content in response.content:
          if content.type == "tool_use":
              action = content.input["action"]
              result = handle_computer_action(action, content.input)
              
              # Return result to Claude
              tool_result = {
                  "type": "tool_result",
                  "tool_use_id": content.id,
                  "content": result
              }
    4. 4

      Implementasikan lingkaran agen

      Buat lingkaran yang berlanjut sampai Claude menyelesaikan tugas:

      while True:
          response = client.beta.messages.create(...)
          
          # Check if Claude used any tools
          tool_results = process_tool_calls(response)
          
          if not tool_results:
              # No more tool use, task complete
              break
              
          # Continue conversation with tool results
          messages.append({"role": "user", "content": tool_results})

  1. Pembuatan akun dan pembuatan konten di platform media sosial dan komunikasi: Meskipun Claude akan mengunjungi situs web, kami membatasi kemampuannya untuk membuat akun atau menghasilkan dan berbagi konten atau sebaliknya terlibat dalam peniruan manusia di seluruh situs web dan platform media sosial. Kami dapat memperbarui kemampuan ini di masa depan.
  2. Kerentanan: Kerentanan seperti jailbreaking atau injeksi prompt mungkin tetap ada di seluruh sistem AI frontier, termasuk API penggunaan komputer beta. Dalam beberapa keadaan, Claude akan mengikuti perintah yang ditemukan dalam konten, kadang-kadang bahkan bertentangan dengan instruksi pengguna. Misalnya, instruksi Claude di halaman web atau yang terdapat dalam gambar dapat mengganti instruksi atau menyebabkan Claude membuat kesalahan. Kami merekomendasikan: a. Membatasi penggunaan komputer ke lingkungan terpercaya seperti mesin virtual atau kontainer dengan hak istimewa minimal b. Menghindari pemberian akses penggunaan komputer ke akun atau data sensitif tanpa pengawasan ketat c. Menginformasikan pengguna akhir tentang risiko yang relevan dan memperoleh persetujuan mereka sebelum mengaktifkan atau meminta izin yang diperlukan untuk fitur penggunaan komputer di aplikasi Anda
  3. Tindakan yang tidak pantas atau ilegal: Sesuai dengan syarat layanan Anthropic, Anda tidak boleh menggunakan penggunaan komputer untuk melanggar hukum apa pun atau Kebijakan Penggunaan Kami yang Dapat Diterima.
  4. Pembuatan akun dan pembuatan konten di platform media sosial dan komunikasi: Meskipun Claude akan mengunjungi situs web, kami membatasi kemampuannya untuk membuat akun atau menghasilkan dan berbagi konten atau sebaliknya terlibat dalam peniruan manusia di seluruh situs web dan platform media sosial. Kami dapat memperbarui kemampuan ini di masa depan.
  5. Kerentanan: Kerentanan seperti jailbreaking atau injeksi prompt mungkin tetap ada di seluruh sistem AI frontier, termasuk API penggunaan komputer beta. Dalam beberapa keadaan, Claude akan mengikuti perintah yang ditemukan dalam konten, kadang-kadang bahkan bertentangan dengan instruksi pengguna. Misalnya, instruksi Claude di halaman web atau yang terdapat dalam gambar dapat mengganti instruksi atau menyebabkan Claude membuat kesalahan. Kami merekomendasikan: a. Membatasi penggunaan komputer ke lingkungan terpercaya seperti mesin virtual atau kontainer dengan hak istimewa minimal b. Menghindari pemberian akses penggunaan komputer ke akun atau data sensitif tanpa pengawasan ketat c. Menginformasikan pengguna akhir tentang risiko yang relevan dan memperoleh persetujuan mereka sebelum mengaktifkan atau meminta izin yang diperlukan untuk fitur penggunaan komputer di aplikasi Anda
  6. Tindakan yang tidak pantas atau ilegal: Sesuai dengan syarat layanan Anthropic, Anda tidak boleh menggunakan penggunaan komputer untuk melanggar hukum apa pun atau Kebijakan Penggunaan Kami yang Dapat Diterima.
  7. Pembuatan akun dan pembuatan konten di platform media sosial dan komunikasi: Meskipun Claude akan mengunjungi situs web, kami membatasi kemampuannya untuk membuat akun atau menghasilkan dan berbagi konten atau sebaliknya terlibat dalam peniruan manusia di seluruh situs web dan platform media sosial. Kami dapat memperbarui kemampuan ini di masa depan.
  8. Kerentanan: Kerentanan seperti jailbreaking atau injeksi prompt mungkin tetap ada di seluruh sistem AI frontier, termasuk API penggunaan komputer beta. Dalam beberapa keadaan, Claude akan mengikuti perintah yang ditemukan dalam konten, kadang-kadang bahkan bertentangan dengan instruksi pengguna. Misalnya, instruksi Claude di halaman web atau yang terdapat dalam gambar dapat mengganti instruksi atau menyebabkan Claude membuat kesalahan. Kami merekomendasikan: a. Membatasi penggunaan komputer ke lingkungan terpercaya seperti mesin virtual atau kontainer dengan hak istimewa minimal b. Menghindari pemberian akses penggunaan komputer ke akun atau data sensitif tanpa pengawasan ketat c. Menginformasikan pengguna akhir tentang risiko yang relevan dan memperoleh persetujuan mereka sebelum mengaktifkan atau meminta izin yang diperlukan untuk fitur penggunaan komputer di aplikasi Anda
  9. Tindakan yang tidak pantas atau ilegal: Sesuai dengan syarat layanan Anthropic, Anda tidak boleh menggunakan penggunaan komputer untuk melanggar hukum apa pun atau Kebijakan Penggunaan Kami yang Dapat Diterima.
  10. Dokumentasi alat

    Pelajari lebih lanjut tentang penggunaan alat dan membuat alat kustom