Konfigurasi lingkungan cloud

Konfigurasi lingkungan cloud untuk sesi Claude Code cloud: tingkat akses jaringan, variabel lingkungan, skrip setup, dan caching lingkungan.

Setiap sesi cloud berjalan di lingkungan cloud. Anda dapat mengonfigurasi lingkungan untuk mengizinkan atau menolak akses jaringan, menetapkan variabel lingkungan untuk sesi, pada paket Pro dan Max menyimpan kredensial API yang digunakan sesi tanpa melihatnya, dan menjalankan skrip setup sebelum Claude mulai bekerja.

Lingkungan yang sama berlaku di mana pun Anda memulai sesi cloud: aplikasi Desktop, aplikasi mobile Claude, browser Anda di claude.ai/code, terminal dengan claude --cloud, routines, dan Claude Tag. Setiap permukaan ini juga dapat mengarahkan ke lingkungan yang di-host sendiri. Ketersediaan dan batasan mencakup apa yang Claude belum dapat gunakan ketika sesi Claude Tag berjalan di dalamnya.

Lingkungan Default

Jika Anda belum memiliki lingkungan, onboarding menyiapkan lingkungan Default. Caranya tergantung di mana Anda melakukan onboarding:

• Alur CLI seperti /web-setup: membuat Default untuk Anda
• Onboarding web pada Pro dan Max: membuat Default untuk Anda
• Onboarding web pada Team dan Enterprise: menampilkan formulir Buat lingkungan cloud pertama Anda kecuali Owner telah mengaktifkan Pengaturan web cepat; pertahankan default formulir dan klik Buat & selesai untuk mendapatkan lingkungan Default yang sama

Default tidak membawa konfigurasi apa pun:

• Akses jaringan Trusted: sesi menjangkau registri paket dan domain yang diizinkan lainnya, dan tidak ada yang lain melalui jaringan sesi.
• Tidak ada konfigurasi lain: Default tidak mendefinisikan variabel lingkungan atau skrip setup, jadi sesi dimulai dengan hanya alat yang sudah diinstal sebelumnya.

Dengan hanya Default yang tersedia, setiap sesi berjalan di dalamnya. Ketika Anda memiliki lebih dari satu lingkungan, sesi memilih satu per permukaan:

• Di aplikasi Desktop, aplikasi mobile, dan di claude.ai/code, sesi yang Anda mulai sendiri menggunakan lingkungan yang ditampilkan di pemilih. Default organisasi yang ditetapkan Owner mengisi pilihan ketika Anda belum memilih satu. Thread dalam proyek menggunakan lingkungan yang ditetapkan dalam pengaturan proyek sebagai gantinya.
• Dari CLI, Claude Code menggunakan pilihan /remote-env Anda, atau kembali ke lingkungan yang di-host Anthropic ketika daftar Anda memiliki satu, dan sebaliknya ke lingkungan pertama dalam daftar Anda yang bukan lingkungan bridge, entri Remote Control mendaftarkan untuk mewakili mesin Anda sendiri daripada lingkungan cloud. Untuk lingkungan yang di-host sendiri, melewatkan --environment <environment-id> dengan ID ccpool_ miliknya ketika Anda mengirim sesi menimpa pilihan /remote-env dan fallback untuk invokasi itu. Claude Code menolak ID env_ yang di-host Anthropic yang dilewatkan ke flag, jadi gunakan /remote-env untuk menargetkan yang tersebut. Flag memerlukan Claude Code v2.1.224 atau lebih baru.

Konfigurasi lingkungan ketika default tidak cukup: ketika Claude perlu menjangkau domain di luar daftar allowlist default, memerlukan variabel lingkungan yang ditetapkan untuk sesinya, atau memerlukan dependensi yang diinstal sebelum mulai bekerja.

Konfigurasi lingkungan Anda

Buat, edit, dan arsipkan lingkungan dari pemilih lingkungan, yang Anda jangkau di claude.ai/code setelah onboarding web, atau dari kotak prompt di aplikasi Desktop. Lingkungan yang Anda buat bersifat pribadi untuk akun Anda; lingkungan bersama yang dibuat oleh Owner muncul di pemilih yang sama. Lihat Alat yang diinstal untuk melihat apa yang tersedia tanpa konfigurasi apa pun.

1

Buka pemilih lingkungan

Di claude.ai/code, pilih ikon cloud yang menampilkan nama lingkungan saat ini, di baris di atas kotak pesan. Tidak ada halaman pengaturan atau URL langsung untuk pemilih.

2

Tambahkan atau edit lingkungan

Pilih Add cloud environment, atau arahkan ke lingkungan yang ada dan pilih ikon pengaturan yang muncul di sebelah kanan. Dialog mencakup nama, tingkat akses jaringan, variabel lingkungan, dan skrip setup. Ketika Anda mengedit lingkungan cloud yang ada pada paket Pro atau Max, dialog juga mencakup kredensial API.

Tetapkan variabel lingkungan

Variabel lingkungan menggunakan format .env, satu pasangan KEY=value per baris. Nilai biasa tidak memerlukan tanda kutip, dan jika Anda mengutip nilai dengan pasangan yang cocok, tanda kutip tidak menjadi bagian dari nilai. Kutip nilai yang mencakup beberapa baris atau berisi #: dalam nilai yang tidak dikutip, # memulai komentar dan sisa baris dijatuhkan.

Contoh berikut mendefinisikan tiga variabel.

NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

Setiap sesi menyalin nilai lingkungan sekali, saat startup, ke dalam variabel lingkungan biasa yang dapat dibaca oleh perintah apa pun yang dijalankan Claude. Karena sesi yang berjalan tidak membaca ulang konfigurasi, mengedit atau menambahkan variabel mempengaruhi sesi yang Anda mulai setelahnya; sesi yang sudah berjalan menyimpan nilai yang mereka mulai.

Sesi cloud juga menetapkan beberapa variabel sendiri ketika memulai. Untuk CLAUDE_AUTOCOMPACT_PCT_OVERRIDE, nilai yang ditetapkan sesi menimpa nilai yang Anda tambahkan di sini, jadi menambahkan kunci itu di sini tidak berpengaruh.

Siapa pun yang menggunakan lingkungan dapat membaca nilai. Pada paket Pro dan Max, gunakan kredensial API sebagai gantinya untuk kunci yang dapat dilampirkan proxy agen. Permintaan yang tidak pernah mendapatkan kredensial tercantum di sana.

Tambahkan kredensial API

Kredensial API adalah kunci API atau token yang Anda simpan di lingkungan cloud sehingga Claude dapat memanggil API itu dari sesi apa pun di lingkungan tanpa melihat kunci. Proxy agen Anthropic menambahkan kunci ke permintaan untuk host yang Anda cantumkan, setelah setiap permintaan meninggalkan VM sesi. Kunci tidak pernah mencapai Claude, perintah yang dijalankannya, atau variabel lingkungan sesi.

Kredensial API tersedia pada paket Pro dan Max. Mereka tidak tersedia pada paket Team atau Enterprise namun, jadi bagian API credentials tidak muncul di dialog lingkungan pada paket tersebut.

Persyaratan

Dua dari ini memutuskan apakah Anda dapat menambahkan kredensial, dan dua memutuskan apakah proxy agen dapat menggunakannya setelah ditambahkan:

• Peran: peran admin organisasi di organisasi claude.ai Anda
  • Pada Team dan Enterprise, Owner memegangnya dan Admin tidak
  • Pada Pro dan Max, Anda memegangnya di organisasi Anda sendiri
  • Tanpa itu, Anda melihat catatan alih-alih daftar kredensial, bahkan di lingkungan Anda sendiri. Minta Owner menambahkan kredensial ke lingkungan bersama dan jalankan sesi Anda di sana
• Jenis lingkungan: lingkungan cloud yang di-host Anthropic yang sudah ada. Lingkungan yang di-host sendiri tidak memiliki kredensial API
• Jangkauan API: API menerima koneksi dari internet, karena permintaan meninggalkan dari jaringan Anthropic
• Kunci enkripsi: jika organisasi Anda menggunakan kunci enkripsi yang dikelola pelanggan, Anda tidak dapat menyimpan kredensial

Tambahkan kredensial

Anda menambahkan kredensial satu per satu dari editor lingkungan yang sudah ada. Dialog untuk lingkungan baru tidak menawarkannya. Tidak ada edit juga. Untuk mengubah host atau nilai kredensial, hapus dan tambahkan lagi.

Untuk mengonfirmasi kredensial berfungsi, mulai sesi di lingkungan dan minta Claude memanggil API, misalnya dengan curl. API menjawab seolah-olah kunci ada dalam permintaan, dan kunci tidak muncul di variabel lingkungan sesi atau di file apa pun. Jika daftar menandai kredensial Not sent sebagai gantinya, catatan di bawahnya mengatakan mengapa dan apa yang harus dilakukan. Dua kredensial yang hostnya tumpang tindih tanpa cocok persis tidak mendapat penanda, dan proxy agen mengirim hanya satu dari mereka.

Permintaan mana yang mendapatkan kredensial

Proxy agen melampirkan kredensial ke permintaan ketika host permintaan cocok dengan salah satu yang Anda cantumkan pada kredensial itu. Sesi dapat menjangkau host tersebut bahkan ketika tingkat akses jaringan lingkungan tidak akan mengizinkannya, kecuali host yang tidak pernah mendapatkan kredensial. Kredensial berlaku di setiap sesi yang berjalan di lingkungan, siapa pun yang memulainya, sampai Anda menghapusnya.

Permintaan yang tidak pernah mendapatkan kredensial

Proxy agen tidak pernah melampirkan kredensial yang Anda tambahkan ke permintaan ini:

• GitHub: proxy GitHub mengautentikasi permintaan ke GitHub sebagai gantinya, jadi Anda tidak memerlukan kredensial API untuk itu
• API Anthropic dan registri paket publik: api.anthropic.com, registry.npmjs.org, jsr.io, npm.jsr.io, pypi.org, files.pythonhosted.org, index.crates.io, dan proxy.golang.org
• Permintaan skrip setup: Claude Code terhubung ke proxy agen ketika diluncurkan, setelah skrip setup telah berjalan

Pilih lingkungan dari CLI

Jalankan /remote-env di terminal Anda untuk memilih lingkungan default untuk sesi cloud yang Anda buat dari CLI, seperti claude --cloud. Perintah membuka pemilih lingkungan yang ada dan menyimpan pilihan Anda ke kunci remote.defaultEnvironmentId di pengaturan pengguna Anda, sehingga berlaku di setiap proyek di mesin Anda sampai Anda mengubahnya, kecuali kunci yang sama ditetapkan di lapisan pengaturan dengan prioritas lebih tinggi, seperti pengaturan proyek repo.

ID lingkungan yang di-host sendiri, yang memiliki bentuk ccpool_..., mengikuti aturan sumber yang lebih ketat. Lihat remote.defaultEnvironmentId untuk lapisan pengaturan yang dihormati Claude Code darinya.

/remote-env hanya menetapkan default: tidak memulai sesi, dan tidak dapat menambah atau mengedit lingkungan. Kelola mereka dari pemilih lingkungan.

Arsipkan lingkungan

Untuk mengarsipkan salah satu lingkungan Anda sendiri, buka untuk diedit dan pilih Archive. Owner mengarsipkan lingkungan bersama dari halaman Cloud environments di pengaturan admin. Anda tidak dapat menghapus lingkungan, hanya mengarsipkannya.

Pengarsipan mempengaruhi sesi baru, bukan yang sedang berjalan:

• Sesi yang sudah berjalan di lingkungan terus bekerja.
• Lingkungan menghilang dari pemilih dan dari /remote-env, jadi Anda tidak dapat memilihnya untuk sesi baru.
• Kredensial API di lingkungan tetap terlampir di sesinya yang berjalan. Hapus yang tidak lagi Anda inginkan sebelum mengarsipkan.
• Tidak ada sesi baru yang dapat dimulai di lingkungan yang diarsipkan, di permukaan apa pun. Jika lingkungan adalah default CLI yang disimpan, Claude Code memulai sesi cloud CLI di lingkungan yang di-host Anthropic ketika daftar Anda memiliki satu, dan sebaliknya di lingkungan pertama dalam daftar Anda yang bukan lingkungan bridge Remote Control. Apa pun yang dikonfigurasi dengan lingkungan secara eksplisit, seperti routine, tidak dapat memulai sesi baru di dalamnya. Arahkan ke lingkungan lain.

Lingkungan bersama organisasi

Pada paket Team dan Enterprise, Owner dapat membuat lingkungan cloud yang dibagikan dengan setiap anggota organisasi. Peran yang sama mengelola segalanya di halaman admin Cloud environments, termasuk lingkungan yang di-host sendiri; peran Admin tidak dapat membuka halaman. Daftar lengkap peran yang dapat membukanya adalah yang untuk mengelola pengaturan yang dikelola server.

Lingkungan bersama muncul di pemilih lingkungan setiap anggota di bawah judul Organization, setelah lingkungan pribadi anggota di bawah Personal, sehingga tim dapat menstandarkan satu konfigurasi alih-alih setiap anggota membuat ulangnya. Memilih ikon pengaturan lingkungan bersama di sana membuka ringkasan konfigurasinya yang hanya dapat dibaca untuk setiap anggota, termasuk Owner.

Owner membuat lingkungan tersedia untuk organisasi dengan salah satu dari dua cara:

• Buat lingkungan bersama: gunakan halaman Cloud environments di pengaturan admin, yang juga merupakan tempat Owner mengedit dan mengarsipkan lingkungan bersama. Setiap lingkungan memiliki nama, tingkat akses jaringan, variabel lingkungan dalam format .env, dan skrip setup.
• Bagikan lingkungan pribadi: buka salah satu lingkungan Anda sendiri untuk diedit di pemilih lingkungan, kemudian bagikan dari baris Who can use it. Lingkungan menyimpan ID-nya, jadi sesi dan routine yang sudah menggunakannya tidak terpengaruh, dan setiap anggota kemudian dapat melihatnya dan memulai sesi di dalamnya.

Owner memilih lingkungan default organisasi secara terpisah, di claude.ai/admin-settings/claude-code.

Sesi setiap anggota di lingkungan bersama membaca variabelnya, jadi jangan sertakan rahasia di dalamnya. Kredensial API, yang memberikan sesi kunci yang tidak dapat dibacanya, tidak tersedia pada paket Team atau Enterprise namun.

Tetapkan lingkungan yang digunakan saluran Claude Tag

Di saluran Claude Tag, Claude bekerja sebagai identitas bersama organisasi Anda, bukan sebagai anggota apa pun, jadi sesi saluran menggunakan lingkungan tingkat organisasi saja, baik lingkungan bersama atau lingkungan yang di-host sendiri. Untuk memberikan saluran toolchain yang bukan sudah diinstal sebelumnya, seperti .NET, Owner dapat membuat lingkungan bersama dari halaman admin Cloud environments dengan skrip setup yang menginstalnya. Arahkan saluran ke lingkungan dengan salah satu dari dua cara:

• Tetapkan lingkungan bersama atau yang di-host sendiri sebagai lingkungan default organisasi di claude.ai/admin-settings/claude-code.
• Sematkan satu ke saluran di pengaturan admin Claude Tag.

Akses jaringan

Setiap lingkungan menetapkan satu tingkat akses jaringan, yang mengontrol koneksi keluar yang dapat dibuat sesinya. Tingkat default, Trusted, memungkinkan registri paket dan domain yang diizinkan lainnya; Custom mengambil daftar domain Anda sendiri.

Untuk mengubah akses jaringan lingkungan, buka untuk diedit dan gunakan pemilih Network access di dialog. Lingkungan bersama membuka read-only di sana, jadi Owner mengubah akses jaringannya dari halaman Cloud environments di pengaturan admin sebagai gantinya. Ikon cloud yang membuka pemilih muncul di permukaan aplikasi yang tercantum di bawah Lingkungan Default dan di editor routine; lingkungan pribadi tidak memiliki halaman terpisah di pengaturan akun claude.ai Anda.

Tingkat akses

Bidang Network access di dialog lingkungan mengambil salah satu dari empat tingkat:

Apa pun tingkat yang Anda pilih, sesi masih dapat menjangkau ini, karena masing-masing mengambil jalur yang tidak melewati allowlist jaringan sesi:

• GitHub, melalui proxy terpisahnya
• Konektor MCP yang Anda aktifkan, yang lalu lintasnya berjalan melalui server Anthropic
• Host yang Anda cantumkan di kredensial API lingkungan, kecuali host yang tidak pernah mendapatkan kredensial
• API Anthropic, untuk permintaan Claude Code sendiri, bahkan di None, seperti yang dicatat di bawah Security and isolation

Izinkan domain tertentu

Untuk mengizinkan domain yang tidak ada dalam daftar Trusted, pilih Custom di pengaturan akses jaringan lingkungan, kemudian cantumkan satu domain per baris di bidang Allowed domains. Contoh ini memungkinkan tiga host yang mungkin dibutuhkan proyek internal.

api.example.com
*.internal.example.com
registry.example.com

Sesi di lingkungan ini sekarang dapat menjangkau api.example.com, subdomain apa pun dari internal.example.com, dan registry.example.com, dan tidak ada domain lain melalui jaringan sesi. Lalu lintas GitHub, lalu lintas konektor MCP, dan permintaan ke host kredensial API lingkungan, selain host yang tidak pernah mendapatkan kredensial, tidak melewati allowlist ini. *. di depan cocok dengan setiap subdomain. Untuk menyimpan domain Trusted juga, centang Also include default list of common package managers; biarkan tidak dicentang untuk hanya mengizinkan apa yang Anda cantumkan.

Jika organisasi Anda menggunakan artifacts, Anda tidak memerlukan *.frame.claudeusercontent.com dalam daftar untuk sesi membacanya. Ketika daftar meninggalkan host itu, Claude Code membaca konten artifact melalui koneksi sesi ke Anthropic sebagai gantinya. Pertahankan host dalam allowlist dalam dua situasi:

• Sesi di lingkungan ini membuka artifact publik organisasi lain: Claude Code mengambil yang dari host secara langsung, jadi tambahkan ke daftar ini.
• Anda mengonfigurasi CLI lokal atau runner yang di-host sendiri: pertahankan host dalam allowlist itu. Lihat persyaratan akses jaringan dan persyaratan jaringan yang di-host sendiri.

Setiap lingkungan memiliki daftar domain yang diizinkan sendiri; tidak ada allowlist tingkat organisasi yang dapat didorong admin ke lingkungan setiap anggota. Pengaturan yang dikelola server masih berlaku di dalam sesi cloud, tetapi tidak ada yang menambahkan domain ke allowlist jaringan lingkungan. Untuk memberikan tim satu daftar standar, Owner dapat membuat lingkungan bersama organisasi dengan akses jaringan Custom dan daftar itu.

Proxy GitHub

Di lingkungan yang di-host Anthropic, semua operasi GitHub melewati proxy khusus yang menjaga kredensial GitHub nyata Anda di luar VM sesi, independen dari tingkat akses lingkungan. Sesi di lingkungan yang di-host sendiri mengautentikasi operasi git dengan kredensial yang disediakan deployment Anda; Konfigurasi git mencakup opsi, termasuk kredensial yang dicetak per sesi dan opt-in ke proxy yang sama ini. Proxy menyediakan:

• Kredensial Git: klien git di dalam VM menggunakan kredensial yang dibatasi, yang diverifikasi proxy dan ditukar dengan token GitHub aktual Anda.
• Permintaan API: permintaan dari alat GitHub bawaan, dan dari gh di bawah placeholder proxy-injected, keluar dengan kredensial nyata Anda diganti.
• Push protection: git push hanya bekerja terhadap cabang kerja saat ini sesi; kloning, pengambilan, dan operasi PR bekerja secara normal.
• Cakupan repositori: API GitHub dan permintaan aset rilis hanya menjangkau repositori yang terlampir pada sesi, jadi skrip setup yang mengunduh aset rilis dari repositori yang tidak terlampir mendapat 403.
• Pembatasan GraphQL: proxy melayani hanya set operasi GraphQL yang disematkan untuk alur kerja pull-request. Proxy menolak segalanya di endpoint GraphQL dengan 403 yang mengatakan This GraphQL query is not enabled for this session dan menyebutkan fallback REST, gh api repos/{owner}/{repo}/.... Pembatasan berlaku untuk setiap permintaan melalui proxy terlepas dari kredensial yang Anda berikan, jadi GH_TOKEN yang Anda tetapkan mendapat 403 yang sama. Claude tidak dapat menjangkau API GitHub yang hanya ada di GraphQL, seperti Projects v2, melalui proxy.

File yang berkomitmen dari repositori publik tiba melalui raw.githubusercontent.com, yang ditangani proxy keamanan sebagai gantinya. Domain itu ada dalam daftar Trusted default, jadi file tersebut tetap dapat dijangkau kecuali tingkat akses lingkungan mengecualikannya.

Proxy keamanan

Sesi cloud di lingkungan yang di-host Anthropic berjalan di belakang proxy jaringan HTTP/HTTPS untuk tujuan keamanan dan pencegahan penyalahgunaan; di lingkungan yang di-host sendiri, lalu lintas keluar meninggalkan melalui batas jaringan Anda sendiri sebagai gantinya. Semua lalu lintas internet keluar dari sesi yang di-host Anthropic melewati proxy ini, yang menyediakan:

• Perlindungan terhadap permintaan berbahaya
• Pembatasan laju dan pencegahan penyalahgunaan
• Penyaringan konten untuk keamanan yang ditingkatkan
• Jejak audit tingkat DNS dari nama host yang diminta

Apa yang tersedia di sesi cloud

Di lingkungan yang di-host Anthropic, setiap sesi mendapat mesin virtual (VM) segar yang menjalankan Ubuntu 24.04 pada x86_64, terlepas dari sistem operasi dan arsitektur CPU Anda sendiri, dengan repositori Anda yang dikloning dan toolchain umum yang sudah diinstal sebelumnya. Ketika dependensi menyediakan binari yang sudah dikompilasi, seperti gem Ruby dengan ekstensi asli atau wheel Python yang sudah dibangun, gunakan build Linux x86_64 untuk mencocokkan VM. Bagian ini mencakup default yang di-host Anthropic, alat GitHub bawaan, cara menjalankan tes dan layanan, dan batas sumber daya yang diterima setiap VM.

Apa yang terbawa dari setup Anda

Cloud sessions start from a fresh clone of your repository. Apa pun yang Anda komitkan ke repo tersedia. Apa pun yang Anda instal atau konfigurasi hanya di mesin Anda sendiri tidak tersedia di sesi. Kebijakan organisasi Anda tiba secara terpisah melalui pengaturan yang dikelola server.

Untuk membuat konfigurasi Anda sendiri tersedia di sesi cloud, komitkan ke repo.

Siapa pun yang menggunakan lingkungan dapat membaca variabel lingkungan dan skrip setupnya. Catatan dialog di bawah Environment variables mengatakan demikian dan memperingatkan terhadap penambahan rahasia di sana. Pada paket Pro dan Max, simpan kunci yang dapat dilampirkan proxy agen sebagai kredensial API sebagai gantinya.

Alat yang diinstal

Sesi cloud dilengkapi dengan runtime bahasa umum, alat build, dan database yang sudah diinstal sebelumnya. Tabel di bawah merangkum apa yang disertakan menurut kategori.

¹ Bun diinstal tetapi memiliki masalah kompatibilitas proxy yang diketahui untuk pengambilan paket.

Untuk mendapatkan versi sebagian besar alat dalam tabel ini, minta Claude menjalankan check-tools di sesi cloud. Ini adalah perintah shell yang diinstal di VM sesi, bukan perintah yang Anda ketik dengan /; Anda meminta Claude karena Claude menjalankan semua perintah VM untuk Anda. Untuk alat yang tidak dilaporkannya, seperti Ruby, PHP, bun, PostgreSQL, atau Redis, minta Claude menjalankan perintah versi alat itu sendiri, misalnya psql --version.

Versi Node.js diinstal di /opt/node20, /opt/node21, dan /opt/node22, dengan 22 di PATH secara default. Untuk bekerja dengan versi berbeda, minta Claude menambahkan direktori bin versi itu, seperti /opt/node20/bin, ke PATH.

Toolchain di luar daftar ini, seperti .NET SDK, tidak diinstal sebelumnya bahkan ketika registri paket mereka ada di allowlist default. Instal mereka dengan skrip setup.

Bekerja dengan masalah GitHub dan permintaan tarik

Sesi cloud mencakup alat GitHub bawaan yang memungkinkan Claude membaca masalah, mencantumkan permintaan tarik, mengambil diff, dan memposting komentar tanpa setup apa pun. Alat ini mengautentikasi melalui proxy GitHub menggunakan metode apa pun yang Anda konfigurasi di bawah opsi autentikasi GitHub, jadi token Anda tidak pernah memasuki kontainer.

Anda dapat menetapkan GH_TOKEN atau GITHUB_TOKEN sendiri di pengaturan lingkungan, atau biarkan keduanya tidak ditetapkan dan biarkan proxy GitHub mengautentikasi untuk Anda:

• Jika Anda menetapkan token, itu melewati ke kontainer tanpa perubahan, jadi skrip Anda dan gh CLI GitHub menggunakannya secara langsung.
• Jika Anda tidak menetapkan keduanya dan proxy GitHub menangani autentikasi untuk sesi Anda, kedua variabel membaca sebagai string placeholder proxy-injected dalam perintah yang dijalankan Claude, dan proxy mengganti kredensial nyata Anda pada permintaan GitHub keluar. gh bekerja tanpa token Anda sendiri, tetapi skrip yang membaca GITHUB_TOKEN secara langsung mendapat placeholder, bukan token yang dapat digunakan.

Token yang Anda tetapkan adalah variabel lingkungan biasa, jadi siapa pun yang menggunakan lingkungan dapat membacanya; jalur proxy menjaga kredensial di luar konfigurasi lingkungan dan VM sesi.

Untuk memeriksa kasus mana yang berlaku untuk sesi Anda, minta Claude menjalankan echo $GH_TOKEN.

gh CLI GitHub sudah diinstal sebelumnya. Jika Anda memerlukan perintah gh yang tidak dicakup alat bawaan, seperti gh release atau gh workflow run, minta Claude menjalankannya. gh membaca GH_TOKEN secara otomatis, jadi Anda tidak perlu menjalankan gh auth login.

Hubungkan output kembali ke sesi

Setiap sesi cloud memiliki URL transkrip di claude.ai, dan sesi dapat membaca ID-nya sendiri dari variabel lingkungan CLAUDE_CODE_REMOTE_SESSION_ID. Gunakan ini untuk menempatkan tautan yang dapat dilacak di badan PR, pesan komitmen, posting Slack, atau laporan yang dihasilkan sehingga reviewer dapat membuka jalankan yang menghasilkannya.

Komitmen yang dibuat Claude di sesi cloud mencakup trailer git Claude-Session: <url>, dan badan PR mencakup URL sesi di barisnya sendiri. Untuk menghilangkan trailer dan tautan badan PR, atur attribution.sessionUrl ke false.

Untuk menyertakan tautan sesi dalam sesuatu selain komitmen atau PR, seperti pesan Slack yang diposting Claude atau file laporan yang ditulisnya, minta Claude menjalankan perintah berikut dan gunakan outputnya. Perintah mengonversi awalan cse_ dalam nilai variabel lingkungan ke awalan session_ yang diharapkan URL transkrip:

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

Jalankan tes, mulai layanan, dan tambahkan paket

Anda tidak mendapatkan shell ke VM sesi. Claude menjalankan setiap perintah untuk Anda, jadi frasekan tugas di bagian ini sebagai permintaan dalam prompt Anda.

Jalankan tes

Claude menjalankan tes sebagai bagian dari mengerjakan tugas. Minta dalam prompt Anda, seperti "perbaiki tes yang gagal di tests/" atau "jalankan pytest setelah setiap perubahan." Pelari tes yang datang dengan toolchain yang sudah diinstal sebelumnya, seperti pytest dan cargo test, bekerja tanpa setup tambahan. Pelari yang dideklarasikan proyek Anda sebagai dependensi, seperti jest, diinstal dengan dependensi Anda.

Mulai layanan

PostgreSQL dan Redis sudah diinstal tetapi tidak berjalan secara default. Minta Claude untuk memulai yang Anda butuhkan; perintah yang dijalankannya adalah:

service postgresql start

service redis-server start

Docker tersedia untuk menjalankan layanan yang dikontainerisasi. Minta Claude menjalankan docker compose up untuk memulai layanan proyek Anda. Akses jaringan untuk menarik gambar mengikuti tingkat akses lingkungan Anda, dan default Trusted mencakup Docker Hub dan registri umum lainnya.

Jika gambar Anda besar atau lambat ditarik, tambahkan docker compose pull atau docker compose build ke skrip setup Anda. Cache lingkungan menyimpan gambar yang ditarik, jadi setiap sesi baru memilikinya di disk. Cache menyimpan file saja, bukan proses yang berjalan, jadi Claude masih memulai kontainer setiap sesi.

Tambahkan paket

Untuk menambahkan paket yang tidak diinstal sebelumnya, gunakan skrip setup. Cache lingkungan menyimpan apa yang diinstal skrip, jadi paket yang Anda instal di sana tersedia di awal setiap sesi tanpa menginstal ulang setiap kali. Anda juga dapat meminta Claude menginstal paket di tengah sesi, tetapi instalasi tersebut tidak terbawa ke sesi lain.

Batas sumber daya

Sesi cloud di lingkungan yang di-host Anthropic berjalan dengan batas sumber daya perkiraan yang mungkin berubah seiring waktu:

• 4 vCPU
• 16 GB RAM
• 30 GB disk

VM mungkin menghentikan tugas yang memerlukan memori jauh lebih banyak, seperti pekerjaan build besar atau tes yang memakan memori. Untuk beban kerja di luar batas ini, gunakan Remote Control untuk menjalankan Claude Code di perangkat keras Anda sendiri, atau jalankan sesi cloud di lingkungan yang di-host sendiri pada komputasi yang dioperasikan organisasi Anda.

Skrip setup

Skrip setup adalah skrip Bash yang berjalan ketika sesi cloud baru dimulai, sebelum Claude Code diluncurkan. Gunakan skrip setup untuk menginstal dependensi, mengonfigurasi alat, atau mengambil apa pun yang dibutuhkan sesi yang tidak diinstal sebelumnya.

Skrip berjalan sebagai root di Ubuntu 24.04, jadi apt install dan sebagian besar manajer paket bahasa bekerja.

Untuk menambahkan skrip setup, buka dialog pengaturan lingkungan dan masukkan skrip Anda di bidang Setup script.

Contoh ini menginstal ShellCheck, yang tidak diinstal sebelumnya.

#!/bin/bash
apt update && apt install -y shellcheck

Persyaratan skrip

Skrip setup memiliki tiga batasan untuk ditulis:

• Exit zero: jika skrip keluar non-zero, sesi gagal dimulai. Tambahkan || true ke perintah non-kritis sehingga kegagalan instalasi sesekali tidak memblokir sesi.
• Selesai dalam lima menit: jaga runtime total skrip di bawah kira-kira lima menit sehingga cache lingkungan dapat dibangun. Jalankan instalasi independen secara paralel dengan & dan wait, dan pindahkan unduhan tunggal apa pun yang tidak cocok ke hook SessionStart yang meluncurkannya di latar belakang.
• Akses jaringan untuk instalasi: instalasi paket perlu menjangkau registri. Tingkat Trusted default mencakup registri paket umum termasuk npm, PyPI, RubyGems, dan crates.io; dengan akses jaringan None, instalasi gagal.

Caching lingkungan

Skrip setup berjalan pertama kali Anda memulai sesi di lingkungan. Setelah selesai, Anthropic membuat snapshot sistem file dan menggunakan kembali snapshot itu sebagai titik awal untuk sesi nanti. Sesi baru dimulai dengan dependensi, alat, dan gambar Docker Anda sudah di disk, dan melewati langkah skrip setup. Ini menjaga startup cepat bahkan ketika skrip menginstal toolchain besar atau menarik gambar kontainer.

Cache adalah snapshot sistem file, jadi menyimpan apa yang ditulis skrip setup ke disk dan kehilangan apa pun yang hanya berjalan. Paket yang Anda instal, gambar Docker yang Anda tarik, dan file yang Anda tulis semuanya terbawa. Database yang dimulai skrip, tumpukan docker compose up, atau proses latar belakang lainnya tidak; mulai mereka per sesi dengan meminta Claude atau dengan hook SessionStart.

Skrip setup berjalan lagi untuk membangun ulang cache ketika Anda mengubah skrip setup lingkungan atau host jaringan yang diizinkan, dan ketika cache mencapai kedaluwarsa setelah kira-kira tujuh hari. Melanjutkan sesi yang ada tidak pernah menjalankan kembali skrip setup.

Anda tidak perlu mengaktifkan caching atau mengelola snapshot sendiri.

Skrip setup vs. hook SessionStart

Gunakan skrip setup untuk menyediakan VM itu sendiri: toolchain dan alat CLI yang tidak diinstal sebelumnya. Gunakan hook SessionStart untuk setup proyek yang harus berjalan di mana-mana, cloud dan lokal, seperti npm install.

Skrip setup dan hook SessionStart berjalan dalam urutan tetap ketika sesi cloud dimulai. Tabel membandingkan di mana Anda mengonfigurasinya, kapan mereka berjalan, dan di mana mereka berjalan.

Jika Anda memiliki hook SessionStart di ~/.claude/settings.json tingkat pengguna, jangan harapkan mereka di cloud. Pengaturan tingkat pengguna tetap di mesin Anda. Hook mana yang berjalan tergantung di mana sesi berjalan:

• Lingkungan yang dihosting Anthropic: Claude Code menjalankan hook dari repositori dan dari pengaturan yang dikelola server organisasi Anda.
• Lingkungan yang dihosting sendiri: Claude Code juga menjalankan hook yang ditanam operator dari ~/.claude/ host runner, dan hook dalam file pengaturan yang dikelola gambar runner ketika file itu adalah salah satu dari sumber yang dikelola Claude Code terapkan.

Instal dependensi dengan hook SessionStart

Untuk menginstal dependensi hanya di sesi cloud, pasangkan hook SessionStart dengan skrip yang memeriksa di mana itu berjalan.

Pertama, tambahkan hook SessionStart ke .claude/settings.json repo Anda. Konfigurasi ini memberitahu Claude Code untuk menjalankan scripts/install_pkgs.sh dari repositori Anda setiap kali sesi dimulai atau dilanjutkan:

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

matcher membatasi hook ke acara startup dan resume, dan $CLAUDE_PROJECT_DIR diselesaikan ke akar repositori, jadi hook menemukan skrip terlepas dari direktori kerja sesi.

Selanjutnya, buat skrip di scripts/install_pkgs.sh. Itu keluar segera di luar cloud, kemudian menginstal dependensi Anda:

#!/bin/bash

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

npm install
pip install -r requirements.txt
exit 0

Pemeriksaan CLAUDE_CODE_REMOTE adalah apa yang membatasi instalasi ke sesi cloud: VM sesi membawa variabel itu sebagai true, tidak pernah true secara lokal, jadi di laptop Anda skrip keluar sebelum menginstal apa pun.

Bersama-sama, dua file memberikan setiap sesi cloud npm install dan pip install segar saat startup sambil meninggalkan sesi lokal tidak tersentuh.

Batasan di sesi cloud

Hook SessionStart berperilaku sama di cloud seperti secara lokal, dengan peringatan ini:

• Satu repositori per sesi: sesi dengan beberapa repositori tidak memuat hook dari .claude/settings.json repositori apa pun, jadi hook SessionStart yang Anda tentukan di sana tidak berjalan. Instal dependensi untuk sesi tersebut dengan skrip setup sebagai gantinya.
• Tidak ada scoping khusus cloud: hook berjalan di sesi lokal dan cloud. Untuk melewati eksekusi lokal, keluar lebih awal kecuali variabel lingkungan CLAUDE_CODE_REMOTE adalah true, cara yang ditunjukkan oleh skrip instalasi dependensi.
• Memerlukan akses jaringan: perintah instalasi perlu menjangkau registri paket. Jika lingkungan Anda menggunakan akses jaringan None, hook ini gagal. Allowlist default di bawah Trusted mencakup npm, PyPI, RubyGems, dan crates.io.
• Kompatibilitas proxy: di lingkungan yang dihosting Anthropic, semua lalu lintas keluar melewati proxy keamanan, dan beberapa manajer paket tidak bekerja dengan benar dengannya; Bun adalah contoh yang diketahui. Di lingkungan yang dihosting sendiri, lalu lintas keluar melewati batas jaringan Anda sendiri.
• Menambah latensi startup: hook berjalan setiap kali sesi dimulai atau dilanjutkan, tidak seperti skrip setup yang mendapat manfaat dari caching lingkungan. Jaga skrip instalasi cepat dengan memeriksa apakah dependensi sudah ada sebelum menginstal ulang.

Untuk menyesuaikan gambar dasar, gunakan skrip setup untuk menginstal apa yang Anda butuhkan di atas gambar yang disediakan, atau jalankan gambar Anda sendiri sebagai kontainer bersama Claude dengan docker compose. Mengganti gambar dasar sepenuhnya belum didukung.

Domain yang diizinkan default

Dengan akses jaringan Trusted, sesi dapat menjangkau domain berikut secara default. Domain yang ditandai dengan * menunjukkan pencocokan subdomain wildcard, jadi *.gcr.io memungkinkan subdomain apa pun dari gcr.io.

Sumber daya terkait

• Referensi sesi cloud: mulai, kelola, dan bagikan sesi cloud
• Quickstart sesi cloud: hubungkan GitHub dan mulai sesi cloud pertama Anda
• Claude Tag: sesi yang dimulai Claude dari Slack berjalan di lingkungan yang sama
• Routines: jalankan terjadwal menggunakan lingkungan dan tingkat akses jaringan yang sama
• Remote Control: jalankan sesi di jaringan dan file mesin Anda sendiri sebagai gantinya
• Lingkungan yang di-host sendiri: jalankan sesi cloud di infrastruktur organisasi Anda sendiri
• Hook SessionStart: setup yang berkomitmen repo yang berjalan di sesi lokal dan cloud
• Pengaturan yang dikelola server: kebijakan organisasi yang menjangkau sesi cloud