claude setup-token în Claude Code CLI

Configurare și Securitate Claude Code 2.1+

Generează un token OAuth valabil un an pentru CI și scripturi; îl afișează în terminal fără să-l salveze, iar tu îl pui în variabila CLAUDE_CODE_OAUTH_TOKEN.

Sintaxă & invocare
claude setup-token

Ce face claude setup-token

În pipeline-uri CI, scripturi sau alte medii fără login interactiv în browser ai nevoie de o credențială pe termen lung. claude setup-token deschide același flux de autorizare ca /login, iar după ce aprobi accesul în browser, tokenul apare în terminal. Comanda nu îl salvează nicăieri: îl copiezi și îl setezi ca variabila de mediu CLAUDE_CODE_OAUTH_TOKEN acolo unde vrei să te autentifici.

Tokenul se autentifică prin abonamentul Claude și cere un plan Pro, Max, Team sau Enterprise. Poate face doar cereri către model: nu poate porni sesiuni Remote Control și nu poate prelua conectorii claude.ai. Serverele MCP configurate local funcționează.

În ordinea de precedență a credențialelor, CLAUDE_CODE_OAUTH_TOKEN vine după credențialele furnizorilor cloud, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY și apiKeyHelper, dar înaintea loginului făcut cu /login.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
CLAUDE_CODE_OAUTH_TOKEN Variabila de mediu în care pui tokenul generat.

Exemple practice de terminal

Exemplul 1: Generarea tokenului

Comanda deschide browserul pentru autorizare și afișează tokenul în terminal.

claude setup-token

Exemplul 2: Folosirea tokenului într-un job CI (Bash)

În practică, valoarea vine din secretele pipeline-ului, nu scrisă direct în script.

export CLAUDE_CODE_OAUTH_TOKEN=tokenul-tău
claude -p "rulează testele și rezumă erorile"

Exemplul 3: Setarea tokenului în Windows PowerShell

$env:CLAUDE_CODE_OAUTH_TOKEN = "tokenul-tău"

Greșeli frecvente și bune practici

  • Rulezi cu --bare și te bazezi pe token. Modul bare nu citește CLAUDE_CODE_OAUTH_TOKEN; autentifică-te cu ANTHROPIC_API_KEY sau cu un apiKeyHelper.
  • Aștepți ca tokenul să pornească Remote Control sau să încarce conectori claude.ai. Tokenul face doar cereri către model.
  • Pentru administratori: claude setup-token aplică doar forceLoginMethod, nu și forceLoginOrgUUID, deci poate emite un token într-o altă organizație.

Comenzi înrudite