Projects sedang dalam beta publik di paket Pro dan Max dan diluncurkan secara bertahap, dimulai dengan akun yang telah menggunakan sesi cloud dan tidak memiliki projects yang ada di claude.ai chat atau Cowork. Mereka belum tersedia di paket Team atau Enterprise. Jika Projects tidak muncul di sidebar di claude.ai/code atau di tab Code dari aplikasi desktop, peluncuran belum mencapai akun Anda, dan Anda dapat bergabung dengan daftar tunggu. Jalankan agen secara paralel mencantumkan apa yang dapat Anda gunakan sementara itu.
- Kirim pekerjaan ke satu tempat: tempel laporan bug, stack trace, atau daftar tugas ke dalam percakapan kapan pun muncul. Claude memulai thread untuk setiap bagian pekerjaan atau meneruskannya ke thread yang sudah bekerja di area itu, dan menjawab pertanyaan cepat di tempat.
- Atur konteks sekali: setiap thread baru dimulai dengan repositori, instruksi, dan memori project, jadi aturan yang Anda nyatakan sekali, seperti branch mana yang ditargetkan, mencapai semuanya.
- Pergi dan kembali ke pekerjaan yang selesai: ketika Anda kembali satu jam kemudian atau pagi berikutnya, pane Overview menunjukkan thread mana yang selesai, pull request mana yang siap untuk ditinjau, dan thread mana yang menunggu jawaban Anda.
Kapan menggunakan project
Project layak dibuat ketika pekerjaan memiliki tujuan yang melampaui satu sesi dan terus menghasilkan tugas. Jenis pekerjaan ini cocok untuk project:- Satu tujuan di banyak repositori: “Bawa setiap layanan ke konfigurasi lint baru.” Claude dapat menjalankan thread per repositori, masing-masing dengan pull request sendiri, dan pane Overview menunjukkan mana yang siap untuk ditinjau.
- Area yang terus Anda isi: bug, stack trace, dan permintaan review untuk satu layanan, ditempel ke dalam percakapan saat sampai ke Anda. Jebakan yang Anda beri tahu Claude untuk diingat setelah satu perbaikan ada di project memory untuk yang berikutnya.
- Build atau migrasi yang lebih besar dari satu sesi: “Bangun apa yang dijelaskan
docs/spec.md” atau “Pindahkan aplikasi dari ORM yang sudah usang.” Pekerjaan terbagi menjadi thread yang masing-masing mengambil bagian, keputusan yang Anda minta Claude untuk diingat di awal mencapai thread yang lebih baru, dan spec berubah serta bug yang Anda temukan selama build masuk ke percakapan yang sama. - Pekerjaan yang bukan kode: folder kontrak atau ekspor tiket dukungan yang terus Anda kembali dengan pertanyaan baru, seperti “temukan sepuluh kesalahan integrasi paling umum di tiket ini.” Unggah dokumen alih-alih menambahkan repositori, dan thread memberikan setiap laporan sebagai file di tab Library project.
Kapan sesuatu yang lain lebih cocok
Thread bekerja pada repositori GitHub dan pada file, folder, dan folder Google Drive yang Anda unggah ke project, bukan pada file atau alat yang hanya ada di mesin Anda. Sesuatu yang lain lebih cocok dalam kasus ini:- Satu tugas yang cocok dalam satu sesi: “Perbaiki tes login yang tidak stabil.” Mulai sesi cloud sendiri.
- Pekerjaan yang membutuhkan alat atau layanan yang hanya dapat dijangkau mesin Anda: database lokal, emulator perangkat, API di belakang VPN Anda. Gunakan sesi lokal, atau agent view untuk menjalankan beberapa sekaligus. Jika pekerjaan hanya membutuhkan file lokal, unggah ke project.
- Satu tugas yang berulang pada jadwal tanpa percakapan di sekitarnya: “Posting laporan dependensi setiap Senin.” Buat routine sendiri.
- Beberapa orang memberi Claude pekerjaan dan mengarahkannya bersama di saluran Slack: lihat Claude Tag.
Bagaimana project diorganisir
Project adalah satu percakapan koordinasi dengan Claude ditambah thread yang dimulainya untuk melakukan pekerjaan. Ini adalah bagian-bagiannya:- Percakapan project: satu sesi jangka panjang di mana Claude bertindak sebagai koordinator. Ini mengambil apa yang Anda kirim, memutuskan apa yang menjadi thread, dan melacak setiap thread yang dimulainya. Ini melihat apa yang dilaporkan thread kembali, bukan setiap langkah yang mereka ambil.
- Threads: para pekerja. Masing-masing adalah sesi cloud terpisah dengan jendela konteks sendiri yang melakukan satu bagian pekerjaan di cabang sendiri, membuka pull request ketika pekerjaan memanggilnya, dan melaporkan kembali ke percakapan ketika selesai.
- Apa yang dimulai setiap thread dengan:
- Repositori dan file project, ditambah instruksi dan memori
CLAUDE.md, skills, dan plugins di setiap repositori project, dan di project dengan satu repositori, aturan izin dan hooks repositori itu juga- Connectors di akun claude.ai Anda
- Cloud environment yang menetapkan akses jaringan, variabel lingkungan, kredensial API, dan alat yang terinstal
- Pane Overview: di mana Anda melihat semua thread sekaligus dan mana yang membutuhkan Anda. Tab lainnya adalah Library untuk file yang Anda tambahkan dan file yang dihasilkan thread, Pull requests untuk yang dibuka thread, dan Routines untuk pekerjaan terjadwal di project.
Buat project
Anda membuat dan menggunakan projects di claude.ai/code atau di tab Code dari aplikasi desktop. Ada dua cara untuk memulai:- Dari awal, ketika Anda tahu aliran pekerjaan yang ingin dijalankan Claude: buka dialog New project dan beri nama. Mulai project baru dari awal memandu melalui dialog.
- Dari sesi cloud yang sudah melakukan pekerjaan: pilih Continue as a project dari menu sesi itu, dan Claude mengusulkan setup project dari apa yang dilakukan sesi. Lihat Mulai dari sesi cloud yang ada.
Periksa prasyarat
Sebelum Anda membuat project, periksa paket Anda, setup GitHub Anda, dan apa yang dibutuhkan pekerjaan untuk dijangkau:- Paket: Anda berada di Pro atau Max dan Projects ditampilkan di sidebar Anda.
- GitHub, jika project akan bekerja pada kode: kode Anda ada di github.com daripada GitHub Enterprise Server, GitLab, atau Bitbucket, akun GitHub yang terhubung memiliki akses push ke kode, dan Claude GitHub App terinstal di atasnya. Jika Anda menghubungkan GitHub dengan
/web-setup, token itu memungkinkan sesi cloud lain Anda menjangkau repositori tetapi tidak cukup untuk thread project, yang membutuhkan Claude GitHub App. Atur akses GitHub memiliki langkah-langkahnya. - Jaringan, kredensial, dan alat: ini berasal dari cloud environment project. Environment default sudah menjangkau registri paket umum, jadi periksa ini hanya jika pekerjaan membutuhkan domain lain, rahasia, atau alat yang tidak terinstal sebelumnya. Jika pekerjaan membutuhkan server MCP, periksa bahwa itu ditampilkan sebagai terhubung di connectors claude.ai Anda.
Mulai project baru dari awal
Memulai project dari awal berarti membuka dialog New project, memberi nama aliran pekerjaan, dan secara opsional memberikan tujuan dan repositori serta file yang dikerjakan. Hanya nama yang diperlukan, jadi Anda dapat membuat project terlebih dahulu dan mengisinya saat pekerjaan berkembang.1
Buka Projects
Di claude.ai/code atau di tab Code dari aplikasi desktop, pilih Projects di sidebar kiri, lalu pilih New project. Di browser Anda juga dapat langsung ke claude.ai/code/projects/browse.
2
Isi dialog New project
Batasi project ke satu aliran pekerjaan yang akan terus Anda tambahkan, seperti semua yang diperlukan untuk menjaga satu API di bawah target latensinya. Kapan menggunakan project memiliki lebih banyak contoh. Kemudian isi bidang dialog:
- Name: bagaimana project muncul di daftar Projects.
- Goal (opsional): satu baris tentang apa yang Anda coba capai, seperti “Pertahankan latensi API p95 di bawah 200 ms”. Claude dalam percakapan bekerja menuju itu. Tanpa tujuan, Claude bekerja dari tugas yang Anda kirim, dan Anda dapat menambahkan tujuan nanti di Project settings > General.
- Context (opsional): repositori GitHub yang dikerjakan project ini, ditambah file, folder, atau folder Google Drive apa pun yang harus dibaca thread. Klik Add untuk masing-masing. Tambahkan repositori yang paling banyak dibutuhkan tugas daripada setiap yang mungkin disentuh pekerjaan; Tentukan repositori mana yang akan ditambahkan mencakup pilihan, dan Anda dapat menambahkan lebih banyak nanti di Project settings > Environment.
3
Buat project
Klik Create project. Percakapan project terbuka dengan kotak pesan di bagian bawah, di mana Anda mendeskripsikan pekerjaan untuk Claude.Di project pertama Anda, Claude mengambil giliran sendiri segera setelah project dibuat, kecuali Anda mengirim pesan terlebih dahulu. Giliran itu menggunakan paket Anda. Di dalamnya, Claude mungkin:
- Mulai satu thread yang mengeksplorasi repositori tanpa mengubah apa pun dan mengusulkan langkah berikutnya, jika project memiliki repositori yang dapat dibaca.
- Posting Setup recommendations yang diambil dari sesi cloud terbaru Anda: repositori untuk ditambahkan, routine untuk dibuat, dan thread yang dapat dimulai. Setiap repositori dan routine yang direkomendasikan dimulai dengan diaktifkan. Matikan yang tidak Anda inginkan, lalu klik Update setup untuk menambahkan sisanya, atau abaikan rekomendasi dan deskripsikan pekerjaan sendiri.
Mulai dari sesi cloud yang ada
Jika Anda sudah memiliki sesi cloud yang melakukan pekerjaan yang seharusnya ada di project, buka menu sesi di sidebar dan pilih Continue as a project atau Move to project:- Continue as a project membuat project baru bernama sesuai sesi dan membukanya. Claude membaca sesi dan memposting Setup recommendations dalam percakapan untuk Anda konfirmasi. Sesi asli tetap ada di daftar sesi Anda, dan jika sedang dalam giliran, terus berjalan, jadi hentikan sendiri jika Anda tidak ingin keduanya bekerja sekaligus. Jika Anda menggunakan banner Set up project yang dapat muncul di atas kotak pesan sesi cloud, hasilnya sama, kecuali giliran sesi yang sedang berjalan berhenti setelah project terbuka.
- Move to project membawa pekerjaan sesi ke project yang ada. Ini memposting pesan di percakapan project itu meminta Claude untuk membaca sesi dan melanjutkan dari mana ia berhenti, dan pekerjaan baru berlanjut di thread project sendiri. Sesi asli tetap ada di daftar sesi Anda, tidak berubah.
Atur akses GitHub
Sebagian besar setup GitHub terjadi sekali, bukan per project. Anda menghubungkan akun GitHub ke Claude sekali, dan Claude GitHub App diinstal sekali per repositori, atau sekali untuk seluruh organisasi GitHub jika Anda memberikan semua repositori. Anda kembali ke langkah-langkah ini ketika Anda menambahkan repositori yang Claude GitHub App belum cover atau satu di organisasi GitHub yang memberlakukan SSO.1
Hubungkan akun GitHub Anda
Jika Anda belum pernah menggunakan claude.ai/code sebelumnya, kunjungan pertama Anda memandu Anda menghubungkan GitHub; lihat Hubungkan GitHub. Jika tidak, gunakan salah satu dari opsi autentikasi GitHub.
2
Instal Claude GitHub App di repositori project
Instal Claude GitHub App dan berikan repositori yang akan digunakan project. Di repositori yang dimiliki organisasi GitHub, hanya pemilik organisasi yang dapat menyelesaikan instalasi; jika Anda bukan, GitHub mengirim permintaan instalasi ke pemilik dan project tidak dapat menggunakan repositori sampai mereka menyetujuinya.
3
Otorisasi SSO untuk organisasi yang memberlakukannya
Jika organisasi GitHub memberlakukan SAML SSO, hubungkan kembali GitHub dan otorisasi aplikasi Claude untuk organisasi itu. Sampai Anda melakukannya, repositori pribadi organisasi itu tidak muncul di dialog New project atau Project settings > Environment.
Bekerja di project
Berikan Claude pekerjaan melalui percakapan project: tugas satu per satu atau beberapa sekaligus, ditambah pembaruan dan pemikiran longgar saat muncul. Claude merutekan setiap pesan, dan thread melakukan pekerjaan dan melaporkan kembali.Batch pertama Anda
Sebelum Anda mengirim batch pekerjaan project baru, aturlah sehingga thread pertama kembali seperti yang Anda inginkan:- Tulis project instructions: brief yang dimulai setiap thread, seperti cabang mana yang ditargetkan, bagaimana thread memeriksa pekerjaannya, dan apa yang membutuhkan persetujuan Anda.
- Kirim satu bagian kecil dari pekerjaan nyata, atau mulai salah satu thread yang disarankan Claude, dan buka thread ketika selesai untuk melihat bagaimana ia melaporkan kembali dan apa yang dilakukannya di cabangnya. Jika ia mengasumsikan sesuatu yang salah atau tidak dapat menjangkau apa yang dibutuhkan, Threads menebak atau terhenti alih-alih bertanya mencakup tempat untuk memperbaikinya.
- Periksa Thread model dan Thread effort di Project settings > General. Project baru menjalankan setiap thread pada Opus dengan effort tinggi, yang menggunakan paket Anda paling cepat; Pilih model dan biarkan Claude mengelola konteks mencakup alternatifnya.
- Minta Claude untuk mengusulkan thread sebelum memulainya dan menjalankan beberapa sekaligus, dan turunkan batas tersebut setelah beberapa thread kembali seperti yang Anda inginkan.
Kirim pekerjaan dan baca hasil
Claude memutuskan di mana setiap pesan yang Anda kirim dalam percakapan pergi:- Pertanyaan cepat biasanya mendapat jawaban dalam percakapan.
- Pekerjaan baru masuk ke thread baru atau ke thread yang sudah bekerja di area itu, dan Claude memberi tahu Anda mana. Setiap thread baru muncul di bawah pesan Anda sebagai kartu: kotak dengan judul dan status thread, yang Anda klik untuk membuka thread.
- Beberapa tugas yang tidak terkait dalam satu pesan menjadi thread terpisah.
Tinjau pull request thread
Ketika thread mengubah kode, inilah yang dilakukannya kecuali Anda memberi tahu sebaliknya:- Branch: bekerja di cabang baru, dimulai dari cabang default repositori.
- Pull request: membuka satu ketika Anda minta, dan dapat membuka satu sendiri untuk perbaikan bug atau perubahan konkret lainnya.
- Setelah dibuka: mengawasi pull request dengan auto-fix diaktifkan, terlepas dari apakah auto-fix aktif untuk sesi cloud lainnya. Ini mendorong perbaikan ketika CI gagal, mengatasi komentar review, dan membalas di thread ketika pemeriksaan lulus dan pull request siap untuk Anda.
Lihat apa yang membutuhkan Anda di Overview
Pane Overview di samping percakapan melacak thread project. Sudah terbuka pertama kali Anda membuka project baru. Tombol Overview di header project menutup dan membukanya kembali, dan menunjukkan titik ketika thread menunggu Anda. Di aplikasi desktop, Anda juga mendapatkan notifikasi desktop ketika Claude memposting dalam percakapan, thread mengalami kesalahan, atau thread membutuhkan input Anda, jadi Anda tidak harus membuat project tetap terbuka untuk mengetahuinya. Untuk juga mendapatkan satu setiap kali thread menyelesaikan giliran, atau untuk mematikannya untuk project, pilih Notifications di menu sidebar project. Notifikasi ini hanya desktop: di browser, periksa titik pada tombol Overview. Tab Threads pane mengelompokkan thread berdasarkan keadaan:
Tab lain pane adalah Library untuk file dan folder yang Anda tambahkan dan file yang dihasilkan thread, Pull requests setelah thread membuka apa pun, dan Routines untuk routines yang Claude atur dari project ini.
Buka thread ketika Anda membutuhkan kontrol
Klik kartu thread dalam percakapan atau barisnya di Overview untuk membuka transkrip di pane Overview. Dari sana Anda dapat:- Baca apa yang dilakukan Claude, langkah demi langkah.
- Kemudi tugas dengan menulis di kotak pesan thread sendiri. Pesan di sana langsung ke thread itu, sementara follow-up dalam percakapan project mencapainya hanya ketika Claude mencocokkan follow-up ke thread itu.
- Jawab prompt izin yang ditunggu thread.
- Interupsi thread dengan Stop, yang menggantikan tombol kirim saat thread bekerja, atau dengan menekan Esc.
Pilih model dan biarkan Claude mengelola konteks
Atur model dan effort di Project settings > General. Project baru menjalankan Opus di mana-mana, dengan effort tinggi untuk thread dan effort rendah untuk percakapan:- Thread model dan Thread effort berlaku untuk thread. Untuk menggunakan model berbeda untuk satu tugas, minta dalam tugas; untuk thread yang sudah berjalan, gunakan pemilih model thread itu.
- Coordinator model dan Coordinator effort berlaku untuk Claude dalam percakapan project.
Sesuaikan cara Claude menjalankan project
Beri tahu Claude dalam percakapan berapa banyak thread yang harus dijalankan sekaligus, kapan memposting pembaruan, dan kapan membuka pull request. Jika Claude mengoordinasikan dengan cara yang tidak Anda inginkan, katakan saja. Misalnya, Anda dapat mengatakan:- “Usulkan thread dan tunggu persetujuan saya sebelum memulainya” atau “Mulai ini sekarang tanpa meminta saya untuk mengonfirmasi”
- “Jalankan paling banyak dua thread sekaligus” atau “Gunakan kembali thread yang ada untuk follow-up di area yang sama”
- “Posting pembaruan yang lebih pendek” atau “Hanya posting ketika sesuatu selesai atau terblokir”
- “Berikan saya pembaruan status di setiap thread”
- “Lakukan tugas ini dengan model yang lebih kecil”
- “Jangan buka pull request sampai saya telah melihat rencananya”
- “Beri tahu saya apa yang salah di repositori ini dan jangan perbaiki apa pun dulu”, ketika Anda ingin melalui temuan sebelum salah satu menjadi thread
- “Jawab itu di sini alih-alih memulai thread”, ketika Claude memulai thread untuk sesuatu yang Anda maksudkan sebagai pertanyaan cepat
Buka blokir thread yang menunggu persetujuan
Thread berjalan dalam auto mode ketika model thread mendukungnya, jadi sebagian besar panggilan alat berjalan tanpa meminta Anda. Ketika thread membutuhkan persetujuan Anda, prompt ada di dalam thread itu dan thread menunggu sampai Anda menjawabnya di sana. Memberi tahu Claude dalam percakapan project untuk melanjutkan tidak mencapainya. Setiap persetujuan mencakup prompt itu, atau sisa thread itu jika Anda memilih opsi yang lebih luas. Untuk membiarkan setiap thread menjalankan perintah tertentu tanpa bertanya, atau untuk memblokir beberapa, tambahkan permission rules ke.claude/settings.json repositori. Thread menerapkannya hanya dalam project dengan satu repositori; lihat Apa yang diambil thread dari repositori Anda.
Berikan project konteks berdiri
Project memory, project instructions, dan repositori, file, dan environment project membawa konteks di seluruh thread. Anda menetapkan masing-masing sekali dan itu berlaku untuk setiap thread baru.
Project settings > Memory mencantumkan file-file ini di bawah Auto memory, karena Claude menulisnya sendiri saat bekerja di project. Mereka terpisah dari auto memory yang disimpan Claude Code di mesin Anda, meskipun keduanya menggunakan indeks
MEMORY.md. Project memory juga terpisah dari file CLAUDE.md di repositori project. Setiap thread masih membaca file CLAUDE.md itu dari klonnya ketika dimulai, jadi masukkan instruksi tentang repositori di CLAUDE.md-nya dan catatan tentang project di project memory.
Tulis project instructions
Project instructions adalah brief yang dimulai setiap thread baru. Klik ikon gear di header project untuk membuka Project settings, lalu buka Memory > Project instructions. Brief yang berguna mencakup:- Apa project itu untuk
- Di mana pekerjaan terjadi: repositori mana, cabang mana yang dimulai, cara memberi nama pull request
- Bagaimana thread memeriksa pekerjaannya sendiri sebelum menyebutnya selesai
- Apa yang harus dilakukan ketika sesuatu yang dibutuhkan hilang
- Apa yang membutuhkan persetujuan Anda terlebih dahulu
CLAUDE.md repositori itu, yang dibaca setiap thread ketika repositori adalah bagian dari project. Setelah pekerjaan sedang berlangsung, ketika Anda mengoreksi thread, juga beri tahu Claude untuk mengingat koreksi: itu masuk ke project memory dan thread yang lebih baru dimulai dengannya.
Tentukan repositori mana yang akan ditambahkan
Repositori yang Anda tambahkan ke project datang dengan semua yang ada di dalamnya, kode,CLAUDE.md, dan skills, di setiap thread. Repositori yang tidak Anda tambahkan masih dalam jangkauan: thread dapat menambahkan satu ke dirinya sendiri ketika tugasnya membutuhkannya. Sebagian besar project menggunakan keduanya:
- Tambahkan ke project, di dialog New project, di Project settings > Environment, atau dengan meminta Claude dalam percakapan untuk menambahkannya ke project. Setiap thread dari saat itu mengklonnya dan dimulai dengan
CLAUDE.mddan skills-nya dimuat, terlepas dari apakah tugas menyentuhnya. Pergi dari satu repositori ke beberapa juga mengubah apa yang diambil thread dari.claude/settings.jsonsetiap repositori; lihat Apa yang diambil thread dari repositori Anda. - Biarkan off dan biarkan thread menambahkannya ketika diperlukan. Thread yang tugasnya membutuhkan repositori yang tidak dimiliki project dapat menambahkannya ke dirinya sendiri, dan catatan dalam thread mengatakan itu ditambahkan ke thread ini saja. Klon terjadi setengah jalan melalui tugas, jadi
CLAUDE.mddan skills repositori itu tidak ada ketika thread dimulai. Thread berikutnya dimulai tanpanya lagi. Repositori yang ditambahkan thread membutuhkan prasyarat yang sama dengan repositori project: Claude GitHub App diinstal di atasnya dan akses push dari akun GitHub Anda.
Apa yang diambil thread dari repositori Anda
Setiap thread mengkloning setiap repositori dalam project dan memuatCLAUDE.md, skills, dan plugins dari semuanya. Permission rules, hooks, dan env hanya datang dari .claude/settings.json di direktori tempat thread dimulai: di dalam repositori ketika project memiliki satu, dan di atas klon ketika memiliki beberapa, di mana file repositori tidak dibaca untuk mereka.
Dalam project dengan beberapa repositori, setiap klon dilampirkan ke thread sebagai direktori tambahan dengan pemuatan
CLAUDE.md diaktifkan, itulah mengapa CLAUDE.md dan skills setiap repositori dimuat saat mulai meskipun thread dimulai di atasnya. Bagaimanapun, hooks yang disediakan plugin yang diaktifkan masih berjalan, karena plugins dimuat dari setiap repositori. Dalam project dengan beberapa repositori, masukkan aturan berdiri di project instructions dan berikan thread variabel lingkungan melalui cloud environment.
Pilih environment untuk thread
Setiap thread baru dimulai dalam cloud environment project. Environment menetapkan domain mana yang dapat dijangkau thread, variabel lingkungan mana yang mereka miliki, kredensial API mana yang ditambahkan ke permintaan mereka, dan apa yang diinstal skrip setup sebelum Claude dimulai. Thread menggunakan environment default yang dihosting Anthropic sampai Anda memilih satu di Project settings > Environment. Jika thread perlu menjangkau API internal atau registri paket pribadi, atau membutuhkan token yang biasanya disimpan mesin Anda, ubah environment daripada project: lihat Network access, Add API credentials, dan Setup scripts.Dapatkan skills, plugins, connectors, dan tools ke dalam threads
Thread adalah sesi cloud, jadi mereka tidak memiliki skills, server MCP, plugins, dan tools yang diinstal hanya di mesin Anda. Untuk membuat masing-masing tersedia untuk thread:- Skills, subagents, dan commands: commit ke repositori yang Anda tambahkan ke project, misalnya skill di
.claude/skills/<skill-name>/SKILL.md. Setiap thread mengkloning setiap repositori dalam project dan memuat.claude/skills/,.claude/agents/, dan.claude/commands/dari masing-masing, jadi skill yang dicommit ke satu repositori tersedia di setiap thread baru. Thread juga memuat skills yang Anda aktifkan untuk akun claude.ai Anda. - Plugins: tambahkan di Project settings > Plugins; mereka dimuat ke setiap thread baru. Plugins yang dideklarasikan repositori di
.claude/settings.json-nya juga dimuat; lihat Apa yang dibawa dari setup Anda. - Server MCP: thread mendapatkan alat MCP mereka dari connectors di akun claude.ai Anda, yang merupakan server MCP yang Anda hubungkan sekali di claude.ai/customize/connectors atau melalui link Manage connectors di Project settings > Environment. Setiap thread dapat menggunakan semuanya tanpa setup per-project. Percakapan project itu sendiri tidak memiliki connectors, jadi kirim pekerjaan yang membutuhkan satu sebagai tugas untuk thread. Dalam project dengan satu repositori, thread juga memuat server MCP dari
.mcp.jsonrepositori itu. Bagaimana connectors mencapai Claude Code mencantumkan aturan untuk sesi cloud dan pengaturan yang mematikan connectors. - Command-line tools dan packages: instal di setup script environment.
Referensi pengaturan project
Anda mengubah pengaturan project di claude.ai/code atau di aplikasi desktop, bukan disettings.json. Buka Project settings dari Settings di menu sidebar project atau dari ikon gear di header project.
Pengaturan disimpan saat Anda mengubahnya; bidang teks yang sedang Anda edit, seperti tujuan atau instruksi, menampilkan Save changes dan Discard sampai Anda meninggalkannya. Perubahan instruksi, repositori, plugins, dan environment di Project settings mencapai thread baru, bukan thread yang sudah berjalan.
Pause, archive, atau delete project
Ketiga kontrol ada di bagian bawah Project settings > General:- Pause: menghentikan semuanya sekaligus. Setiap thread yang berjalan dan percakapan terinterupsi, thread baru tidak dimulai, routine tidak berjalan, dan project tidak menerima pesan sampai Anda melanjutkannya. Klik Resume di tempat yang sama atau di banner di atas kotak pesan project; thread yang dijeda berlanjut ketika Anda mengirim pesan setelahnya.
- Archive: menyembunyikan project dari sidebar dan mengarsipkan thread-nya, yang menghentikan thread apa pun yang sedang berjalan atau menonton pull request. Routine dalam project tidak berjalan saat diarsipkan. Untuk membawa project kembali, buka dari halaman Projects dan klik Unarchive. Thread-nya tetap diarsipkan sampai Anda membuka arsipnya secara individual dari daftar sesi.
- Delete: secara permanen menghapus project bersama dengan thread-nya, memorinya, dan file-nya, dan mematikan routine project. Ini tidak dapat dibatalkan. Cabang dan pull request yang didorong thread ke GitHub tidak terpengaruh.
Penggunaan dan biaya
Penggunaan project dihitung terhadap batas paket yang sama dengan sesi Claude Code lainnya Anda, dan project tidak dapat menghabiskan melampaui batas itu sendiri. Thread yang mencapai batas paket Anda menunggu dan berlanjut sendiri ketika batas direset, jadi pekerjaan yang Anda tinggalkan berjalan mulai menggunakan jendela penggunaan berikutnya tanpa pesan dari Anda. Thread mencapai batas penggunaan mencakup apa yang Anda lihat, cara menghentikannya, dan satu kasus yang tidak menunggu. Pekerjaan melampaui batas paket Anda hanya jika Anda telah mengaktifkan usage credits untuk akun Anda. Thread tidak dapat mengaktifkannya untuk Anda.Apa yang menggunakan paket Anda
Project menggunakan batas Anda lebih cepat daripada sesi tunggal, dan pada paket Pro khususnya Anda harus mengharapkan mencapai batas Anda lebih cepat pada hari Anda menjalankan satu. Ini adalah bagian dari project yang menggunakan paket Anda:- Running threads: masing-masing adalah sesi penuh, dan beberapa dapat berjalan sekaligus. Tidak ada angka tetap; Claude memulai sebanyak yang diperlukan pekerjaan, dan batas yang Anda minta adalah preferensi daripada batas. Batas yang diberlakukan adalah 200 thread baru per hari di seluruh project Anda.
- Percakapan: Claude menggunakan token sendiri membaca apa yang dilaporkan thread dan memutuskan apa yang harus dilakukan selanjutnya.
- Thread menonton pull request: thread idle bangun dan menggunakan paket Anda lagi ketika CI gagal atau komentar review tiba di pull request-nya. Untuk menghentikan itu, minta di thread untuk berhenti menonton pull request.
Lihat dan kurangi penggunaan project
Buka Usage di Project settings untuk melihat penggunaan token berdasarkan thread dan model, dan berapa banyak yang masuk ke percakapan project. Untuk menurunkannya:- Follow-up yang dirutekan ke thread yang telah idle lebih lama dari cache lifetime, satu jam di Pro dan Max dalam batas paket Anda, membaca ulang seluruh percakapan thread sebelum melakukan apa pun. Untuk pekerjaan baru, meminta Claude untuk memulai thread segar dapat menggunakan lebih sedikit daripada menghidupkan kembali yang lama dan besar.
- Untuk pekerjaan yang tidak membutuhkan model terbesar, pilih model yang lebih kecil atau effort level yang lebih rendah untuk thread, percakapan, atau keduanya.
- Minta Claude dalam percakapan project untuk menjalankan lebih sedikit thread sekaligus, atau untuk menjawab pertanyaan kecil sendiri alih-alih memulai thread.
Bagaimana project berhubungan dengan fitur Claude Code lainnya
Beberapa fitur Claude Code memungkinkan lebih dari satu sesi bekerja pada waktu yang sama, jadi menjalankan pekerjaan secara paralel bukan dengan sendirinya apa yang dimaksudkan project. Dalam project, Claude memulai dan melacak sesi alih-alih Anda, masing-masing dimulai dari repositori, instruksi, dan memori yang sama, dan pekerjaan hidup di cloud selama pekerjaan berlangsung. Inilah cara setiap fitur tetangga terhubung ke project:- Claude Tag: Claude Tag adalah Claude di saluran Slack tim Anda, di paket Team dan Enterprise. Siapa pun di saluran dapat memberikan pekerjaan, semua orang di saluran melihat dan mengarahkannya, dan itu menggunakan koneksi yang disiapkan admin untuk saluran itu. Project adalah milik Anda sendiri: Anda satu-satunya yang mengirim pekerjaan atau melihat thread-nya, itu menggunakan akses GitHub dan connectors Anda sendiri, dan itu di Pro dan Max. Bagaimana Claude Tag berbeda dari Cowork dan Claude Code memiliki perbandingan berdampingan.
- Cloud sessions: setiap thread adalah sesi cloud, dimulai dan dilacak oleh Claude alih-alih oleh Anda. Sesi cloud yang Anda mulai sendiri dapat menjadi project atau memberi makan satu melalui Continue as a project atau Move to project.
- Routines: ketika Anda meminta pekerjaan terjadwal dalam project, Claude membuat routine yang berjalan sebagai thread dalam project itu dan muncul di tab Routines-nya. Routine yang Anda buat di luar project terus bekerja sendiri.
- Local sessions dan agent view: sesi di terminal, IDE, atau environment lokal aplikasi desktop berjalan di mesin Anda dan tidak dapat menjadi bagian dari project. Agent view adalah layar untuk melacak beberapa sesi lokal itu; itu tidak memiliki koordinator.
- Worktrees: worktree memberikan setiap sesi lokal salinan kerjanya sendiri dari repositori sehingga sesi paralel di mesin Anda tidak menimpa satu sama lain. Thread tidak membutuhkannya: setiap thread mengkloning repositorinya ke sandbox cloud sendiri dan bekerja di cabang sendiri.
- Agent teams: agent team adalah satu sesi yang memulai sesi rekan untuk satu tugas, di mesin Anda atau di dalam sesi cloud, dan berakhir dengan tugas itu.
- Projects di claude.ai chat dan Cowork: pengalaman Projects sebelumnya, yang mengelompokkan percakapan dan file referensi tanpa thread atau koordinator. Project tersebut terus bekerja seperti yang mereka lakukan hari ini sampai pengalaman yang dirancang ulang mencapai mereka.
Keterbatasan
- Project tersedia di claude.ai/code dan di aplikasi desktop, bukan di CLI terminal atau melalui Amazon Bedrock, Google Cloud’s Agent Platform, atau Microsoft Foundry. Perintah
claude projectCLI, yang mengelola keadaan Claude Code lokal untuk direktori, tidak terkait. - Thread project adalah sesi cloud dengan Anthropic sebagai penyedia model. Security dan Data usage mencakup bagaimana sesi cloud diisolasi dan apa yang disimpan.
- Sesi lokal tidak dapat menjadi bagian dari project.
- Sandbox thread dijeda antara giliran dan dilanjutkan ketika thread berlanjut. Jika sandbox tidak dapat dilanjutkan, thread berlanjut dari klon segar, jadi perubahan yang tidak dicommit dapat hilang. Pada tugas panjang, minta Claude untuk commit dan push pekerjaan yang sedang berlangsung.
- Project milik satu pengguna. Anda tidak dapat berbagi project atau thread-nya dengan pengguna lain, dan transkrip thread tidak memiliki opsi berbagi yang dimiliki sesi cloud lain. Tidak ada kontrol tingkat organisasi untuk project selama beta.
- Thread milik satu project yang memulainya. Anda tidak dapat memindahkan atau menyalin thread ke project lain, atau memindahkannya keluar untuk berdiri sendiri. Move to project hanya berjalan dengan cara lain: itu membawa pekerjaan sesi cloud ke project.
Troubleshooting
Untuk prompt setup GitHub di dialog New project, lihat Atur akses GitHub.Thread terlihat terjebak
Claude tidak memposting setiap langkah yang diambil thread, jadi thread yang menunjukkan sedang berjalan tanpa pesan baru dalam percakapan project biasanya masih bekerja. Thread baru juga menyediakan cloud environment-nya sebelum Claude dimulai, jadi pembaruan pertamanya membutuhkan waktu. Buka thread untuk membaca transkrip-nya. Jika thread menunggu prompt izin, jawab di sana.Threads menebak atau terhenti alih-alih bertanya
Ketika beberapa thread kembali telah mengasumsikan sesuatu yang salah, bekerja di sekitar akses yang hilang, atau berhenti dengan “blocked”, penyebabnya biasanya celah yang sama dalam setup project daripada masalah dengan setiap tugas. Urutkan thread mana yang solid sebelum Anda memperbaiki apa pun:- Tanya Claude dalam percakapan: “Untuk setiap thread terbuka, daftarkan apa yang Anda minta untuk dilakukan, apa yang diasumsikan atau tidak dapat dijangkau, dan apa yang ditunggu.” Claude membaca setiap thread dan menjawab dalam percakapan.
- Untuk thread yang dimulai dari asumsi yang salah, buka thread dari Overview dan tandai resolved dari menunya, atau beri tahu apa yang harus dilakukan sebagai gantinya di kotak pesannya. Cabang dan pull request apa pun tetap di GitHub sampai Anda menghapusnya.
- Perbaiki celah sekali, di project instructions atau environment, lalu kirim satu thread sebelum mengirim sisa pekerjaan lagi sebagai thread baru.
Claude belum merespons
Percakapan project menunjukkan banner “Claude hasn’t responded” ketika Claude sedang berjalan tetapi balasannya tidak mencapai project. Klik Restart Claude di banner, atau buka Project settings > General dan klik Restart di baris Restart Claude. Claude terhubung kembali ke percakapan; balasan apa pun yang sedang ditulis hilang, dan thread tidak terpengaruh.Repository access errors
Tiga pesan berarti thread atau project tidak dapat menjangkau salah satu repositorinya. Thread project membutuhkan prasyarat GitHub bahkan ketika sesi cloud lain Anda mengkloning repositori yang sama tanpa masalah.- “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”, dilaporkan sebelum thread dimulai, ketika Claude GitHub App tidak diinstal di repositori itu, ditangguhkan, atau tidak tertaut ke akun GitHub yang Anda hubungkan.
- “Unable to access your repository”, dilaporkan oleh thread ketika klonnya gagal: GitHub menolak klon, repositori tidak ditemukan dengan nama yang dimiliki project, atau cabang yang diminta thread untuk dimulai tidak ada.
- “Claude can’t access” repositori, ditampilkan ketika Anda menyimpan repositori di dialog New project atau Project settings. Pesan berlanjut dengan link instalasi dan link reconnect. Gunakan link instalasi jika Claude GitHub App tidak ada di repositori itu, dan link reconnect jika ada, karena GitHub App dapat diinstal di GitHub tanpa tertaut ke akun yang Anda hubungkan ke Claude. Jika pesan mengatakan GitHub App ditangguhkan atau tidak menyertakan repositori ini, ikuti linknya ke GitHub untuk memperbaikinya.
Thread mencapai batas penggunaan
Ketika thread atau percakapan project mencapai batas lima jam atau mingguan paket Anda, itu terus mencoba sendiri dan berlanjut ketika batas direset. Saat menunggu, thread menunjukkan Service is busy dengan “Claude is still retrying and will continue automatically.” Anda tidak perlu melakukan apa pun agar pekerjaan berlanjut. Jika Anda lebih suka tidak menggunakan jendela penggunaan berikutnya, klik Stop di thread, atau pause project untuk menahan setiap thread. Thread yang dimulai routine tidak menunggu: giliran-nya berhenti dengan kesalahan batas, dan Anda mengirim pesan setelah batas direset. Usage limit errors menjelaskan batas dan kapan mereka direset.Kredit penggunaan tambahan diperlukan
Thread atau percakapan project membuat permintaan yang hanya dicakup paket Anda dengan kredit penggunaan, seperti satu ke model atau ukuran konteks yang tidak disertakan paket Anda, dan kredit penggunaan tidak diaktifkan untuk akun Anda. Tambahkan kredit penggunaan ke langganan Anda mencakup siapa yang dapat mengaktifkannya atau membelinya di setiap paket. Setelah kredit tersedia, kirim pesan lain untuk mencoba lagi.Pesan lainnya
Pesan ini menyebutkan penyebab mereka sendiri. Tabel memberikan langkah berikutnya untuk masing-masing.Sumber daya terkait
- Gunakan Claude Code di cloud: bagaimana sesi cloud di balik setiap thread bekerja, termasuk opsi akses GitHub dan auto-fix pada pull request
- Konfigurasi cloud environments: ubah apa yang dapat dijangkau thread di jaringan, berikan mereka variabel lingkungan dan kredensial API, dan instal alat dengan skrip setup
- Otomatisasi pekerjaan dengan routines: jadwal, pemicu, dan manajemen untuk routine, termasuk yang dibuat Claude dari project
- Kelola beberapa agen dengan agent view: jalankan dan lacak beberapa sesi di mesin Anda sendiri ketika pekerjaan membutuhkan alat atau layanan yang hanya dapat dijangkau mesin Anda
- Projects redesigned: from folder to conversation: pengumuman peluncuran, dengan pemikiran di balik membuat project menjadi percakapan dengan Claude