Ce face claude self-hosted-runner
Un mediu self-hosted execută sesiunile cloud Claude Code (pornite din claude.ai/code, din aplicațiile mobile și desktop, din rutine programate sau cu claude --cloud) pe infrastructura organizației tale, nu pe cea Anthropic. Are trei părți: mediul, creat în setările de administrare claude.ai, runnerul, care rulează pe gazdele tale, și sesiunea. Funcția este în beta publică pentru planurile Team și Enterprise și este oprită implicit; un Owner o activează din pagina Cloud environments.
Runnerul face parte din binarul claude standard, din v2.1.224. Îl pornești cu --environment-secret-file, fișierul care conține secretul mediului, și cu --base-dir, un director dedicat în care clonează repository-urile (implicit /workspace). După înregistrare afișează Registered: runner_id=<runner-id> și caută sesiuni în coadă. Prima sesiune preluată leagă runnerul de proprietarul ei; cu valorile implicite, runnerul iese după ce sesiunile active se termină, ca orchestratorul să-l repornească curat.
Subcomenzi: setup este un ghid interactiv pentru operator, care cere un login cu un cont Owner și scrie un rezumat în ./runner-setup/CHEAT-SHEET.md. doctor pornește o sesiune Claude Code cu jurnalele și starea runnerului atașate, pentru diagnosticare. orchestrator pornește runneri la cerere, pe măsură ce sesiunile intră în coadă. Toate conexiunile sunt HTTPS de ieșire spre Anthropic; conținutul sesiunilor ajunge totuși la api.anthropic.com.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
setup |
Ghid interactiv pentru crearea mediului și pornirea unui runner local. |
doctor |
Sesiune de diagnosticare cu jurnalele și starea runnerului. |
orchestrator |
Pornește runneri la cerere pentru sesiunile din coadă. |
--environment-secret-file <cale> |
Fișierul cu secretul mediului (cheia afișată o singură dată în claude.ai). |
--base-dir <director> |
Directorul dedicat pentru clone și sesiuni; implicit /workspace. |
--capacity <N> |
Câte sesiuni concurente rulează runnerul pentru același proprietar. |
--use-anthropic-git-proxy |
Operațiile git trec prin Anthropic. Cere v2.1.267+, --capacity 1 și git 2.32+. |
--log-file <cale> |
Scrie jurnalul runnerului într-un fișier, pe care doctor îl poate citi. |
Exemple practice de terminal
Exemplul 1: Configurarea ghidată
Rulează pe o mașină pe care te-ai conectat cu claude auth login folosind un cont cu rol de Owner.
claude self-hosted-runner setupExemplul 2: Pornirea manuală a unui runner
A doua comandă citește secretul din terminal, ca să nu rămână în istoricul shell-ului: lipești valoarea, apeși Enter, apoi Ctrl-D. Înlocuiește /srv/claude-runner cu un director dedicat runnerului.
mkdir -p /etc/claude
(umask 077 && cat > /etc/claude/environment-secret)
claude self-hosted-runner --environment-secret-file '/etc/claude/environment-secret' --base-dir '/srv/claude-runner'Exemplul 3: Diagnosticarea unui runner
claude self-hosted-runner doctorGreșeli frecvente și bune practici
- Setezi
--base-dirpe directorul tău home sau pe cel cu clonele tale. Runnerul tratează ce găsește în<dir>/<owner>/<repo>drept clona lui și poate reseta, suprascrie sau șterge fișiere acolo. - Rulezi runnerul cu
--use-anthropic-git-proxyca utilizatorul tău. Runnerul șterge și înlocuiește configurația git globală a utilizatorului, fără backup; folosește un utilizator dedicat sau un container. - Te miri că runnerul pornit manual iese după o sesiune. Este comportamentul intenționat; în producție rulează-l sub un orchestrator care îl repornește.