> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Konfigurasi lingkungan cloud > Konfigurasi lingkungan cloud untuk sesi Claude Code cloud: tingkat akses jaringan, variabel lingkungan, skrip setup, dan caching lingkungan. Lingkungan cloud memerlukan [Claude Code di web](/docs/id/claude-code-on-the-web), yang sedang dalam penelitian preview untuk pengguna Pro, Max, dan Team, serta untuk pengguna Enterprise dengan [kursi premium atau kursi Chat + Claude Code](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan). Setiap [sesi cloud](/docs/id/claude-code-on-the-web) berjalan di lingkungan cloud. Anda dapat mengonfigurasi lingkungan untuk mengizinkan atau menolak [akses jaringan](#access-levels), menetapkan variabel lingkungan untuk sesi, dan menjalankan [skrip setup](#setup-scripts) sebelum Claude mulai bekerja. Lingkungan yang sama berlaku di mana pun Anda memulai sesi cloud: [Claude Code di web](/docs/id/claude-code-on-the-web), terminal dengan [`claude --cloud`](/docs/id/claude-code-on-the-web#from-terminal-to-web), [Claude Tag](https://claude.com/docs/claude-tag/overview), [routines](/docs/id/routines), [aplikasi mobile Claude](/docs/id/mobile), dan [aplikasi Desktop](/docs/id/desktop). Sesi [Remote Control](/docs/id/remote-control) menghubungkan antarmuka web dan mobile ke sesi di mesin Anda sendiri, yang menggunakan jaringan dan file mesin Anda, bukan lingkungan cloud. Sesi saluran Claude Tag menggunakan [lingkungan bersama](#organization-shared-environments) saja.

Lingkungan Default

Onboarding menyiapkan lingkungan **Default** untuk Anda, baik Anda terhubung melalui [web](/docs/id/web-quickstart#connect-github-and-create-an-environment) atau alur CLI seperti `/web-setup`; jika onboarding web menampilkan formulir lingkungan alih-alih membuat lingkungan, pertahankan default formulir untuk mendapatkan lingkungan **Default** yang sama. **Default** tidak membawa konfigurasi apa pun: * [Akses jaringan **Trusted**](#access-levels): sesi menjangkau registri paket dan [domain yang diizinkan](#default-allowed-domains) 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](#installed-tools). Dengan hanya **Default** yang tersedia, setiap sesi berjalan di dalamnya. Ketika Anda memiliki lebih dari satu lingkungan, sesi memilih satu per permukaan: * Di web, aplikasi Desktop, dan aplikasi mobile, sesi menggunakan lingkungan yang ditampilkan di [pemilih](#configure-your-environment). [Default organisasi](#organization-shared-environments) yang ditetapkan admin mengisi pilihan ketika Anda belum memilih satu. * Dari CLI, sesi menggunakan pilihan [`/remote-env`](#select-an-environment-from-the-cli) Anda, atau kembali ke lingkungan cloud pertama yang tersedia. Konfigurasi lingkungan ketika default tidak cukup: ketika Claude perlu menjangkau domain di luar [daftar allowlist default](#default-allowed-domains), 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 di [claude.ai/code](https://claude.ai/code), yang Anda jangkau setelah [onboarding web](/docs/id/web-quickstart). Lingkungan yang Anda buat bersifat pribadi untuk akun Anda; [lingkungan bersama](#organization-shared-environments) yang dibuat oleh admin Anda muncul di pemilih yang sama. Lihat [Alat yang diinstal](#installed-tools) untuk melihat apa yang tersedia tanpa konfigurasi apa pun. Di [claude.ai/code](https://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. Pemilih lingkungan terbuka di atas kotak pesan di claude.ai/code. Tombol cloud yang menampilkan nama lingkungan Default duduk di baris di atas kotak pesan. Menu terbuka mencantumkan baris Local dengan label Download dan Desktop only, bagian Cloud di mana lingkungan Default dipilih dengan tanda centang dan menampilkan ikon roda gigi pengaturan saat hover, opsi Add cloud environment, dan bagian Remote Control dengan instruksi setup. 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. Dialog New cloud environment. Bidang Name dengan placeholder Default, pemilih Network access yang diatur ke Trusted dengan tautan ke kebijakan jaringan dan tingkat akses, kotak Environment variables yang menampilkan teks placeholder format .env dengan catatan bahwa nilai terlihat oleh siapa pun yang menggunakan lingkungan, kotak Setup script yang dijelaskan sebagai skrip Bash yang berjalan ketika sesi baru dimulai sebelum Claude Code diluncurkan, dan tombol Cancel dan Create environment.

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. ```text theme={null} 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. Siapa pun yang menggunakan lingkungan dapat membaca nilai, dan lingkungan cloud tidak memiliki penyimpanan rahasia khusus, jadi jangan tambahkan kunci API atau kredensial lainnya. Jika sesi memerlukan kredensial bagaimanapun, lihat [Apa yang terbawa dari setup Anda](#what-carries-over-from-your-setup).

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`](/docs/id/claude-code-on-the-web#from-terminal-to-web). Perintah membuka pemilih lingkungan yang ada dan menyimpan pilihan Anda ke kunci `remote.defaultEnvironmentId` di [pengaturan pengguna](/docs/id/settings#settings-files) Anda, sehingga berlaku di setiap proyek di mesin Anda sampai Anda mengubahnya, kecuali kunci yang sama ditetapkan di [lapisan pengaturan](/docs/id/settings#settings-precedence) dengan prioritas lebih tinggi, seperti pengaturan proyek repo. `/remote-env` hanya menetapkan default: tidak memulai sesi, dan tidak dapat menambah atau mengedit lingkungan. Kelola mereka di [claude.ai/code](https://claude.ai/code).

Arsipkan lingkungan

Untuk mengarsipkan lingkungan, buka untuk diedit dan pilih **Archive**. 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. * Tidak ada sesi baru yang dapat dimulai di lingkungan yang diarsipkan, di permukaan apa pun. Jika lingkungan adalah [default CLI](#select-an-environment-from-the-cli) yang disimpan, sesi cloud CLI kembali ke lingkungan cloud pertama yang tersedia. Apa pun yang dikonfigurasi dengan lingkungan secara eksplisit, seperti [routine](/docs/id/routines#environments-and-network-access), tidak dapat memulai sesi baru di dalamnya; arahkan ke lingkungan lain.

Lingkungan bersama organisasi

Pemilik dan admin pada paket Team dan Enterprise dapat membuat lingkungan cloud yang dibagikan dengan setiap anggota organisasi. Lingkungan bersama muncul di pemilih lingkungan setiap anggota bersama dengan yang pribadi, sehingga tim dapat menstandarkan satu konfigurasi alih-alih setiap anggota membuat ulangnya. Buat, edit, dan arsipkan lingkungan bersama dari halaman **Cloud environments** di [pengaturan admin](https://claude.ai/admin-settings). Setiap lingkungan bersama memiliki nama, [tingkat akses jaringan](#access-levels), [variabel lingkungan](#set-environment-variables) dalam format `.env`, dan [skrip setup](#setup-scripts). Pemilik dan admin memilih [lingkungan default](#the-default-environment) organisasi secara terpisah, di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code). Nilai dalam lingkungan bersama menjangkau sesi setiap anggota di lingkungan itu. Seperti lingkungan pribadi, lingkungan bersama tidak memiliki penyimpanan rahasia khusus, jadi jangan sertakan rahasia. Di saluran [Claude Tag](https://claude.com/docs/claude-tag/overview), Claude bekerja sebagai identitas bersama organisasi Anda, bukan sebagai anggota apa pun, jadi sesi saluran hanya menggunakan lingkungan bersama. Anda dapat menetapkan lingkungan yang digunakan saluran dengan dua cara: * Tetapkan lingkungan bersama sebagai [lingkungan default](#the-default-environment) organisasi di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code). * [Sematkan satu ke saluran](https://claude.com/docs/claude-tag/admins/troubleshooting#channel-sessions-use-the-wrong-environment-or-can%E2%80%99t-find-one) di pengaturan admin Claude Tag. Lingkungan bersama menambah pemilih anggota daripada menggantikannya.

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](#default-allowed-domains) lainnya; **Custom** mengambil daftar domain Anda sendiri. Untuk mengubah akses jaringan lingkungan, [buka untuk diedit](#configure-your-environment) dan gunakan pemilih **Network access** di dialog. Ikon cloud yang membuka pemilih muncul di permukaan aplikasi yang tercantum di bawah [Lingkungan Default](#the-default-environment) dan di [editor routine](/docs/id/routines#environments-and-network-access); lingkungan pribadi tidak memiliki halaman terpisah di pengaturan akun claude.ai Anda. Konektor MCP yang Anda aktifkan pada sesi atau routine bekerja tanpa menambahkan host mereka ke **Allowed domains**, karena lalu lintas konektor berjalan melalui server Anthropic daripada jaringan sesi. Anda mengonfigurasi konektor per sesi atau per routine; hapus yang tidak Anda butuhkan untuk membatasi alat mana yang dapat dijangkau Claude. Ini bergantung pada saluran yang terikat Anthropic yang sama yang dicatat di bawah [Security and isolation](/docs/id/claude-code-on-the-web#security-and-isolation).

Tingkat akses

Bidang **Network access** di [dialog lingkungan](#configure-your-environment) mengambil salah satu dari empat tingkat: | Tingkat | Koneksi keluar | | :---------- | :---------------------------------------------------------------------------------------- | | **None** | Tidak ada akses jaringan keluar melalui jaringan sesi | | **Trusted** | [Domain yang diizinkan](#default-allowed-domains) saja: registri paket, GitHub, cloud SDK | | **Full** | Domain apa pun | | **Custom** | Allowlist Anda sendiri, secara opsional termasuk default | Operasi GitHub menggunakan [proxy terpisah](#github-proxy) yang independen dari pengaturan ini, dan koneksi Claude Code ke API Anthropic masih berfungsi di **None**, seperti yang dicatat di bawah [Security and isolation](/docs/id/claude-code-on-the-web#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. ```text theme={null} 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](#github-proxy) dan [lalu lintas konektor MCP](#network-access) tidak melewati allowlist ini. `*.` di depan cocok dengan setiap subdomain. Untuk menyimpan [domain Trusted](#default-allowed-domains) juga, centang **Also include default list of common package managers**; biarkan tidak dicentang untuk hanya mengizinkan apa yang Anda cantumkan. 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](/docs/id/server-managed-settings) masih berlaku di dalam sesi cloud, tetapi tidak ada yang menambahkan domain ke allowlist jaringan lingkungan.

Proxy GitHub

Semua operasi GitHub melewati proxy khusus yang menjaga kredensial GitHub nyata Anda di luar VM sesi, independen dari [tingkat akses](#access-levels) lingkungan: * **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`](#work-with-github-issues-and-pull-requests), 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. File yang berkomitmen dari repositori publik tiba melalui `raw.githubusercontent.com`, yang ditangani [proxy keamanan](#security-proxy) sebagai gantinya. Domain itu ada dalam daftar [Trusted](#default-allowed-domains) default, jadi file tersebut tetap dapat dijangkau kecuali [tingkat akses](#access-levels) lingkungan mengecualikannya.

Proxy keamanan

Sesi cloud berjalan di belakang proxy jaringan HTTP/HTTPS untuk tujuan keamanan dan pencegahan penyalahgunaan. Semua lalu lintas internet keluar 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

Setiap sesi mendapat mesin virtual (VM) segar yang menjalankan Ubuntu 24.04, terlepas dari sistem operasi Anda sendiri, dengan repositori Anda yang dikloning dan toolchain umum yang sudah diinstal sebelumnya. Bagian ini mencakup default tersebut, alat GitHub bawaan, cara [menjalankan tes dan layanan](#run-tests-start-services-and-add-packages), dan [batas sumber daya](#resource-limits) yang diterima setiap VM.

Apa yang terbawa dari setup Anda

Sesi cloud dimulai dari klon segar repositori Anda. 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](/docs/id/server-managed-settings). | | Tersedia di sesi cloud | Mengapa | | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CLAUDE.md` repo Anda | Ya | Bagian dari klon | | Hook `.claude/settings.json` repo Anda | Ya | Bagian dari klon | | Server MCP `.mcp.json` repo Anda | Ya | Bagian dari klon | | `.claude/rules/` repo Anda | Ya | Bagian dari klon | | `.claude/skills/`, `.claude/agents/`, `.claude/commands/` repo Anda | Ya | Bagian dari klon | | Plugin yang dideklarasikan di `.claude/settings.json` | Ya | Diinstal saat startup sesi dari [marketplace](/docs/id/plugin-marketplaces) yang Anda deklarasikan. Memerlukan akses jaringan untuk menjangkau sumber marketplace | | [Pengaturan yang dikelola server](/docs/id/server-managed-settings) organisasi Anda | Ya | Diambil dari server Anthropic ketika sesi dimulai. Lihat [Surface coverage](/docs/id/model-config#surface-coverage) untuk cara `availableModels` diterapkan di sesi cloud. Pengaturan yang digunakan di perangkat Anda melalui MDM atau file pengaturan yang dikelola tidak berlaku, karena sesi berjalan di VM yang dikelola Anthropic | | `~/.claude/CLAUDE.md` pengguna Anda | Tidak | Hidup di mesin Anda, bukan di repo | | `~/.claude/skills/`, `~/.claude/agents/`, `~/.claude/commands/` pengguna Anda | Tidak | Hidup di mesin Anda, bukan di repo. Komitkan mereka ke direktori `.claude/` repo sebagai gantinya. Sesi cloud secara otomatis memuat skill yang Anda aktifkan di claude.ai | | Plugin yang hanya diaktifkan di pengaturan pengguna Anda | Tidak | `enabledPlugins` yang dibatasi pengguna hidup di `~/.claude/settings.json`. Deklarasikan mereka di `.claude/settings.json` repo sebagai gantinya | | Server MCP yang Anda tambahkan dengan `claude mcp add` di cakupan lokal default atau cakupan pengguna | Tidak | Mereka menulis ke `~/.claude.json` di mesin Anda, bukan repo. Tambahkan server dengan `claude mcp add --scope project`, yang menulis [`.mcp.json`](/docs/id/mcp#project-scope) repo, dan komitkan file itu | | Variabel transport di blok `env` `.claude/settings.json` repo Anda, seperti `NODE_EXTRA_CA_CERTS` dan [variabel sertifikat klien mTLS](/docs/id/network-config#mtls-authentication) | Tidak | Lingkungan hosting mengelola koneksi API sesi, jadi Claude Code mengabaikan kunci ini dan mencatat setiap kunci yang diabaikan di log debug sesi | | Token API statis dan kredensial | Tidak | Penyimpanan rahasia khusus belum ada. Lihat di bawah | | Auth interaktif seperti AWS SSO | Tidak | Tidak didukung. SSO memerlukan login berbasis browser yang tidak dapat berjalan di sesi cloud | Untuk membuat konfigurasi Anda sendiri tersedia di sesi cloud, komitkan ke repo. Penyimpanan rahasia khusus belum tersedia, dan dialog memperingatkan terhadap penambahan rahasia atau kredensial: variabel lingkungan dan skrip setup hidup dalam konfigurasi lingkungan, di mana siapa pun yang menggunakan lingkungan dapat membacanya. Jika sesi memerlukan kredensial bagaimanapun, tambahkan dengan visibilitas itu dalam pikiran.

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. | Kategori | Disertakan | | :------------ | :--------------------------------------------------------------------------------------- | | **Python** | Python 3.x dengan pip, poetry, uv, black, mypy, pytest, ruff | | **Node.js** | 20, 21, dan 22 melalui nvm, dengan npm, yarn, pnpm, bun¹, eslint, prettier, chromedriver | | **Ruby** | 3.1, 3.2, 3.3 dengan gem, bundler, rbenv | | **PHP** | 8.4 dengan Composer | | **Java** | OpenJDK 21 dengan Maven dan Gradle | | **Go** | stabil terbaru dengan dukungan modul | | **Rust** | rustc dan cargo | | **C/C++** | GCC, Clang, cmake, ninja, conan | | **Docker** | docker, dockerd, docker compose | | **Databases** | PostgreSQL 16, Redis 7.0 | | **Utilities** | git, jq, yq, ripgrep, tmux, vim, nano | ¹ Bun diinstal tetapi memiliki [masalah kompatibilitas proxy](#install-dependencies-with-a-sessionstart-hook) yang diketahui untuk pengambilan paket. Untuk versi yang tepat, minta Claude menjalankan `check-tools` di sesi cloud. Ini adalah perintah shell yang diinstal di VM sesi, bukan perintah slash; Anda meminta Claude karena [Claude menjalankan semua perintah VM untuk Anda](#run-tests-start-services-and-add-packages). Toolchain di luar daftar ini, seperti .NET SDK, tidak diinstal sebelumnya bahkan ketika registri paket mereka ada di [allowlist default](#default-allowed-domains). Instal mereka dengan [skrip setup](#setup-scripts).

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](#github-proxy) menggunakan metode apa pun yang Anda konfigurasi di bawah [opsi autentikasi GitHub](/docs/id/claude-code-on-the-web#github-authentication-options), jadi token Anda tidak pernah memasuki kontainer. Anda dapat menetapkan `GH_TOKEN` atau `GITHUB_TOKEN` sendiri di [pengaturan lingkungan](#set-environment-variables), atau biarkan keduanya tidak ditetapkan dan biarkan [proxy GitHub](#github-proxy) mengautentikasi untuk Anda: * Jika Anda menetapkan token, itu melewati ke kontainer tanpa perubahan, jadi skrip Anda, dan [`gh` CLI](https://cli.github.com) GitHub jika Anda menginstalnya, menggunakannya secara langsung. * Jika Anda tidak menetapkan keduanya dan [proxy GitHub](#github-proxy) 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](https://cli.github.com) GitHub tidak diinstal sebelumnya. Jika Anda memerlukan perintah `gh` yang tidak dicakup alat bawaan, seperti `gh release` atau `gh workflow run`, instal dan autentikasi sendiri: Tambahkan `apt update && apt install -y gh` ke [skrip setup](#setup-scripts) Anda. Jika `echo $GH_TOKEN` mencetak `proxy-injected`, [proxy GitHub](#github-proxy) mengautentikasi `gh` untuk Anda dan langkah ini tidak perlu. Jika tidak, tambahkan variabel lingkungan `GH_TOKEN` ke [pengaturan lingkungan](#set-environment-variables) Anda dengan token akses pribadi GitHub; seperti variabel lingkungan apa pun, dapat dibaca oleh siapa pun yang menggunakan lingkungan, jadi batasi token dengan ketat. `gh` membaca `GH_TOKEN` secara otomatis, jadi Anda tidak perlu menjalankan `gh auth login`. 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: `, dan badan PR mencakup URL sesi di barisnya sendiri. Ini memerlukan v2.1.179 atau lebih baru. Untuk menghilangkan trailer dan tautan badan PR, atur [`attribution.sessionUrl`](/docs/id/settings#attribution-settings) ke `false`. Pengaturan memerlukan v2.1.182 atau lebih baru. 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: ```bash theme={null} 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](#installed-tools), 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: ```bash theme={null} service postgresql start ``` ```bash theme={null} 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](#access-levels) lingkungan Anda, dan [default Trusted](#default-allowed-domains) 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](#setup-scripts) Anda. [Cache lingkungan](#environment-caching) 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](#setup-scripts). [Cache lingkungan](#environment-caching) 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 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](/docs/id/remote-control) untuk menjalankan Claude Code di perangkat keras Anda sendiri.

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 [`gh` CLI](https://cli.github.com) GitHub, yang tidak diinstal sebelumnya. ```bash theme={null} #!/bin/bash apt update && apt install -y gh ```

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](#environment-caching) dapat dibangun. Jalankan instalasi independen secara paralel dengan `&` dan `wait`, dan pindahkan unduhan tunggal apa pun yang tidak cocok ke [hook SessionStart](#setup-scripts-vs-sessionstart-hooks) yang meluncurkannya di latar belakang. * **Akses jaringan untuk instalasi**: instalasi paket perlu menjangkau registri. Tingkat **Trusted** default mencakup [registri paket umum](#default-allowed-domains) 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](#setup-scripts-vs-sessionstart-hooks). 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](#installed-tools). Gunakan [hook SessionStart](/docs/id/hooks#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: 1. Skrip setup berjalan terlebih dahulu, sebelum Claude Code diluncurkan, dan hanya ketika tidak ada [lingkungan cache](#environment-caching) yang ada. 2. Claude Code diluncurkan dan menjalankan hook SessionStart Anda, seperti yang dilakukan di awal setiap sesi, lokal atau cloud. | | Skrip setup | Hook SessionStart | | ---------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Di mana Anda mengonfigurasinya** | Dialog lingkungan di [claude.ai/code](https://claude.ai/code) | File [pengaturan](/docs/id/settings#settings-files) seperti `.claude/settings.json` repo Anda; lihat [Apa yang terbawa dari setup Anda](#what-carries-over-from-your-setup) untuk file mana yang menjangkau sesi cloud | | **Kapan mereka berjalan** | Sebelum Claude Code diluncurkan, dilewati ketika [lingkungan cache](#environment-caching) ada | Setelah Claude Code diluncurkan, di setiap sesi termasuk yang dilanjutkan | | **Di mana mereka berjalan** | Sesi cloud saja | Sesi lokal dan cloud | Jika Anda memiliki hook SessionStart di `~/.claude/settings.json` tingkat pengguna, jangan harapkan mereka di cloud: pengaturan tingkat pengguna tetap di mesin Anda. Di sesi cloud, Claude Code menjalankan hook dari repositori dan dari [pengaturan yang dikelola server](/docs/id/server-managed-settings) organisasi Anda.

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: ```json theme={null} { "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: ```bash theme={null} #!/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: * **Tidak ada scoping khusus cloud**: hook berjalan di sesi lokal dan cloud. Untuk melewati eksekusi lokal, periksa variabel lingkungan `CLAUDE_CODE_REMOTE` seperti yang ditunjukkan di atas. * **Memerlukan akses jaringan**: perintah instalasi perlu menjangkau registri paket. Jika lingkungan Anda menggunakan akses jaringan **None**, hook ini gagal. [Allowlist default](#default-allowed-domains) di bawah **Trusted** mencakup npm, PyPI, RubyGems, dan crates.io. * **Kompatibilitas proxy**: semua lalu lintas keluar melewati [proxy keamanan](#security-proxy). Beberapa manajer paket tidak bekerja dengan benar dengan proxy ini. Bun adalah contoh yang diketahui. * **Menambah latensi startup**: hook berjalan setiap kali sesi dimulai atau dilanjutkan, tidak seperti skrip setup yang mendapat manfaat dari [caching lingkungan](#environment-caching). Jaga skrip instalasi cepat dengan memeriksa apakah dependensi sudah ada sebelum menginstal ulang. Untuk mempertahankan variabel lingkungan untuk perintah Bash berikutnya, tulis ke file di `$CLAUDE_ENV_FILE`. Lihat [hook SessionStart](/docs/id/hooks#sessionstart) untuk detail. Untuk menyesuaikan gambar dasar, gunakan skrip setup untuk menginstal apa yang Anda butuhkan di atas [gambar yang disediakan](#installed-tools), 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`. * api.anthropic.com * statsig.anthropic.com * docs.claude.com * platform.claude.com * code.claude.com * claude.ai * github.com * [www.github.com](http://www.github.com) * api.github.com * npm.pkg.github.com * raw\.githubusercontent.com * pkg-npm.githubusercontent.com * objects.githubusercontent.com * release-assets.githubusercontent.com * codeload.github.com * avatars.githubusercontent.com * camo.githubusercontent.com * gist.github.com * gitlab.com * [www.gitlab.com](http://www.gitlab.com) * registry.gitlab.com * bitbucket.org * [www.bitbucket.org](http://www.bitbucket.org) * api.bitbucket.org * registry-1.docker.io * auth.docker.io * index.docker.io * hub.docker.com * [www.docker.com](http://www.docker.com) * production.cloudflare.docker.com * download.docker.com * gcr.io * \*.gcr.io * ghcr.io * mcr.microsoft.com * \*.data.mcr.microsoft.com * public.ecr.aws * cloud.google.com * accounts.google.com * gcloud.google.com * \*.googleapis.com * storage.googleapis.com * compute.googleapis.com * container.googleapis.com * azure.com * portal.azure.com * microsoft.com * [www.microsoft.com](http://www.microsoft.com) * \*.microsoftonline.com * packages.microsoft.com * dotnet.microsoft.com * dot.net * visualstudio.com * dev.azure.com * \*.amazonaws.com * \*.api.aws * oracle.com * [www.oracle.com](http://www.oracle.com) * java.com * [www.java.com](http://www.java.com) * java.net * [www.java.net](http://www.java.net) * download.oracle.com * yum.oracle.com * registry.npmjs.org * [www.npmjs.com](http://www.npmjs.com) * [www.npmjs.org](http://www.npmjs.org) * npmjs.com * npmjs.org * yarnpkg.com * registry.yarnpkg.com * pypi.org * [www.pypi.org](http://www.pypi.org) * files.pythonhosted.org * pythonhosted.org * test.pypi.org * pypi.python.org * pypa.io * [www.pypa.io](http://www.pypa.io) * rubygems.org * [www.rubygems.org](http://www.rubygems.org) * api.rubygems.org * index.rubygems.org * ruby-lang.org * [www.ruby-lang.org](http://www.ruby-lang.org) * rubyforge.org * [www.rubyforge.org](http://www.rubyforge.org) * rubyonrails.org * [www.rubyonrails.org](http://www.rubyonrails.org) * rvm.io * get.rvm.io * crates.io * [www.crates.io](http://www.crates.io) * index.crates.io * static.crates.io * rustup.rs * static.rust-lang.org * [www.rust-lang.org](http://www.rust-lang.org) * proxy.golang.org * sum.golang.org * index.golang.org * golang.org * [www.golang.org](http://www.golang.org) * goproxy.io * pkg.go.dev * maven.org * repo.maven.org * central.maven.org * repo1.maven.org * repo.maven.apache.org * jcenter.bintray.com * gradle.org * [www.gradle.org](http://www.gradle.org) * services.gradle.org * plugins.gradle.org * kotlinlang.org * [www.kotlinlang.org](http://www.kotlinlang.org) * spring.io * repo.spring.io * packagist.org (PHP Composer) * [www.packagist.org](http://www.packagist.org) * repo.packagist.org * nuget.org (.NET NuGet) * [www.nuget.org](http://www.nuget.org) * api.nuget.org * pub.dev (Dart/Flutter) * api.pub.dev * hex.pm (Elixir/Erlang) * [www.hex.pm](http://www.hex.pm) * cpan.org (Perl CPAN) * [www.cpan.org](http://www.cpan.org) * metacpan.org * [www.metacpan.org](http://www.metacpan.org) * api.metacpan.org * cocoapods.org (iOS/macOS) * [www.cocoapods.org](http://www.cocoapods.org) * cdn.cocoapods.org * haskell.org * [www.haskell.org](http://www.haskell.org) * hackage.haskell.org * swift.org * [www.swift.org](http://www.swift.org) * archive.ubuntu.com * security.ubuntu.com * ubuntu.com * [www.ubuntu.com](http://www.ubuntu.com) * \*.ubuntu.com * ppa.launchpad.net * launchpad.net * [www.launchpad.net](http://www.launchpad.net) * \*.nixos.org * dl.k8s.io (Kubernetes) * pkgs.k8s.io * k8s.io * [www.k8s.io](http://www.k8s.io) * releases.hashicorp.com (HashiCorp) * apt.releases.hashicorp.com * rpm.releases.hashicorp.com * archive.releases.hashicorp.com * hashicorp.com * [www.hashicorp.com](http://www.hashicorp.com) * repo.anaconda.com (Anaconda/Conda) * conda.anaconda.org * anaconda.org * [www.anaconda.com](http://www.anaconda.com) * anaconda.com * continuum.io * apache.org (Apache) * [www.apache.org](http://www.apache.org) * archive.apache.org * downloads.apache.org * eclipse.org (Eclipse) * [www.eclipse.org](http://www.eclipse.org) * download.eclipse.org * nodejs.org (Node.js) * [www.nodejs.org](http://www.nodejs.org) * developer.apple.com * developer.android.com * pkg.stainless.com * binaries.prisma.sh * statsig.com * [www.statsig.com](http://www.statsig.com) * api.statsig.com * sentry.io * \*.sentry.io * downloads.sentry-cdn.com * http-intake.logs.datadoghq.com * browser-intake-us5-datadoghq.com * \*.datadoghq.com * \*.datadoghq.eu * api.honeycomb.io * sourceforge.net * \*.sourceforge.net * packagecloud.io * \*.packagecloud.io * fonts.googleapis.com * fonts.gstatic.com * json-schema.org * [www.json-schema.org](http://www.json-schema.org) * json.schemastore.org * [www.schemastore.org](http://www.schemastore.org) * \*.modelcontextprotocol.io * [Claude Code di web](/docs/id/claude-code-on-the-web): mulai, kelola, dan bagikan sesi cloud * [Quickstart web](/docs/id/web-quickstart): hubungkan GitHub dan mulai sesi cloud pertama Anda * [Claude Tag](https://claude.com/docs/claude-tag/overview): sesi yang dimulai Claude dari Slack berjalan di lingkungan yang sama * [Routines](/docs/id/routines): jalankan terjadwal menggunakan lingkungan dan tingkat akses jaringan yang sama * [Remote Control](/docs/id/remote-control): jalankan sesi di jaringan dan file mesin Anda sendiri sebagai gantinya * [Hook SessionStart](/docs/id/hooks#sessionstart): setup yang berkomitmen repo yang berjalan di sesi lokal dan cloud * [Pengaturan yang dikelola server](/docs/id/server-managed-settings): kebijakan organisasi yang menjangkau sesi cloud