Claude Code Projects: koordinator, thread, dan batasan beta

Anthropic baru-baru ini mendesain ulang Projects di Claude Code. Kini, Projects berupa satu percakapan koordinator yang meluncurkan sesi cloud paralel—thread—untuk mengerjakan tugas dan menerima laporan dari thread tersebut. Project layak dibuat ketika pekerjaan Anda memiliki tujuan yang akan berlangsung lebih lama daripada satu sesi dan menghasilkan tugas baru—misalnya, mengembangkan repositori GitHub selama beberapa minggu. Kebutuhan akan pekerjaan paralel saja belum cukup. Jika Anda perlu segera memperbaiki satu file di sini dan sekarang, sesi biasa sudah memadai.

Pekerjaan dipimpin oleh seorang koordinator—percakapan jangka panjang tempat Claude memutuskan pesan Anda akan dijadikan tugas untuk thread atau tidak. Thread menulis kodenya: masing-masing adalah sesi Claude Code cloud terpisah di cabang repositorinya sendiri. Beberapa thread dapat berjalan sekaligus, masing-masing dengan konteks dan cabangnya sendiri. Koordinator melihat laporan thread setelah selesai, tetapi tidak setiap langkah yang diambilnya. Koordinator melaporkan pull request yang telah selesai (permintaan untuk menggabungkan perubahan) kepada Anda dan, atas perintah Anda, meminta thread untuk merevisi atau menggabungkannya. Berikut ikhtisar berdasarkan dokumentasi resmi Anthropic: hal yang perlu dikonfigurasi, cara pekerjaan diatur, dan batasan dalam versi beta.

Versi beta tersedia secara bertahap, dimulai dari akun Pro dan Max yang sudah pernah menggunakan sesi Claude Code cloud dan belum membuat project di chat biasa atau Cowork. Jika bagian Projects belum terlihat, Anda dapat bergabung ke daftar tunggu.

Penjelasan sederhana tentang Claude Code Projects#

Project adalah satu percakapan jangka panjang dengan koordinator, yang dilengkapi repositori, memori, dan instruksi. Anda menulis kepada koordinator, lalu koordinator memutuskan apakah akan langsung menjawab atau meluncurkan thread. Anda tidak perlu membuka sesi baru secara manual untuk setiap tugas.

Thread adalah sesi Claude Code cloud lengkap: thread memiliki konteks dan cabang repositorinya sendiri serta membuka pull request jika diperlukan. Koordinator dapat membuka beberapa thread sekaligus—misalnya, satu thread memperbaiki bug, thread lain menulis tes, dan thread ketiga memperbarui dokumentasi—sambil menjawab pertanyaan Anda dalam percakapan utama.

Sebagai perbandingan, bayangkan beberapa tab berisi sesi Claude Code lokal, masing-masing di salinan kerja repositorinya sendiri. Salinan ini disebut worktree—folder terpisah untuk satu cabang agar sesi lokal tidak saling mengganggu. Anda berpindah sendiri di antara sesi dan memutuskan tugas apa yang diberikan kepada masing-masing sesi. Thread cloud tidak memerlukan worktree: setiap thread mengkloning repositori ke lingkungan cloud terisolasinya sendiri. Projects menangani koordinasi, termasuk menentukan kapan thread baru perlu dibuat dan kapan tidak.

Project memiliki memori dan instruksi bersama yang diterima setiap thread baru. Bagian penyiapan menjelaskan hal yang perlu disimpan di dalamnya dan cara meneruskannya ke thread.

Perbedaannya dengan sesi biasa dan tim agen#

Jika Anda sudah menjalankan subagen bersarang dalam satu sesi Claude Code, ada baiknya membedakannya dari tim agen dan thread project. Tim agen adalah cara lain untuk mendelegasikan pekerjaan: satu sesi meluncurkan sesi rekan tim untuk tugas tertentu. Anda dapat menjalankannya di komputer sendiri maupun di dalam sesi cloud.

• Tim agen—sesi rekan tim untuk satu tugas tertentu yang dapat diluncurkan secara lokal atau di cloud. Ini bukan thread project terpisah.
• Project dan thread-nya—pekerjaan berlangsung di cloud. Setiap thread adalah sesi terpisah di cabangnya sendiri dan terus berjalan meskipun Anda menutup laptop. Sesi lokal tidak dapat menjadi bagian dari project.
• Tampilan agen—layar untuk mengamati beberapa sesi lokal di komputer Anda. Tampilan ini tidak memiliki koordinator: Anda yang memutuskan tugas apa yang diberikan kepada masing-masing sesi.

Dokumentasi resmi Anthropic menekankan hal tersendiri: pekerjaan paralel saja bukan alasan untuk membuat project. Dalam sebuah project, Claude meluncurkan sesi dan menerima laporannya sendiri, dan semua sesi dimulai dengan repositori, instruksi, dan memori bersama. Pekerjaan tetap berada di cloud selama seluruh tugas berlangsung.

Pendekatan serupa—koordinator yang membagikan tugas kepada agen—diterapkan di alat lain, yang dibahas dalam artikel tentang Cursor Projects. Mekanismenya berbeda, tetapi koordinator juga menentukan tugas untuk masing-masing pihak.

Hal yang perlu dikonfigurasi sebelum project pertama#

Sebelum membuat project, periksa tiga hal berikut.

1. Akun GitHub dan Claude GitHub App. Jika Anda sudah menghubungkan GitHub melalui /web-setup, token tersebut memberi sesi cloud biasa akses ke repositori. Namun, itu belum cukup untuk thread project: Anda perlu akun GitHub terhubung yang memiliki akses push ke repositori serta Claude GitHub App yang terpasang untuk repositori tersebut. Tanpa itu, thread tidak dapat mengkloning repositori maupun membuka pull request.

2. Instruksi project. Instruksi project adalah teks hingga 16 000 karakter yang dikirim ke setiap thread baru dan koordinator itu sendiri. Cantumkan informasi yang biasanya harus Anda jelaskan lagi di setiap sesi: struktur repositori, konvensi kode, dan pemeriksaan yang wajib dilakukan sebelum pull request.

3. Model dan tingkat upaya. Secara default, project baru menjalankan setiap thread dengan model Opus dan tingkat upaya tinggi, sedangkan koordinator menggunakan tingkat upaya rendah. Dokumentasi menyatakan bahwa pengaturan ini “menghabiskan jatah paket Anda paling cepat” (terjemahan; aslinya: draws on your plan fastest). Jika tugas Anda sederhana, Anda dapat memilih model yang lebih murah atau menurunkan tingkat upaya di Project settings > General. Pengaturan thread dan koordinator diubah secara terpisah; dokumentasi menjelaskan pilihan yang lebih hemat.

Memori project disimpan sebagai file biasa, dengan file indeks bernama MEMORY.md. Setiap thread baru membacanya saat dimulai dan mengakses file lainnya sesuai kebutuhan. Temuan dari satu thread yang disimpan di memori tersedia bagi thread berikutnya tanpa perlu diceritakan kembali.

Jika thread mengubah kode yang sama#

Setiap thread bekerja di cabangnya sendiri dan membuka pull request sendiri jika pekerjaan memerlukannya. Namun, koordinator tidak menjamin bahwa tugas-tugas tidak akan tumpang tindih: jika beberapa thread mengerjakan area kode yang sama, Anda dapat meminta thread terkait menyelesaikan konflik melalui antarmuka. Tombol Resolve conflicts di samping pull request akan mengirim instruksi kepada thread sebagai pesan dari Anda.

Dokumentasi resmi menyarankan agar Anda menyebutkan preferensi jumlah thread dalam instruksi project: misalnya, meminta koordinator menjalankan paling banyak dua thread sekaligus atau menggunakan kembali thread yang sudah ada untuk tugas baru di area yang sama. Ini adalah preferensi yang berusaha diikuti koordinator, bukan batas keras. Dengan sendirinya, preferensi ini tidak menjamin bahwa thread tidak akan berbenturan di file yang sama—konflik yang sudah terjadi harus diselesaikan secara terpisah. Untuk tugas terkait di area yang sama, Anda dapat menggunakan kembali thread yang aktif maupun yang tidak aktif. Jika thread tidak aktif selama lebih dari satu jam, thread membaca ulang seluruh riwayat saat menerima pesan baru, sehingga penggunaan jatah paket terpengaruh.

Semakin jelas pemisahan tugas berdasarkan file atau modul, semakin mudah pekerjaan dilakukan secara paralel. Artikel terpisah membahas pembagian tugas besar menjadi bagian-bagian independen: cara mendelegasikan pekerjaan coding kepada ribuan agen. Skalanya berbeda, tetapi prinsip pembagian pekerjaannya sama.

Selama cache percakapan masih aktif (di paket Pro dan Max, dalam waktu satu jam, jika batas paket mengizinkan), thread menggunakan lebih sedikit token dari jatah paket untuk memproses ulang riwayatnya. Setelah cache kedaluwarsa, thread membaca ulang seluruh riwayat saat menerima pesan baru sebelum mulai bekerja. Untuk tugas independen yang baru, meminta koordinator membuat thread baru mungkin lebih hemat: cara ini dapat menggunakan lebih sedikit token dari jatah paket yang sama daripada melanjutkan sesi lama dengan riwayat panjang setelah cache-nya kedaluwarsa.

Batasan beta yang perlu diketahui sebelumnya#

Sebelum membuat project untuk tugas penting, periksa batasan versi beta:

• Hanya tersedia untuk Pro dan Max. Team dan Enterprise belum didukung.
• Batas 200 thread baru per hari untuk setiap akun, dihitung gabungan di semua project.
• Project dimiliki satu pengguna. Anda tidak dapat memberikan akses bersama kepada orang lain, baik ke project maupun thread tertentu, dan versi beta belum menyediakan pengaturan organisasi untuk tim.
• Akses hanya melalui claude.ai/code, aplikasi desktop, dan aplikasi seluler. Projects tidak berfungsi di CLI terminal, melalui Amazon Bedrock, Google Cloud Agent Platform, atau Microsoft Foundry.
• Project tidak dapat melihat file dan alat lokal. Thread bekerja dengan repositori GitHub, file yang diunggah, dan folder Google Drive, tetapi tidak dengan hal-hal yang hanya tersedia di komputer Anda.

Jika Anda memerlukan akses terminal atau akses ke alat yang hanya tersedia di komputer Anda, gunakan sesi lokal atau tampilan agen untuk beberapa sesi tersebut. Jika beberapa orang perlu bekerja bersama dalam satu ruang kerja, Anthropic memiliki produk terpisah untuk tim dengan paket Team dan Enterprise: Claude Tag. Produk ini berada di kanal Slack; setiap anggota dapat memberi Claude sebuah tugas, dan semua orang di kanal dapat melihat serta mengarahkan pekerjaan. Project bekerja dengan cara berbeda: project hanya milik Anda. Jika Anda hanya memerlukan file lokal tertentu, Anda dapat mengunggahnya ke project, lalu setiap thread dapat mengaksesnya. Cara ini tidak memberikan akses ke alat lokal.

Langkah selanjutnya#

Sebelum memindahkan alur kerja Anda ke Projects, cobalah membuat satu project uji di repositori yang tidak kritis: hubungkan GitHub App, tulis instruksi singkat, berikan satu tugas independen kepada koordinator, lalu lihat cara koordinator menanganinya. Uji coba pertama ini akan menunjukkan apakah Anda memahami antarmuka koordinator dan thread. Uji coba ini tidak mencakup pekerjaan paralel, konflik, atau penggunaan jatah untuk beberapa tugas—hal-hal tersebut perlu diuji secara terpisah.