Claude Code Projects: penyelaras, thread dan batasan beta

Anthropic baru-baru ini mereka semula Projects dalam Claude Code. Kini, ia merupakan satu perbualan penyelarasan yang melancarkan sesi awan selari — thread — untuk tugasan dan menerima laporan daripadanya. Projek berbaloi diwujudkan apabila kerja anda mempunyai matlamat yang akan berlanjutan melebihi satu sesi dan menghasilkan tugasan baharu — contohnya, membangunkan repositori GitHub selama beberapa minggu. Keperluan untuk bekerja secara selari sahaja tidak mencukupi. Jika anda perlu membetulkan satu fail dengan cepat sekarang, sesi biasa sudah memadai.

Kerja diketuai oleh penyelaras — perbualan berjangka panjang tempat Claude menentukan perkara yang perlu dijadikan tugasan untuk thread daripada mesej anda. Thread menulis kod: setiap satunya ialah sesi Claude Code awan yang berasingan pada cabang repositorinya sendiri. Beberapa thread boleh berjalan serentak, masing-masing dengan konteks dan cabangnya sendiri. Penyelaras melihat laporan thread apabila tugasan selesai, tetapi bukan setiap langkah yang diambilnya. Penyelaras melaporkan permintaan tarik (permintaan untuk menggabungkan perubahan) yang telah selesai kepada anda dan, atas arahan anda, meminta thread menyemak semula atau menggabungkannya. Di bawah ialah gambaran keseluruhan berdasarkan dokumentasi rasmi Anthropic: perkara yang perlu dikonfigurasikan, cara kerja disusun dan batasan beta.

Beta ini sedang disediakan secara berperingkat, bermula dengan akaun Pro dan Max yang pernah menggunakan sesi Claude Code awan dan belum membuat projek dalam sembang biasa atau Cowork. Jika bahagian Projects belum kelihatan kepada anda, anda boleh menyertai senarai menunggu.

Maksud Claude Code Projects, secara ringkas#

Projek ialah satu perbualan berjangka panjang dengan penyelaras, yang disertakan repositori, memori dan arahan. Anda menulis kepada penyelaras, lalu penyelaras memutuskan sama ada hendak menjawab serta-merta atau melancarkan thread. Anda tidak perlu membuka sesi baharu secara manual untuk setiap tugasan.

Thread ialah sesi Claude Code awan yang lengkap: ia mempunyai konteks dan cabang repositorinya sendiri, serta membuka permintaan tarik apabila perlu. Penyelaras boleh membiarkan beberapa thread terbuka serentak — contohnya, satu membetulkan pepijat, satu lagi menulis ujian dan satu lagi mengemas kini dokumentasi — sambil menjawab soalan anda dalam perbualan utama.

Sebagai perbandingan, bayangkan beberapa tab dengan sesi Claude Code setempat, setiap satunya menggunakan salinan repositori yang berasingan. Salinan seperti ini dipanggil worktree — folder berasingan untuk satu cabang, supaya sesi setempat tidak mengganggu satu sama lain. Anda bertukar antara sesi sendiri dan menentukan tugasan untuk setiap sesi. Thread awan tidak memerlukan worktree: setiap thread mengklon repositori ke dalam persekitaran awannya yang terpencil. Projects mengurus penyelarasan dan menentukan bila thread baharu perlu dibuat dan bila ia tidak diperlukan.

Projek mempunyai memori dan arahan yang dikongsi, yang diterima oleh setiap thread baharu. Bahagian persediaan menerangkan perkara yang patut disimpan di dalamnya dan cara kandungan itu dihantar kepada thread.

Perbezaannya daripada sesi biasa dan pasukan ejen#

Jika anda sudah menjalankan subejen bersarang dalam satu sesi Claude Code, elok anda membezakan subejen tersebut daripada pasukan ejen dan thread projek. Pasukan ejen ialah satu lagi cara untuk menyerahkan kerja: satu sesi melancarkan sesi rakan sepasukan untuk tugasan tertentu. Anda boleh menjalankannya pada mesin sendiri atau dalam sesi awan.

• Pasukan ejen — sesi rakan sepasukan untuk satu tugasan tertentu yang boleh dilancarkan secara setempat atau dalam awan. Ini bukan thread projek yang berasingan.
• Projek dan threadnya — kerja berjalan dalam awan. Setiap thread ialah sesi berasingan pada cabangnya sendiri dan terus berjalan walaupun selepas anda menutup komputer riba. Sesi setempat tidak boleh menjadi sebahagian daripada projek.
• Paparan ejen — skrin untuk memerhatikan beberapa sesi setempat pada mesin anda. Tiada penyelaras: anda menentukan tugasan untuk setiap sesi.

Dokumentasi rasmi Anthropic menyatakan secara khusus bahawa kerja selari sahaja bukan alasan untuk mewujudkan projek. Dalam projek, Claude sendiri melancarkan sesi dan menerima laporan daripadanya, dan semua sesi bermula dengan repositori, arahan serta memori yang dikongsi. Kerja kekal dalam awan sepanjang tugasan.

Pendekatan serupa — penyelaras mengagihkan tugasan kepada ejen — dilaksanakan dalam alat lain yang dibincangkan dalam artikel tentang Cursor Projects. Mekanismenya berbeza, tetapi penyelaras juga menentukan tugasan yang diberikan kepada setiap pihak.

Perkara yang perlu dikonfigurasikan sebelum projek pertama#

Sebelum membuat projek, semak tiga perkara.

1. Akaun GitHub dan Claude GitHub App. Jika anda sudah menyambungkan GitHub melalui /web-setup, token itu membolehkan sesi awan biasa anda mengakses repositori. Token itu tidak mencukupi untuk thread projek: anda memerlukan akaun GitHub yang disambungkan dengan akses push ke repositori dan Claude GitHub App yang dipasang untuk repositori tersebut. Tanpanya, thread tidak dapat mengklon repositori atau membuka permintaan tarik.

2. Arahan projek. Arahan projek ialah teks sehingga 16 000 aksara yang dihantar kepada setiap thread baharu dan penyelaras itu sendiri. Masukkan maklumat yang jika tidak, perlu anda terangkan semula dalam setiap sesi: struktur repositori, konvensyen kod dan semakan yang diperlukan sebelum permintaan tarik.

3. Model dan tahap usaha. Secara lalai, thread baharu dalam sesuatu projek menggunakan model Opus dengan tahap usaha tinggi, manakala penyelaras menggunakan tahap usaha rendah. Dokumentasi menyatakan bahawa tetapan ini “menghabiskan kuota pelan anda paling cepat” (terjemahan; asal: draws on your plan fastest). Jika tugasan anda mudah, anda boleh memilih model yang lebih murah atau mengurangkan tahap usaha dalam Project settings > General. Tetapan thread dan penyelaras diubah secara berasingan; dokumentasi menerangkan pilihan yang lebih menjimatkan.

Memori projek disimpan sebagai fail biasa, dengan fail indeks bernama MEMORY.md. Setiap thread baharu membacanya semasa permulaan dan mengakses fail lain apabila diperlukan. Penemuan daripada satu thread yang disimpan dalam memori tersedia kepada thread seterusnya tanpa perlu diceritakan semula.

Perkara yang perlu dilakukan jika thread mengubah kod yang sama#

Setiap thread bekerja pada cabangnya sendiri dan membuka permintaan tarik sendiri jika kerja itu memerlukannya. Namun, penyelaras tidak menjamin tugasan tidak akan bertindih: jika beberapa thread akhirnya bekerja pada bahagian kod yang sama, anda boleh meminta thread berkenaan menyelesaikan konflik melalui antara muka. Terdapat butang Resolve conflicts di sebelah permintaan tariknya; butang itu menghantar arahan kepada thread sebagai mesej daripada anda.

Dokumentasi rasmi mencadangkan supaya anda menyatakan keutamaan tentang bilangan thread dalam arahan projek: contohnya, minta penyelaras melancarkan tidak lebih daripada dua thread pada satu masa atau menggunakan semula thread sedia ada untuk tugasan baharu dalam bahagian yang sama. Ini ialah keutamaan yang cuba dipatuhi oleh penyelaras, bukannya had tetap. Dengan sendirinya, hal ini tidak menjamin thread tidak akan bertembung dalam fail yang sama — konflik yang sudah wujud mesti diselesaikan secara berasingan. Untuk tugasan berkaitan dalam bahagian yang sama, anda boleh menggunakan semula thread aktif atau tidak aktif. Jika thread tidak aktif selama lebih daripada sejam, thread itu membaca semula keseluruhan sejarah apabila menerima mesej baharu, dan ini menjejaskan penggunaan kuota langganan.

Semakin jelas tugasan diasingkan mengikut fail atau modul, semakin mudah kerja dijalankan secara selari. Artikel berasingan membincangkan cara membahagikan tugasan besar kepada bahagian bebas: cara mengagihkan kerja pengaturcaraan kepada ribuan ejen. Skalanya berbeza, tetapi prinsip membahagikan kerja adalah sama.

Selagi cache perbualan masih aktif (pada pelan Pro dan Max, dalam tempoh sejam, jika had pelan anda membenarkannya), thread menggunakan lebih sedikit token daripada kuota langganan untuk memproses semula sejarahnya. Selepas cache tamat tempoh, thread membaca semula keseluruhan sejarah apabila menerima mesej baharu sebelum memulakan kerja. Untuk tugasan bebas yang baharu, mungkin lebih menjimatkan jika anda meminta penyelaras membuat thread baharu: tindakan ini boleh menggunakan lebih sedikit token daripada kuota langganan yang sama berbanding meneruskan sesi lama dengan sejarah yang panjang selepas cachenya tamat tempoh.

Batasan beta yang wajar diketahui terlebih dahulu#

Sebelum membuat projek untuk tugasan penting, semak batasan beta:

• Hanya tersedia pada Pro dan Max. Team dan Enterprise belum disokong.
• Had 200 thread baharu sehari bagi setiap akaun, merentas semua projek secara keseluruhan.
• Projek milik seorang pengguna. Anda tidak boleh berkongsi akses kepada projek atau thread tertentu dengan orang lain, dan beta ini tidak mempunyai tetapan organisasi untuk pasukan.
• Akses hanya melalui claude.ai/code, aplikasi desktop dan aplikasi mudah alih. Projects tidak berfungsi dalam CLI terminal, melalui Amazon Bedrock, Google Cloud Agent Platform atau Microsoft Foundry.
• Projek tidak dapat melihat fail dan alat setempat. Thread berfungsi dengan repositori GitHub, fail yang dimuat naik dan folder Google Drive, tetapi bukan dengan perkara yang hanya wujud pada mesin anda.

Jika anda memerlukan akses terminal atau akses kepada alat yang hanya tersedia pada mesin anda, gunakan sesi setempat atau paparan ejen untuk beberapa sesi sedemikian. Jika beberapa orang perlu bekerjasama dalam satu ruang kerja, Anthropic mempunyai produk berasingan untuk pasukan pada Team dan Enterprise: Claude Tag. Produk ini berada dalam saluran Slack; mana-mana ahli boleh memberikan tugasan kepada Claude, dan semua orang dalam saluran boleh melihat serta mengarahkan kerja itu. Projek berfungsi secara berbeza: projek hanya milik anda. Jika anda hanya memerlukan fail setempat tertentu, anda boleh memuat naiknya ke projek supaya setiap thread boleh mengaksesnya. Ini tidak memberikan akses kepada alat setempat.

Langkah seterusnya#

Sebelum memindahkan aliran kerja anda ke Projects, cuba buat satu projek ujian pada repositori yang tidak kritikal: sambungkan GitHub App, tulis arahan ringkas, berikan satu tugasan bebas kepada penyelaras dan lihat cara penyelaras mengendalikannya. Percubaan pertama ini akan menunjukkan sama ada anda memahami antara muka penyelaras dan thread. Percubaan ini tidak menguji kerja selari, konflik atau penggunaan kuota merentas beberapa tugasan — semua itu perlu diuji secara berasingan.