Skip to main content
Lingkungan yang di-host sendiri berada dalam beta publik pada paket Team dan Enterprise; Ketersediaan dan batasan mencakup jalur pengaktifan. Halaman ini menjalankan sesi pertama Anda; lihat Lingkungan yang di-host sendiri untuk mengetahui apa itu dan Terapkan ke produksi untuk pengerasan dan resep armada.
Sebuah lingkungan yang di-host sendiri menjalankan Claude Code sesi cloud pada infrastruktur yang dioperasikan organisasi Anda, dijalankan oleh proses runner yang Anda terapkan. Panduan cepat ini menyiapkan yang pertama, yang terkecil yang berfungsi: satu runner pada satu host, menjalankan satu sesi uji. Ada dua langkah: buat lingkungan, mulai runner, dan arahkan sesi ke sana, kemudian kirim pesan ke sesi itu dari terminal Anda. Anda akan berpindah antara dua permukaan: claude.ai untuk membuat lingkungan, memeriksa statusnya, dan mengarahkan sesi, dan terminal pada host untuk semua yang dilakukan runner. Pada akhirnya Anda akan memiliki lingkungan pada halaman admin Cloud environments, runner yang menunggu pekerjaan, dan sesi yang berjalan pada host Anda. Sebelum Anda menghubungkan repositori nyata atau sistem internal, kerjakan Terapkan ke produksi, yang mencakup postur keamanan, kontrol egress, kredensial git, dan orkestrasi.

​
Prasyarat

​
Organisasi dan peran

Sisi claude.ai memerlukan:
  • Izinkan lingkungan yang di-host sendiri diaktifkan oleh Pemilik pada halaman admin Cloud environments; tombol New tidak muncul sampai diaktifkan. Jika Anda tidak memiliki peran tersebut, seseorang yang memilikinya dapat membuat lingkungan dan memberikan rahasia kepada Anda; langkah runner dan terminal pada halaman ini tidak memerlukan peran claude.ai, dan di mana langkah memeriksa status di UI admin, baris log runner sendiri memberikan sinyal yang sama.
  • Sebuah koneksi GitHub untuk organisasi Anda, sehingga pengembang dapat memilih repositori saat mereka memulai sesi.

​
Host dan jaringan

Host runner memerlukan:
  • Host atau kontainer Linux atau macOS dengan HTTPS keluar ke api.anthropic.com, ke claude.ai dan host unduhan yang dialihkan untuk langkah instalasi di bawah, dan ke host git Anda untuk klon; tabel persyaratan jaringan memiliki daftar lengkap. Windows tidak didukung sebagai host runner; jalankan runner dalam kontainer Linux sebagai gantinya. Workstation pengembang tidak terpengaruh, karena sesi dimulai dari claude.ai di browser.
  • Jam yang disinkronkan dengan waktu nyata, misalnya dengan NTP. Autentikasi gagal ketika jam lebih dari lima menit mati; lihat Troubleshooting.

​
Perangkat lunak pada host runner

Instal pada host sebelum Anda memulai:
  • Claude Code v2.1.224 atau lebih baru, dengan salah satu dari metode instalasi standar. Runner adalah bagian dari biner claude standar, dan versi sebelumnya tidak mengenali subperintah self-hosted-runner. Saluran latest penginstal asli membawa setiap rilis segera setelah dipublikasikan; saluran stable, cask Homebrew claude-code, dan repositori apt, dnf, dan apk yang stabil tertinggal sekitar seminggu. Untuk menyematkan versi yang tepat yang dijalankan armada Anda, lihat Instal versi tertentu. Untuk gambar kontainer, lihat Dockerfile di Terapkan ke produksi.
  • Git 2.24 atau lebih baru. Beberapa opsi git pada halaman terapkan memerlukan versi yang lebih baru; Konfigurasi git menyatakan setiap lantai.
Konfirmasi host siap:
Host yang siap mencetak teks penggunaan runner, mencantumkan bendera seperti --environment-secret-file. Pada versi yang lebih lama dari 2.1.224, perintah mencetak output claude --help umum sebagai gantinya; tingkatkan dengan claude update atau instal ulang dari saluran latest.

​
Siapkan lingkungan dan runner

Claude Code mencakup pengaturan terpandu: sesi Claude Code interaktif yang memandu Anda melalui pembuatan lingkungan di UI admin, memulai runner lokal dengan file rahasia yang Anda simpan, mengonfirmasi bahwa runner terdaftar, dan menulis lembar contekan ke ./runner-setup/CHEAT-SHEET.md. Jalankan pada mesin di mana Anda telah masuk dengan claude auth login menggunakan akun yang memiliki peran Pemilik; tidak tersedia dengan kunci API atau penyedia model pihak ketiga. Pada host di mana sesi interaktif tidak mungkin, gunakan langkah manual di bawah sebagai gantinya. Konfirmasi pemeriksaan versi lulus terlebih dahulu: pada versi yang lebih lama dari 2.1.224, perintah ini memulai sesi Claude biasa dengan kata-kata sebagai prompt alih-alih pengaturan terpandu. Untuk memulai pengaturan terpandu, jalankan subperintah setup dan ikuti prompt:
Untuk menyiapkan secara manual sebagai gantinya:
1

Buat lingkungan

Buka halaman Cloud environments di pengaturan admin. Di bawah Self-hosted environments, pilih New, beri nama lingkungan, dan pilih Create. Pada langkah kedua wizard, pilih Copy environment key untuk menyalin rahasia lingkungan, yang UI admin beri label kunci lingkungan. claude.ai menampilkan rahasia sekali, dan Anda tidak dapat mengambilnya nanti; itu kedaluwarsa 365 hari setelah pembuatan. ID ccpool_... lingkungan tetap terlihat dalam dialog detailnya; Anda akan membutuhkannya untuk pemeriksaan aud dalam verifikasi token dan untuk mengirim sesi uji dari CI.Jika Anda kehilangan rahasia atau perlu memutar ulang, buat rahasia baru dari tab Configuration lingkungan, gulirkan rahasia baru ke runner Anda, kemudian cabut yang lama. Runner yang memegang rahasia yang dicabut gagal polling terautentikasi berikutnya dan keluar, mencatat poll auth failed, dan orkestrator Anda memulai ulang dengan rahasia baru.
2

Mulai runner

Buat direktori rahasia. Langkah ini dan berikutnya memerlukan root untuk jalur /etc/claude; jalur apa pun yang dapat dibaca proses runner berfungsi, jadi sesuaikan kedua perintah dan nilai --environment-secret-file bersama-sama jika Anda menggunakan yang berbeda.
Tulis rahasia lingkungan ke file. Perintah di bawah membaca dari terminal Anda sehingga rahasia tetap keluar dari riwayat shell: tempel nilai yang Anda salin, tekan Enter, kemudian Ctrl-D, dan umask subshell membuat file dapat dibaca hanya oleh pemiliknya.
Pilih direktori dasar, mengganti <writable-dir> dalam perintah runner di bawah dengan jalur absolut yang dapat ditulis atau dibuat oleh runner. Runner membuat direktori saat startup, kemudian memeriksa repositori dan membuat direktori per-sesi di bawahnya. Tanpa --base-dir itu menggunakan /workspace, yang hanya berfungsi jika direktori itu sudah ada dan dapat ditulis atau Anda memulai runner sebagai root.Jika runner tidak dapat membuat atau menulis ke jalur, itu keluar saat startup dengan kesalahan yang menamai direktori alih-alih mendaftar. Lihat Troubleshooting.Kemudian mulai runner dengan --environment-secret-file dan --base-dir. Runner mendaftar dengan lingkungan Anda dan mulai menunggu pekerjaan. Jika runner keluar, mulai ulang dengan tangan. Penerapan produksi menjalankan runner di bawah orkestrator yang memulai ulang runner yang keluar, biasanya dengan filesystem segar per restart; Gunakan kembali checkout yang sudah hangat mencakup pengaturan disk persisten yang didukung.
3

Verifikasi runner muncul

Kembali ke halaman Cloud environments. Status lingkungan Anda berubah dari No runners deployed menjadi Healthy dalam beberapa detik setelah runner dimulai; buka lingkungan dan pilih Activity untuk melihat runner itu sendiri.
4

Arahkan sesi ke lingkungan

Mulai sesi di claude.ai/code dan pilih lingkungan Anda dari pemilih lingkungan, di mana lingkungan yang di-host sendiri muncul bersama yang di-host Anthropic. Runner mengklon dengan kredensial git apa pun yang sudah dimiliki host, jadi pilih repositori yang sudah dapat diklon host ini, atau yang publik; opsi kredensial untuk repositori pribadi dalam produksi ada di Konfigurasi git. Runner yang tersedia berikutnya mengambil sesi yang antri dan mencatat Picked up session <session-id> bersama dengan hitungan aktif dan kapasitasnya, sehingga Anda dapat mengonfirmasi dari output runner sendiri host mana yang mengambil sesi. Tonton sesi bekerja dan baca balasan Claude di claude.ai/code. Jika sesi duduk antri sebagai gantinya, lihat Troubleshooting.
Runner keluar dengan desain setelah sesi aktifnya selesai; lihat Runner lifecycle. Untuk produksi, terapkan di bawah orkestrator yang memulai ulang saat keluar. Lihat Terapkan ke produksi.

​
Kirim pesan lanjutan ke sesi yang berjalan

Setelah sesi berjalan di lingkungan Anda, kirim lanjutan darinya dari CLI claude pada mesin apa pun di mana Anda masuk dengan claude auth login; perintah tidak perlu dijalankan dari mesin yang memulai sesi. Perintah memposting satu pesan:
Untuk <session-id>, berikan ID session_... atau cse_... telanjang atau URL claude.ai/code sesi. Pengiriman yang berhasil mencetak Sent to cloud session. dengan ID sesi dan tautan tampilan. Bentuk ID yang diterima, output JSON, persyaratan akun dan kebijakan, dan referensi kesalahan ada di Kirim lanjutan dari CLI, karena perintah bekerja sama terhadap sesi yang di-host Anthropic.

​
Apa selanjutnya

  • Terapkan ke produksi: keraskan penerapan, kontrol egress, konfigurasi kredensial git, dan jalankan armada di bawah Kubernetes atau Compose
  • Sesuaikan sesi: skrip wrapper, hook siklus hidup, runner sesuai permintaan, server MCP, dan izin
  • Uji end to end: uji asap CI yang mengirim sesi dan membaca balasan Claude