Resum ràpid: Claude Code és un assistent de codificació d'IA basat en terminal que s'executa de forma nativa a macOS i Linux, o a Windows mitjançant WSL2. La seva configuració requereix la creació d'una clau API d'Anthropic, l'execució d'un instal·lador específic de la plataforma, l'autenticació amb la clau i la verificació de la instal·lació amb un comandament de prova.
Claude Code representa l'assistent de codificació oficial d'Anthropic basat en terminal. Viu directament a la línia de comandaments i s'encarrega de tot, des de la generació de codi fins a la correcció d'errors mitjançant comandes de llenguatge natural.
Però el procés de configuració no sempre és senzill. Els usuaris de Windows necessiten WSL2. L'autenticació de la clau API pot ser un obstacle per als nouvinguts. Els conflictes de versions passen.
Aquesta guia repassa el procés complet de configuració per a totes les plataformes, des dels requisits del sistema fins a la vostra primera sessió de codificació.
Què és realment Claude Code
Claude Code és una aplicació de terminal agent que s'integra amb entorns de desenvolupament. Entén bases de codi, executa tasques rutinàries i gestiona fluxos de treball de git mitjançant comandes conversacionals.
A diferència de les eines basades en navegador, Claude Code s'executa localment al terminal. Accedeix als fitxers del projecte directament, manté el context entre sessions i s'integra amb els fluxos de treball de desenvolupament existents. Segons la documentació oficial de Claude Code, l'eina es connecta a l'API d'Anthropic i admet la integració amb Amazon Bedrock, Google Cloud Vertex AI i Azure AI.
L'eina funciona de manera diferent dels assistents de codificació tradicionals. Sincerament, és més semblant a tenir un programador de parella al vostre terminal que a una eina de completat de codi.
Requisits del sistema per a Claude Code
Abans de la instal·lació, els sistemes han de complir requisits específics. Això és el que necessita cada plataforma:
| Plataforma | Requisits | Notes |
|---|---|---|
| macOS | macOS 13.0 o posterior | Suport natiu, instal·lació senzilla |
| Linux | Distribució de 64 bits amb glibc 2.28+ | Suport natiu per a la majoria de distribucions modernes |
| Windows | Windows 10 Build 19041+ o Windows 11 | Requereix la instal·lació prèvia de WSL2 |
Totes les plataformes necessiten una connexió a Internet estable per a les trucades a l'API. Les descàrregues de Claude Code solen requerir uns 50 MB, i WSL2 a Windows afegeix aproximadament 500 MB per al sub sistema Linux.
Pel que fa a l'emmagatzematge, espereu almenys 4 GB d'espai lliure. L'aplicació en si és petita, però l'espai per a dependències i fitxers del projecte és important.
Requisits específics de Windows
Claude Code pot executar-se a Windows a través de PowerShell o del Símbol del sistema si Node.js està instal·lat. L'eina requereix el subsistema de Windows per a Linux 2 per crear un entorn Linux.
Segons les guies d'instal·lació de claude.ai, els sistemes Windows 10 necessiten la versió 1903 o posterior amb la compilació 19041 o superior. Els usuaris de Windows 11 tenen el suport de WSL2 integrat. Es requereixen permisos d'administrador per a la configuració inicial de WSL2.
El procés implica habilitar la virtualització a la BIOS, activar les funcions de Windows i instal·lar una distribució de Linux. Ubuntu 22.04 LTS és la distribució recomanada per a la compatibilitat.
Instal·lació de Claude Code: Procés pas a pas
El procés d'instal·lació varia segons la plataforma. Aquesta és la manera d'executar Claude Code a cada sistema operatiu.
Instal·lació a macOS i Linux
Les instal·lacions de macOS i Linux segueixen el mateix patró. Ambdues plataformes admeten la instal·lació nativa sense configuració addicional.
El procés comença amb la descàrrega de l'instal·lador. Obriu un terminal i executeu:
curl -fsSL claude.ai/install.sh | sh
L'script detecta el sistema operatiu, descarrega el binari adequat i instal·la Claude Code al directori bin local. La instal·lació normalment es completa en menys de dos minuts amb una connexió estable.
Per als sistemes sense curl, wget funciona com a alternativa. L'instal·lador afegeix Claude Code a la variable PATH del sistema automàticament.
Instal·lació a Windows mitjançant WSL2
La instal·lació de Windows requereix la configuració prèvia de WSL2. Aquest és el procés complet:
Obriu PowerShell com a Administrador i habiliteu WSL:
wsl –install
Aquesta comanda habilita les funcions necessàries de Windows, descarrega el nucli WSL2 i instal·la Ubuntu per defecte. El sistema demanarà reiniciar. Després de reiniciar, Ubuntu s'iniciarà automàticament per completar la configuració de l'usuari.
Creeu un nom d'usuari i una contrasenya quan se us demani. Aquestes credencials són per a l'entorn Linux, separades de les dades d'inici de sessió de Windows.
Un cop WSL2 estigui en marxa, s'aplica el procés d'instal·lació de Linux. Al terminal d'Ubuntu, executeu la comanda curl de la secció de macOS/Linux anterior.
L'instal·lador s'encarrega de la resta. Claude Code s'instal·la dins de l'entorn WSL2 i s'executa a través del terminal d'Ubuntu.
Obtenir una clau API d'Anthropic
Claude Code requereix una clau API d'Anthropic per a l'autenticació. La clau connecta la instal·lació local als servidors d'Anthropic.
Visiteu la Consola d'Anthropic a console.anthropic.com. Creeu un compte o inicieu sessió amb les credencials existents. Navegueu a Claus API a la configuració del compte.
Feu clic a "Crear clau" per generar una nova clau API. La clau apareix una vegada; copieu-la immediatament. Anthropic no mostra la clau completa de nou després de sortir de la pàgina.
Emmagatzemeu la clau de manera segura. Proporciona accés complet a l'API d'Anthropic i a qualsevol facturació associada.
Comprensió dels costos de l'API
Claude Code opera amb un model de pagament per ús a través de l'API d'Anthropic. Basant-se en dades de les guies d'instal·lació de claude.ai, els costos varien segons el model:
| Model | Cost d'entrada | Cost de sortida |
|---|---|---|
| Claude Opus 4.6 | 5 $ per milió de fitxes | 25 $ per milió de fitxes |
| Claude Sonnet 4.6 | 3 $ per milió de fitxes | 15 $ per milió de fitxes |
La compra mínima per activar la facturació és de 5 $, tot i que les discussions de la comunitat suggereixen que 20-30 $ proporciona un millor marge per a proves. Les opcions de subscripció alternatives inclouen Claude Pro a 20 $ mensuals o Claude Max a 100 $ mensuals per a un ús intensiu.
El comportament per defecte utilitza Opus fins a assolir el 50% dels límits d'ús, i després canvia a Sonnet per a l'eficiència de costos.
Autenticació i primer llançament
Després de la instal·lació, Claude Code necessita autenticació abans del primer ús. Inicieu Claude Code executant:
claude
El primer llançament demana la clau API. Enganxeu la clau de la Consola d'Anthropic i premeu Intro. Claude Code valida la clau i l'emmagatzema de forma segura en fitxers de configuració locals.
L'autenticació persisteix entre sessions. La clau API no necessita ser introduïda de nou tret que s'elimini explícitament o quan es canviïn els comptes.
Per verificar que l'autenticació ha funcionat, Claude Code mostra un missatge de benvinguda i un prompt de comandes. La interfície mostra les comandes disponibles i confirma la connexió a l'API d'Anthropic.
Configuració de preferències de model
Claude Code utilitza per defecte la selecció automàtica de models, però és possible la configuració manual. Segons la documentació oficial, els usuaris poden ajustar la selecció de models mitjançant la comanda /model o establint la variable d'entorn CLAUDE_CODE_EFFORT_LEVEL.
El nivell d'esforç controla la profunditat de raonament per als models Opus 4.6 i Sonnet 4.6: baix, mitjà o alt. Els nivells d'esforç més alts augmenten la profunditat de raonament però també el cost i el temps de resposta.
Per a projectes que requereixen una anàlisi profunda, incloure "ultrathink" a les prompts estableix temporalment l'esforç a alt per a aquesta passada específica.
Verificació de l'èxit de la instal·lació
Després de l'autenticació, verifiqueu que Claude Code funciona correctament. Executeu aquestes proves bàsiques:
claude –help
claude –version
La comanda d'ajuda mostra les opcions i comandes disponibles. La sortida de versió confirma quina versió està instal·lada. Ambdues comandes s'han d'executar sense errors.
A continuació, proveu Claude Code en un directori de projecte. Creeu una carpeta de prova:
mkdir test-project
cd test-project
echo “# Projecte de prova” > README.md
claude
Dins de la sessió de Claude Code, proveu interaccions bàsiques:
- Escriviu "help" per veure les comandes disponibles
- Pregunteu "explica què pots fer"
- Demaneu "Resumeix aquest projecte"
- Proveu la comanda /help
Aquestes interaccions confirmen que Claude Code pot llegir fitxers del projecte i respondre a les prompts. Les respostes correctes signifiquen que la instal·lació és funcional.
Configuració de Claude Code per a projectes
Claude Code emmagatzema configuracions específiques del projecte en fitxers de configuració. Aquests fitxers personalitzen el comportament, defineixen la memòria i estableixen fluxos de treball.
El fitxer de configuració principal és CLAUDE.md a l'arrel del projecte. Aquest fitxer conté instruccions, context i directrius específiques del projecte que Claude Code consulta durant les sessions.
Creeu un fitxer CLAUDE.md bàsic:
# Context del projecte
Això és un [tipus de projecte] creat amb [tecnologies].
## Directrius clau
– [Regla important 1]
– [Regla important 2]
## Estructura del projecte
[Breu explicació de l'organització de carpetes]
El fitxer accepta format Markdown. Claude Code llegeix aquest context a l'inici de la sessió i el manté durant tota la conversa.
Opcions de configuració avançades
Més enllà del context bàsic, Claude Code admet configuració avançada a través del directori .claude. Aquest directori pot contenir:
- Habilitats: Capacitats especialitzades definides a .claude/skills/SKILL.md
- Comandes: Comandes de barra personalitzades a .claude/commands/*.md
- Hooks: Fluxos de treball automatitzats activats per esdeveniments
- Plugins: Funcionalitat ampliada mitjançant integració programàtica
Segons la documentació oficial de l'Agent SDK, aquestes funcions permeten una personalització sofisticada. Les habilitats defineixen capacitats reutilitzables. Les comandes creen dreceres per a tasques comunes. Els hooks automatitzen respostes a canvis de fitxers o ús d'eines.
Ús de Claude Code: Fluxos de treball bàsics
Amb la instal·lació completa, Claude Code gestiona tasques de desenvolupament comunes mitjançant llenguatge natural.
Inicieu una sessió navegant a un directori de projecte i executant:
claude
El prompt accepta sol·licituds en llenguatge natural. Alguns fluxos de treball comuns:
- Generació de codi: "Crea una funció Python que validi adreces de correu electrònic amb una gestió d'errors adequada."
- Correcció d'errors: "Aquesta funció està generant una excepció de punter nul. Pots identificar i corregir el problema?"
- Refactorització: "Refactoritza aquest component per utilitzar la injecció de dependències en lloc de la instanciació directa."
- Operacions de Git: "Crea una nova branca, commiteu aquests canvis amb un missatge descriptiu i feu un push a origin."
Claude Code manté el context al llarg de la sessió. Recorda les interaccions prèvies, fa un seguiment de les modificacions de fitxers i entén l'estructura general del projecte.
Comprensió del mode de pla
Per a canvis complexos, Claude Code ofereix el mode de pla. Aquest mode crea un pla d'execució detallat abans de fer modificacions.
Activeu el mode de pla afegint "plan:" a les sol·licituds o utilitzant la comanda /plan. Claude Code aleshores descriu els canvis proposats, explica el raonament i espera l'aprovació abans de l'execució.
El mode de pla és particularment útil per a la refactorització, canvis arquitectònics o modificacions que afecten diversos fitxers. Proporciona visibilitat sobre el que Claude Code pretén fer abans de comprometre's amb els canvis.
Integració amb VS Code i IDEs
Tot i que Claude Code s'executa al terminal, la integració amb editors de codi millora el flux de treball. L'extensió oficial de VS Code porta les capacitats de Claude Code directament a l'editor.
Instal·leu l'extensió des del mercat de VS Code. Cerqueu "Claude Code" i feu clic a Instal·lar. L'extensió afegeix un panell de Claude Code a la barra lateral.
Segons la documentació oficial de VS Code, l'extensió admet:
| Característica | Drecera | Descripció |
|---|---|---|
| Enfocament d'entrada | Cmd+Esc / Ctrl+Esc | Canvia entre editor i Claude |
| Obrir en nova pestanya | Cmd+Shift+Esc / Ctrl+Shift+Esc | Inicia una nova conversa com a pestanya |
| Obrir al terminal | – | Inicia el mode terminal des de VS Code |
L'extensió manté la paritat de funcions amb la versió de terminal, alhora que afegeix comoditats específiques de l'IDE com ara diferències en línia i referències de fitxers amb @-menció.
Actualització i gestió de Claude Code
Claude Code s'actualitza automàticament per defecte. L'aplicació comprova versions noves periòdicament i instal·la actualitzacions en segon pla.
Per actualitzar manualment, executeu:
claude –update
Això força una comprovació i instal·lació immediata de la versió més recent. El procés d'actualització conserva els fitxers de configuració i les credencials d'autenticació.
Per a les organitzacions que requereixen control de versions, les actualitzacions automàtiques es poden desactivar. Establiu la variable d'entorn CLAUDE_CODE_AUTO_UPDATE a fals o configureu-ho mitjançant configuració gestionada pel servidor.
Per instal·lar una versió específica, utilitzeu:
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
Substituïu X.Y.Z pel número de versió de destinació.
Problemes comuns de configuració i solucions
Diversos problemes s'esdevenen habitualment durant la configuració. Així és com resoldre'ls:
- Rebuig de la clau API: Si Claude Code rebutja la clau API, verifiqueu que no hi hagi espais ni caràcters addicionals. Torneu a copiar la clau de la Consola d'Anthropic. Comproveu que la facturació estigui activada; les claus no funcionaran sense un mètode de pagament registrat.
- Errors d'instal·lació de WSL2: Els sistemes Windows de vegades fallen en la instal·lació de WSL2 a causa de la configuració de virtualització. Introduïu la BIOS i habiliteu la virtualització (Intel VT-x o AMD-V). Assegureu-vos que la versió de Windows compleix els requisits mínims.
- Comanda no trobada: Si el terminal no reconeix la comanda claude, la variable PATH no s'ha actualitzat correctament. Tanca i torna a obrir el terminal. Per a problemes persistents, afegiu manualment el directori d'instal·lació a PATH.
- Temps d'espera de connexió: Les restriccions de xarxa o els tallafocs poden bloquejar les trucades a l'API. Claude Code requereix accés HTTPS a api.anthropic.com. Les xarxes corporatives poden necessitar configuració de proxy.
- Errors de permisos: Les instal·lacions de Linux i macOS ocasionalment tenen problemes de permisos. Executeu l'instal·lador amb els permisos adequats o instal·leu en un directori d'usuari en lloc d'ubicacions a nivell de sistema.
Comproveu els crèdits d'IA disponibles abans de configurar Claude Code
La configuració de Claude Code sol implicar experimentar: executar prompts, provar integracions i crear prototips petits abans que res vagi a producció. Aquesta etapa inicial sovint condueix a un ús intensiu de l'API. En lloc de pagar per cada sol·licitud de seguida, molts desenvolupadors primer busquen crèdits disponibles o programes d'inici que ajudin a reduir aquests costos inicials.
Get AI Perks recopila aquestes oportunitats en un sol lloc. La plataforma enumera crèdits d'IA, descomptes i programes de partners entre proveïdors d'IA, plataformes cloud i eines per a desenvolupadors, amb guies pas a pas que expliquen com reclamar-los. En total, la base de dades inclou avantatges de més de 200 eines i milions de dòlars en crèdits disponibles que les startups i els constructors poden sol·licitar.
Abans d'acabar de configurar Claude Code, consulteu Get AI Perks i reclameu els crèdits d'IA que poden cobrir els vostres primers experiments.
Preguntes freqüents
He de pagar per Claude Code?
Claude Code en si és un programari gratuït, però requereix una clau API d'Anthropic que opera amb un model de pagament per ús. L'activació mínima del compte és de 5 $, tot i que l'ús pràctic sol requerir 20-30 $ en crèdits. Els plans de subscripció alternatius com Claude Pro (20 $/mes) o Claude Max (100 $/mes) proporcionen estructures de preus diferents per a usuaris intensius.
Pot Claude Code funcionar completament fora de línia?
No. Claude Code requereix una connexió a Internet activa per comunicar-se amb els servidors de l'API d'Anthropic. L'aplicació processa les sol·licituds localment, però envia les prompts als models de Claude que s'executen a la infraestructura d'Anthropic. No hi ha mode fora de línia ni opció de model local.
Quina és la diferència entre Claude Code i Claude.ai?
Claude.ai és una interfície de xat basada en web per a interaccions generals amb Claude. Claude Code és una aplicació de terminal especialitzada dissenyada específicament per al desenvolupament de programari. Claude Code s'integra amb git, llegeix fitxers de projecte directament, manté un context de desenvolupament més llarg i inclou funcions específiques de codificació com el mode de pla i les capacitats d'edició de fitxers.
Com canvio entre els models de Claude?
Utilitzeu la comanda /model dins d'una sessió de Claude Code per canviar entre els models disponibles. La configuració per defecte utilitza Opus fins a arribar al 50% d'ús, i després canvia a Sonnet. La selecció manual permet triar models específics basats en els requisits de la tasca: Opus per a raonament complex, Sonnet per a respostes més ràpides i rendibles.
Puc utilitzar Claude Code a VS Code?
Sí. Una extensió oficial de VS Code porta la funcionalitat de Claude Code a l'editor. Instal·leu-la des del mercat de VS Code. L'extensió proporciona les mateixes capacitats que la versió de terminal amb integració addicional de l'IDE com diferències en línia, panells laterals i drecers de teclat per a un accés ràpid.
Claude Code emmagatzema el meu codi o les converses?
Segons les polítiques d'ús de dades d'Anthropic, les interaccions de l'API no s'utilitzen per entrenar models. Les organitzacions poden configurar polítiques de retenció de dades zero mitjançant la configuració empresarial. El codi i les prompts es transmeten als servidors d'Anthropic per processar-los, però el maneig depèn de la configuració del compte i les polítiques de retenció de dades.
Què passa si Claude Code comet un error?
Claude Code inclou funcions de seguretat com la integració amb git i el mode de pla per minimitzar errors. Per als errors que sí que ocorren, s'apliquen les pràctiques estàndard de control de versions: l'historial de git proporciona capacitat de retrocés. El sistema de permisos requereix aprovació per a operacions sensibles. Algunes discussions de la comunitat suggereixen taxes d'èxit en el rang del 80-90% per a tasques rutinàries, amb supervisió recomanada per a canvis crítics.
Avançant amb Claude Code
Claude Code transforma el desenvolupament basat en terminal integrant l'assistència d'IA directament a la línia de comandaments. La configuració requereix instal·lació específica de la plataforma, autenticació de l'API i configuració bàsica, però el procés és senzill seguint els passos correctes.
L'eina destaca en tasques de desenvolupament rutinàries, generació de codi i gestió de fluxos de treball de git. El mode de pla proporciona seguretat per a operacions complexes. La integració amb IDE estén les capacitats més enllà del terminal.
Comenceu amb tasques senzilles per entendre com Claude Code interpreta les sol·licituds. Aneu augmentant fins a fluxos de treball més complexos a mesura que creix la familiaritat. Utilitzeu la comanda /clear entre tasques diferents per mantenir un context net. Configureu fitxers CLAUDE.md per a orientació específica del projecte.
Els equips poden explorar configuracions gestionades pel servidor i mercats de plugins. Els desenvolupadors individuals es poden beneficiar d'habilitats i comandes personalitzades adaptades a patrons freqüents.
El repositori de GitHub a anthropics/claude-code conté exemples addicionals, plugins de la comunitat i recursos de resolució de problemes. La documentació oficial a docs.anthropic.com proporciona referències tècniques completes.
Ara és el moment de començar a codificar. Navegueu a un projecte, inicieu Claude Code i vegeu com el desenvolupament assistit per IA canvia el vostre flux de treball.
