Cara menempel screenshot ke Claude Code
Jawaban singkat: di Windows, jangan mengandalkan Ctrl+V. Gunakan shortcut paste Anda sendiri Claude Code, seret file gambar ke dalam terminal, atau referensikan file dengan jalan dalam prompt Anda. Halaman ini mencakup ketiga-tiganya, mengapa paste papan klip biasa terus hilang, dan cara mengukur screenshot sehingga tidak menghabiskan seribu token.
Anda ingin menunjukkan kepada Claude Code screenshot — dialog kesalahan, tata letak rusak, kerangka desain — dan mengetiknya akan memakan waktu selamanya. Masalahnya adalah bahwa terminal bukan kotak obrolan: sama Ctrl+V yang menempel gambar di tempat lain di Windows sering tidak melakukan apa pun di sini, terutama di dalam WSL. Gambar tidak hilang; terminal hanya tidak pernah menerimanya. Perbaikannya adalah menggunakan rute yang tidak bergantung pada jalur bitmap-di-papan klip yang rapuh, dan ada tiga rute yang andal.
Ini adalah panduan yang diterbitkan Maxisnap. Maxisnap membuat alat screenshot Windows yang ekspor-nya dibuat untuk hand-off tepat ini, jadi itu muncul di mana relevan — tetapi rute di bawah bekerja dengan screenshot apa pun, dari alat apa pun.
Apa tiga cara untuk memberikan Claude Code gambar?
Claude Code menerima gambar dengan tiga cara, dan di Windows mereka tidak sama-sama andal. Dalam urutan kasar keandalan:
| Rute | Bagaimana | Keandalan di Windows / WSL |
|---|---|---|
| Jalur file dalam prompt | Ketik atau tempel jalur gambar yang disimpan, misalnya C:\Users\you\shot.png, dalam pesan Anda. | Paling andal — tidak ada papan klip yang terlibat |
| Seret file masuk | Seret file gambar dari Explorer (atau langsung dari alat tangkap) ke jendela terminal. | Andal saat terminal mendukung drop |
| Shortcut paste | Gunakan tombol paste khusus Claude Code (versi terbaru menggunakan Alt+V untuk gambar). | Bekerja dalam banyak setup; fallback adalah jalur file |
| Refleks pertama yang semua orang coba. | Sering kali diam-diam tidak melakukan apa pun di terminal |
Hotkey Claude Code berubah antara versi — periksa dokumentasinya yang saat ini untuk tombol paste yang tepat. Rute jalur file adalah yang tetap bekerja terlepas dari itu.
Mengapa Ctrl+V tidak melakukan apa pun di terminal?
Karena menempel gambar ke terminal adalah operasi yang berbeda dan kurang didukung daripada menempel teks. Saat Anda menyalin screenshot, Windows menempatkan bitmap pada papan klip. Sebagian besar terminal hanya menangani paste teks dan diam-diam mengabaikan bitmap, jadi tidak ada yang muncul. Di dalam WSL kesenjangan bahkan lebih lebar: sisi Linux terminal tidak melihat bitmap papan klip Windows sama sekali, jadi bahkan alat yang akan menerima gambar yang ditempel tidak pernah mendapatkan data. Gambar itu baik-baik saja — itu hanya tidak memiliki jalur dari papan klip ke prompt. Itulah mengapa rute yang menggunakan file yang disimpan bukan bitmap papan klip adalah rute yang bertahan.
Bahkan shortcut paste khusus dapat tidak stabil di sini: paste gambar di terminal telah dilaporkan secara berkala berhenti bekerja pada beberapa pengaturan Windows dan PowerShell. Saat rute papan klip gagal, file yang disimpan — diseret masuk atau direferensikan dengan jalan — tidak pernah bergantung pada itu, itulah mengapa itu kebiasaan yang layak dibangun.
Apakah saya perlu mengubah ukuran screenshot sebelum mengirimnya?
Ya, jika Anda melakukan ini sepanjang hari. Tangkapan beresolusi penuh tidak hanya berat untuk dipindahkan — itu mahal. Model visi mengubin gambar menjadi patch dan mengisi muatan per patch, jadi screenshot 4K dapat menghabiskan lebih dari seribu token gambar, sementara salinan yang diubah ukurannya menjadi lebar yang masuk akal menghabiskan beberapa ratus dan membaca sama jelasnya, karena model mengurangi sampel gambar besar secara internal. Mengukur ukuran gambar dengan benar sebelum mencapai Claude Code adalah optimisasi termurah di seluruh loop.
Di sinilah alat tangkap tujuan khusus mendapatkan tempatnya. Maxisnap Ekspor yang dioptimalkan untuk AI menghasilkan salinan dibatasi pada lebar maksimal default 1600 px (dapat dikonfigurasi dalam Pengaturan) dan memberi Anda file yang disimpan — siap untuk diseret ke dalam terminal atau direferensikan dengan jalan. Dan jika shot menunjukkan kunci API, token, atau data pelanggan, alat blur menyunting itu secara destruktif sebelum file pernah dibuat, jadi rahasia tidak dapat dipulihkan dari apa yang Anda kirim.
| Apa yang Anda tempel | Biaya token gambar tipikal | Di Claude Code |
|---|---|---|
| Tangkapan 4K mentah / monitor penuh | 1.000+ token | Lebih mahal dan mungkin mencapai batas ukuran |
| Salinan Maxisnap yang dioptimalkan untuk AI (lebar 1600 px) | Beberapa ratus token | Terbaca jelas, lebih murah, upload cepat |
Angka token adalah rentang tipikal model visi, bukan tolok ukur Maxisnap; jumlah persisnya bervariasi menurut model dan konten gambar.
$ jalur hand-off paling cepat yang andal
1. Ctrl+Alt+5 -> drag a box around the error 2. blur any secrets, then export the AI-optimized copy 3. drag the saved file into the terminal ...or paste its path: read this: C:\Users\you\shot.png # skip Ctrl+V — the terminal usually ignores the bitmap
Menempel screenshot ke Claude Code — FAQ
Mengapa Ctrl+V tidak menempel screenshot saya ke Claude Code?
Karena terminal biasanya tidak dapat menerima gambar dari papan klip — ia mengharapkan teks, dan itu mengabaikan bitmap yang Windows letakkan di sana saat Anda menyalin screenshot. Di dalam WSL bitmap papan klip Windows tidak terlihat oleh sisi Linux sama sekali. Gunakan tombol paste gambar Claude Code Anda sendiri, seret file ke terminal, atau referensikan jalur file yang disimpan dalam prompt Anda.
Shortcut paste berhenti bekerja di Claude Code — sekarang apa?
Paste gambar di terminal dapat gagal secara berkala di Windows dan PowerShell, jadi jangan mengandalkannya sebagai satu-satunya rute Anda. Simpan screenshot dan referensikan jalur filenya dalam prompt Anda, atau seret file ke terminal — tidak satupun menyentuh papan klip, jadi keduanya tetap berfungsi saat shortcut paste tidak berfungsi. Patut diperiksa dalam dokumentasi Claude Code terkini untuk tombol paste terbaru, tetapi rute jalur file adalah rute yang tidak pernah putus.
Apa cara paling andal untuk menambahkan gambar di Windows?
Referensikan file yang disimpan dengan jalurnya dalam pesan Anda. Itu tidak menyentuh papan klip, jadi itu bekerja sama di Windows Terminal, WSL, dan melalui SSH. Menyeret file ke terminal adalah rute paling andal berikutnya.
Apakah screenshot perlu memiliki ukuran tertentu?
Lebih kecil biasanya lebih baik. Tangkapan beresolusi penuh dapat menghabiskan lebih dari seribu token gambar dan lebih mungkin mencapai batas per gambar. Salinan yang diubah ukurannya menjadi sekitar 1600 px lebar menghabiskan jauh lebih sedikit dan membaca sama jelasnya, karena model mengurangi sampel gambar besar.
Bagaimana cara menyembunyikan kunci API sebelum mengirim screenshot?
Sunting sebelum file dibuat. Di Maxisnap, seret alat blur di atas rahasia di editor, kemudian ekspor — blur diterapkan secara destruktif, jadi kunci tidak dapat dipulihkan dari gambar yang Anda tangan ke Claude Code.
Bisakah saya melakukan hal yang sama dengan Codex CLI atau Gemini CLI?
Ya. Ketiga-tiganya menggunakan jalur file atau file yang diseret, yang merupakan rute portabel di Windows. Kami tangkapan layar untuk coding AI halaman memiliki detail per alat, dan rekaman layar untuk coding AI mencakup pengiriman klip pendek saat masih tidak cukup.
Tangkap, sunting, dan serahkan dalam tiga keystroke.
Screenshot berukuran tepat dan dioptimalkan AI dengan file yang disimpan siap untuk diseret atau direferensikan — gratis di Windows.
Terkait: tangkapan layar untuk coding AI · rekaman layar untuk coding AI · blur sebuah screenshot · alat tangkapan layar untuk developer