Mulai dengan Claude Code di cloud

Jalankan Claude Code di cloud dari browser atau ponsel Anda. Hubungkan repositori GitHub, kirimkan tugas, dan tinjau PR tanpa setup lokal.

[!NOTE]

Sesi cloud tersedia di paket Pro, Max, Ultra, dan Team, serta untuk pengguna Enterprise dengan kursi premium atau kursi Chat + Claude Code.

Sesi cloud menjalankan Claude Code pada infrastruktur cloud alih-alih mesin Anda, dikelola Anthropic secara default. Panduan singkat ini memulai satu dari claude.ai/code di browser Anda. Anda juga dapat memulai satu dari aplikasi mobile Claude, aplikasi Desktop, atau terminal Anda dengan claude --cloud.

Anda memerlukan repositori GitHub untuk memulai. Claude mengklonnya ke mesin virtual yang terisolasi, membuat perubahan, dan mendorong branch untuk Anda tinjau. Sesi bertahan di seluruh perangkat, jadi tugas yang Anda mulai di laptop siap ditinjau dari ponsel Anda nanti. Setiap sesi dihitung terhadap batas penggunaan paket Anda bersama dengan penggunaan Claude dan Claude Code Anda lainnya, dan tidak ada biaya terpisah untuk VM cloud.

Sesi cloud bekerja dengan baik untuk:

• Tugas paralel: jalankan beberapa tugas independen sekaligus, masing-masing dalam sesi dan cabangnya sendiri, tanpa mengelola beberapa worktrees
• Repo yang tidak Anda miliki secara lokal: Claude mengklonkan repo segar setiap sesi, jadi Anda tidak perlu memeriksanya
• Tugas yang tidak memerlukan pengarahan sering: kirimkan tugas yang terdefinisi dengan baik, lakukan sesuatu yang lain, dan tinjau hasilnya ketika Claude selesai
• Pertanyaan kode dan eksplorasi: pahami basis kode atau lacak bagaimana fitur diimplementasikan tanpa checkout lokal

Untuk pekerjaan yang memerlukan konfigurasi lokal, alat, atau lingkungan Anda, menjalankan Claude Code secara lokal atau menggunakan Remote Control adalah pilihan yang lebih baik.

Bagaimana sesi berjalan

Langkah-langkah di bawah ini menjelaskan sesi yang dihosting Anthropic. Dalam lingkungan yang dihosting sendiri, klon dan semuanya setelahnya berjalan pada runner organisasi Anda sendiri, di mana batas jaringan, setup, dan perilaku push dikonfigurasi oleh operator. Ketika Anda mengirimkan tugas:

1. Klonkan dan persiapkan: repositori Anda diklonkan ke VM yang dikelola Anthropic, dan skrip setup Anda berjalan jika dikonfigurasi.
2. Konfigurasi jaringan: akses internet diatur berdasarkan tingkat akses lingkungan Anda.
3. Bekerja: Claude menganalisis kode, membuat perubahan, menjalankan tes, dan memeriksa pekerjaannya. Anda dapat menonton dan mengarahkan sepanjang waktu, atau pergi dan kembali ketika selesai.
4. Dorong cabang: ketika Claude mencapai titik pemberhentian, ia mendorong cabangnya ke GitHub. Anda meninjau diff, meninggalkan komentar inline, membuat PR, atau mengirim pesan lain untuk melanjutkan.

Sesi tidak ditutup ketika cabang didorong. Pembuatan PR dan pengeditan lebih lanjut semuanya terjadi dalam percakapan yang sama.

Bandingkan cara menjalankan Claude Code

Claude Code berperilaku sama di mana pun. Yang berubah adalah tempat sesi berjalan dan apakah konfigurasi lokal Anda tersedia:

Lihat dokumentasi terminal quickstart, aplikasi Desktop, atau Remote Control untuk mengatur sesi lokal.

Hubungkan GitHub

Menghubungkan GitHub adalah langkah yang hanya perlu dilakukan sekali. Jika Anda sudah menggunakan GitHub CLI, Anda dapat melakukannya dari terminal Anda alih-alih melalui browser.

[!NOTE]

Pada paket Team dan Enterprise, langkah Sign in with GitHub hanya berfungsi setelah seorang Owner dari organisasi Claude Anda mengaktifkan konektor GitHub di Organization settings > Connectors. Sebelum itu, langkah tersebut menampilkan "GitHub access is required for Claude Code cloud sessions" alih-alih tombol masuk. Setelah konektor aktif, muat ulang claude.ai/code dan mulai lagi dari langkah pertama. Sakelar kedua, Quick setup di Organization settings > Claude Code, bersifat opsional: jika diaktifkan, /web-setup berfungsi dan proses onboarding membuat environment untuk para anggota.

1. Kunjungi claude.ai/code

Buka claude.ai/code dan masuk dengan akun claude.ai Anda.

2. Masuk dengan GitHub

Setelah Anda masuk, claude.ai/code meminta Anda untuk menghubungkan GitHub. Ikuti petunjuknya, dan claude.ai/code akan mengarahkan Anda ke halaman otorisasi GitHub. Setujui permintaan otorisasi, dan GitHub akan mengembalikan Anda ke claude.ai/code. Sesi cloud bekerja dengan repositori GitHub yang sudah ada. Untuk memulai proyek baru, buat repositori dengan README di GitHub terlebih dahulu.

Dengan koneksi ini, sebuah sesi dapat melakukan clone terhadap repositori publik mana pun, tetapi hanya dapat bekerja di repositori privat jika Claude GitHub App terpasang di repositori tersebut. Pasang Claude GitHub App di setiap akun atau organisasi GitHub yang repositori privatnya ingin Anda gunakan. Pada organisasi GitHub, pemilik organisasi mungkin perlu menyetujui pemasangan tersebut. Memasangnya juga mengaktifkan Auto-fix, yang memungkinkan Claude merespons kegagalan CI dan komentar tinjauan pada pull request di repositori tersebut.

Saat Anda terhubung, Claude juga menautkan akun GitHub yang Anda miliki ke organisasi Claude Anda, jika akun tersebut telah memasang Claude GitHub App. Pada paket Team dan Enterprise, admin dapat melihat akun-akun tersebut di daftar akun GitHub yang terhubung.

Jika proses onboarding meminta Anda untuk memasang Claude GitHub App pada tahap ini dan Anda lebih memilih melakukannya nanti, klik Skip.

3. Siapkan environment Default Anda

Cloud environment adalah konfigurasi tersimpan yang mengontrol akses jaringan apa yang dimiliki Claude selama sesi dan apa yang dijalankan saat sesi dimulai. Apa yang terjadi setelah Anda menghubungkan GitHub bergantung pada paket Anda:

• Pro, Max, dan Ultra: Anda mendapatkan environment bernama Default secara otomatis.
• Team dan Enterprise: proses onboarding menampilkan formulir Create your first cloud environment. Biarkan nama dan akses jaringan yang sudah terisi tidak berubah, lalu klik Create & finish untuk membuat environment Default. Jika seorang Owner telah mengaktifkan Quick setup, proses onboarding akan membuat Default untuk Anda.

Default menggunakan akses jaringan Trusted: sesi dapat menjangkau registri paket umum dan domain lain yang ada di daftar izin, dan tidak ada yang lain melalui jaringan sesi. Lihat Tool terpasang untuk mengetahui apa saja yang tersedia tanpa konfigurasi apa pun.

Untuk proyek pertama, environment Default dapat digunakan apa adanya. Untuk mengubah akses jaringannya, menambahkan environment variable, atau menjalankan skrip penyiapan sebelum sesi dimulai, edit environment tersebut atau buat environment tambahan.

Hubungkan dari terminal Anda

Jika Anda sudah menggunakan GitHub CLI (gh), Anda dapat menghubungkan GitHub untuk sesi cloud dari terminal Anda. Ini memerlukan Claude Code CLI. Pada paket Team dan Enterprise, /web-setup hanya tersedia setelah seorang Owner mengaktifkan Quick setup.

Saat Anda menjalankan /web-setup, Claude Code membaca token yang dicetak oleh gh auth token, meminta konfirmasi Anda, lalu mengirimkan token tersebut ke Anthropic. Anthropic menyimpannya dalam bentuk terenkripsi bersama akun claude.ai Anda, dan sesi cloud Anda menggunakannya untuk akses GitHub hingga Anda menghapusnya. Sesi cloud yang Anda mulai sendiri kemudian dapat mengakses repositori apa pun yang dapat diakses oleh token tersebut, tanpa pemasangan Claude GitHub App. Thread dalam sebuah proyek tetap memerlukan Claude GitHub App.

Jika Anda sudah menghubungkan GitHub melalui browser, /web-setup akan memperingatkan Anda bahwa melanjutkan proses akan menggantikan koneksi tersebut untuk sesi cloud Anda.

[!NOTE]

Organisasi yang mengaktifkan Zero Data Retention, atau yang menerapkan konfigurasi HIPAA, tidak dapat menggunakan /web-setup maupun fitur sesi cloud lainnya. Organisasi yang menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) juga tidak dapat memulai sesi cloud. Jika GitHub CLI tidak terpasang atau belum diautentikasi, Claude Code akan membuka alur onboarding di browser sebagai gantinya.

1. Autentikasi dengan GitHub CLI

Di shell Anda, autentikasi GitHub CLI jika Anda belum melakukannya:

gh auth login

2. Masuk ke Claude

Di Claude Code CLI, jalankan /login untuk masuk dengan akun claude.ai Anda. Lewati langkah ini jika Anda sudah masuk dengan akun claude.ai. Autentikasi dengan kunci API tidak dihitung. Untuk memeriksanya, jalankan /status dan pastikan baris Login method menampilkan akun claude.ai.

3. Jalankan /web-setup

Di Claude Code CLI, jalankan:

/web-setup

Konfirmasikan permintaan untuk mengirim token gh Anda ke akun Claude Anda. Jika berhasil, Claude Code mencetak Connected as <your-github-username> dan membuka claude.ai/code di browser Anda. Jika Anda belum memiliki cloud environment, /web-setup akan membuatnya dengan akses jaringan Trusted dan tanpa skrip penyiapan. Anda dapat mengedit environment atau menambahkan variabel setelahnya. Setelah /web-setup selesai, Anda dapat memulai sesi cloud dari terminal Anda dengan --cloud atau menyiapkan tugas berulang dengan /schedule.

Hapus token /web-setup

Untuk menghapus token dari akun Claude Anda, putuskan koneksi GitHub di claude.ai/customize/connectors. Memutuskan koneksi akan menghapus kredensial GitHub yang digunakan oleh sesi cloud Anda, baik yang berasal dari browser maupun dari /web-setup, sehingga sesi cloud kehilangan akses GitHub hingga Anda menghubungkannya kembali. gh lokal Anda tetap dalam keadaan masuk, dan token tetap valid di GitHub.

Untuk membatalkan validitas token itu sendiri, cabut token tersebut di GitHub. Jika Anda masuk ke gh melalui browser, token tersebut termasuk dalam entri GitHub CLI di bawah Settings > Applications > Authorized OAuth Apps di GitHub, dan mencabut entri tersebut juga akan mengeluarkan (log out) GitHub CLI dari mesin-mesin Anda. Sesi cloud kemudian kehilangan akses GitHub hingga Anda menjalankan gh auth login dan /web-setup lagi.

Mulai tugas

Dengan GitHub terhubung dan lingkungan dibuat, Anda siap mengirimkan tugas.

1. Pilih repositori dan branch

Dari claude.ai/code atau tab Code di aplikasi mobile Claude, klik pemilih repositori di bawah kotak input dan pilih repositori untuk Claude bekerja. Anda dapat menambahkan beberapa repositori untuk bekerja di seluruhnya dalam satu sesi.

Di claude.ai/code, untuk memulai Claude dari branch fitur alih-alih default, ubah branch di kontrol setelah pemilih repositori.

2. Pilih mode izin

Kontrol mode izin menunjukkan mode izin yang akan digunakan saat sesi berjalan:

• Auto: pengklasifikasi meninjau tindakan Claude alih-alih meminta Anda. Muncul ketika organisasi Anda memungkinkan mode auto dan model yang dipilih mendukungnya
• Terima editan: Claude membuat perubahan dan mendorong cabang tanpa berhenti untuk persetujuan
• Plan: Claude mengusulkan pendekatan dan menunggu Anda menyetujuinya sebelum mengedit file

Sesi cloud tidak menawarkan izin Manual atau Bypass. Lihat daftar lengkap mode izin untuk apa yang masing-masing izinkan.

3. Jelaskan tugas dan kirimkan

Ketik deskripsi apa yang Anda inginkan dan tekan Enter. Jadilah spesifik:

• Beri nama file atau fungsi: "Tambahkan README dengan instruksi setup" atau "Perbaiki tes auth yang gagal di tests/test_auth.py" lebih baik daripada "perbaiki tes"
• Tempel output kesalahan jika Anda memilikinya
• Jelaskan perilaku yang diharapkan, bukan hanya gejala

Claude mengklonkan repositori, menjalankan skrip setup Anda jika dikonfigurasi, dan mulai bekerja. Setiap tugas mendapatkan sesi sendiri dan cabangnya sendiri, jadi Anda tidak perlu menunggu satu selesai sebelum memulai yang lain.

Isi sebelumnya sesi

Anda dapat mengisi sebelumnya prompt, repositori, dan lingkungan untuk sesi baru dengan menambahkan parameter query ke URL claude.ai/code. Gunakan ini untuk membangun integrasi seperti tombol di pelacak masalah Anda yang membuka Claude Code dengan deskripsi masalah sebagai prompt.

URL-encode setiap nilai. Contoh di bawah membuka formulir dengan prompt dan repositori yang sudah dipilih:

https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp

Tinjau dan ulangi

Ketika Claude selesai, tinjau perubahan, tinggalkan umpan balik pada baris tertentu, dan terus sampai diff terlihat benar.

1. Buka tampilan diff

Setelah Claude mendorong perubahannya ke sebuah branch, kartu Changes di panel di samping chat menunjukkan baris yang ditambahkan dan dihapus di seluruh sesi, misalnya +42 -18. Klik angka tersebut untuk membuka tampilan diff.

• Anda juga dapat mengklik Changes di bilah judul sesi, atau di menu ⋮ pada bilah tersebut.
• Untuk menampilkan panel saat tersembunyi, klik ikon Show session rail di bilah judul sesi, atau di menu ⋮ pada bilah tersebut.

Diff membandingkan perubahan sesi terhadap branch dasarnya secara default. Untuk membandingkan terhadap branch yang berbeda, pilih Compare against dan pilih satu. Jika dibandingkan terhadap branch dasar, diff dapat tidak menyertakan perubahan yang belum didorong.

2. Tinggalkan komentar inline

Arahkan kursor ke sebuah baris di diff dan klik + yang muncul di samping nomor barisnya untuk membuka kotak komentar, lalu ketik umpan balik Anda dan tekan Enter. Komentar antri sampai Anda mengirim pesan berikutnya, kemudian digabungkan dengannya. Claude melihat "di src/auth.ts:47, jangan tangkap kesalahan di sini" bersama instruksi utama Anda, jadi Anda tidak harus menjelaskan di mana masalahnya.

3. Buat pull request

Ketika diff terlihat benar, tampilkan panel lagi jika kartu Changes tidak terlihat, lalu buat pull request atau draft dari kartu tersebut:

• Klik Create PR. Claude Code membuat pull request dengan judul dan deskripsi yang dihasilkan.
• Untuk membuka draft sebagai gantinya, klik kanan Create PR, pilih Create draft PR untuk mengubah fungsi tombol tersebut, lalu klik tombolnya

4. Terus ulangi setelah PR

Sesi tetap aktif setelah PR dibuat. Tempel output kegagalan CI atau komentar pengulas ke chat dan minta Claude untuk mengatasinya. Untuk membuat Claude memantau PR secara otomatis, lihat Auto-fix pull requests.

Troubleshoot setup

No repositories appear after connecting GitHub

If you connected GitHub in the browser, sessions can clone any public repository, but a private repository appears only when the Claude GitHub App is installed on the account or organization that owns it and the installation's repository access includes it. Install the Claude GitHub App there, or ask an organization owner to install or approve it.

If you connected with /web-setup, sessions reach every repository your gh token can access. Run gh repo view OWNER/REPO in your shell to check that your GitHub CLI login can see the repository, and run /web-setup again if you've switched gh accounts since connecting.

The page only shows a GitHub login button

Cloud sessions require a connected GitHub account. Connect via the browser flow above, or run /web-setup from your terminal if you use the GitHub CLI. If you'd rather not connect GitHub at all, see Remote Control to run Claude Code on your own machine and monitor it from your browser or phone.

"Claude Code isn't available on your account"

Your seat in the selected organization doesn't include Claude Code. If you belong to another organization, click Switch organization on that page. Otherwise, ask an Owner of the organization to assign you a seat that includes Claude Code.

/web-setup says "Not signed in to Claude"

If /web-setup responds with "Not signed in to Claude. Run /login first.", the CLI doesn't have a valid claude.ai sign-in. This can also happen when a previous sign-in has expired. Run /login, sign in with your claude.ai account, then run /web-setup again.

/web-setup warns that your token doesn't have the workflow scope

If /web-setup says your GitHub CLI token doesn't have the workflow scope, you can continue, but GitHub can reject some pushes made with that token, such as pushes that change GitHub Actions workflow files. To add the scope, run gh auth refresh -s workflow in your shell, then run /web-setup again.

/web-setup shows "No commands match" or "Unknown command"

/web-setup runs inside the Claude Code CLI, not your shell. Launch claude first, then type /web-setup at the prompt.

If you typed it inside Claude Code and the command menu shows No commands match "/web-setup", or submitting it returns Unknown command: /web-setup, the command is hidden because a requirement isn't met. The cause is usually that you're authenticated with an API key or third-party provider instead of a claude.ai subscription. Run /login to sign in with your claude.ai account.

Pada paket Team dan Enterprise, perintah ini disembunyikan secara default: toggle Quick setup dalam keadaan mati hingga seorang Owner mengaktifkannya. Selama toggle tersebut mati, hubungkan GitHub dari browser sebagai gantinya.

The command is also hidden in two other cases:

• An administrator has disabled cloud sessions for your organization. In this case, submitting /web-setup returns Cloud sessions are disabled by your organization's policy. Before v2.1.268, this case also returned Unknown command: /web-setup.
• Organisasi Enterprise Anda mengaktifkan Zero Data Retention, atau menerapkan konfigurasi HIPAA. Salah satu dari keduanya membuat sesi cloud tidak tersedia.

"Could not create a cloud environment" or "No cloud environment available" when using --cloud

Cloud session features create a default cloud environment automatically if you don't have one. If you see "Could not create a cloud environment", automatic creation failed. If you see "No cloud environment available", your CLI predates automatic creation. In either case, run /web-setup in the Claude Code CLI, or add an environment from the environment selector at claude.ai/code.

Setup script failed

The setup script exited with a non-zero status, which blocks the session from starting. Common causes:

• A package install failed because the registry isn't in your network access level. Trusted covers most package managers; None blocks them all.
• The script references a file or path that doesn't exist in a fresh clone.
• A command that works locally needs a different invocation on Ubuntu.

To debug, add set -x at the top of the script to see which command failed. For non-critical commands, append || true so they don't block session start.

New sessions hang or time out during setup

If new sessions stall on the setup script step or fail with a generic container error before the script finishes, the script is likely exceeding the roughly five-minute time budget for building the environment cache. Heavy steps such as pulling large Docker images, syncing full dependency trees, or downloading model weights often push the total over the limit, especially when they run one after another.

To fix this, trim the script so it reliably finishes in under five minutes:

• Run independent installs in parallel with & and a final wait instead of running them serially.
• Move the largest downloads out of the setup script and into a SessionStart hook that launches them in the background, so the session becomes usable while they finish.
• Remove long retry sleeps from the setup script, since a stalled retry loop counts against the budget.

Session keeps running after closing the tab

This is by design. Closing the tab or navigating away doesn't stop the session. It continues running in the background until Claude finishes the current task, then idles. From the sidebar, you can archive a session to hide it from your list, or delete it to remove it permanently.

Langkah berikutnya

Sekarang bahwa Anda dapat mengirimkan dan meninjau tugas, halaman-halaman ini mencakup apa yang akan datang: memulai sesi cloud dari terminal Anda, menjadwalkan pekerjaan berulang, dan memberikan Claude instruksi berdiri.

• Gunakan Claude Code di web: referensi lengkap, termasuk teleportasi sesi ke terminal Anda, berbagi sesi, dan perbaikan otomatis permintaan tarik
• Konfigurasi lingkungan cloud: tingkat akses jaringan, variabel lingkungan, dan skrip setup untuk sesi cloud
• Tugas terjadwal cloud: otomatiskan pekerjaan sesuai jadwal, melalui panggilan API, atau sebagai respons terhadap peristiwa GitHub
• CLAUDE.md: berikan Claude instruksi dan konteks persisten yang dimuat di awal setiap sesi
• Instal aplikasi mobile Claude untuk iOS atau Android untuk memantau sesi dari ponsel Anda. Dari Claude Code CLI, /mobile menampilkan kode QR untuk claude.ai/mobile yang membuka toko aplikasi yang tepat untuk ponsel Anda.