Tutorial de Claude Code 6: Com autenticar-se - Inici de sessió al navegador i configuració manual de la clau API

Procés d'autenticació: Inici de sessió al navegador i configuració manual de la clau API

Un cop instal·lat Claude Code, cal autenticar-se per poder-lo utilitzar. Has de vincular l'eina amb el teu compte d'Anthropic. Hi ha dues maneres: inici de sessió al navegador i configuració manual de la clau API. Ambdues opcions tenen el mateix resultat final; tria la que et resulti més còmoda.

Opció 1: Inici de sessió al navegador (recomanat)

Claude Code proporciona una ordre d'autenticació automàtica claude login que obre el navegador, et demana autorització a la pàgina web i, automàticament, escriu les credencials al terminal.

Passos:

1. Al terminal, escriu:

bash claude login

1. El sistema mostrarà un missatge i obrirà automàticament la pàgina d'autorització d'Anthropic al teu navegador per defecte.
   Si no s'obre automàticament, el terminal imprimirà un enllaç que podràs copiar i obrir manualment al navegador.

2. Inicia sessió al teu compte d'Anthropic al navegador (si ja has iniciat sessió, la pàgina demanarà autorització directament).

3. Fes clic a "Permetre" o "Autoritzar". La pàgina del navegador mostrarà "Autorització correcta, ja pots tancar aquesta pàgina".

4. Torna al terminal i veuràs el missatge d'autenticació completada. A partir d'aquí, en executar l'ordre claude, ja estarà vinculat al teu compte.

Opció 2: Configuració manual de la clau API

Si utilitzes un servidor o contenidor sense interfície gràfica, o no vols fer servir l'autorització pel navegador, pots obtenir una clau API directament des de la consola d'Anthropic i configurar-la a Claude Code.

Passos:

1. Obre el navegador i ves a https://console.anthropic.com. Inicia sessió al teu compte d'Anthropic.

2. Ves a la pàgina de claus API (normalment a Configuració o Opcions de desenvolupador) i fes clic a "Crear clau API".

3. Posa un nom a la clau (per exemple, claude-code-local) i, un cop generada, copia-la immediatament.
   Nota: Aquesta clau només es mostra una vegada; si tanques la pàgina, no la podràs veure. Si l'oblides, elimina l'antiga i genera'n una de nova.

4. Torna al terminal. Hi ha dues maneres de proporcionar la clau a Claude Code:

A. Mitjançant variable d'entorn:

bash export ANTHROPIC_API_KEY=la-teva-clau-api

Afegeix aquesta línia al teu ~/.bashrc o ~/.zshrc perquè s'apliqui automàticament cada cop.

B. Escrivint-la al fitxer de configuració:

Claude Code també llegeix el seu propi fitxer de configuració. Edita manualment ~/.claude/config.json (si no existeix, crea'l) i escriu-hi:

json { "apiKey": "la-teva-clau-api" }

Nota: Es recomana establir els permisos d'aquest fitxer a 600 (chmod 600 ~/.claude/config.json) per evitar que altres usuaris el llegeixin.

1. Prova la connexió:

bash claude "Hola, respon amb un 'OK'"

Si reps una resposta normal, la clau està configurada correctament.

Errors habituals en la configuració manual:

• La clau no ha de començar per sk-ant- o sk-? No, la clau API d'Anthropic efectivament comença per sk-ant-api03- i és una cadena llarga. En copiar-la, no et deixis cap caràcter.
• Si estableixes tant la variable d'entorn com el fitxer, la variable d'entorn té prioritat. Mantén només una de les dues opcions per evitar confusions.
• La clau és una credencial de pagament; no la pujis a repositoris Git. Es recomana afegir ~/.claude al fitxer .gitignore per ignorar tot el directori o el fitxer de configuració.

Canviar de compte o tancar sessió

Per canviar de compte o eliminar les credencials locals:

• Si has utilitzat claude login: executa claude logout i, després, torna a executar claude login.
• Si has configurat la clau manualment: elimina la variable d'entorn o la clau antiga del fitxer de configuració i substitueix-la per la nova.

Comprovar que l'autenticació funciona

claude "Explica per a què serveix el directori actual"

Si pot llegir la informació del teu projecte, l'entorn està a punt.