Claude Code CLI Guia: Comandes, Configuració i Bones Pràctiques

Author Avatar
Andrew
AI Perks Team
14,899
Claude Code CLI Guia: Comandes, Configuració i Bones Pràctiques

Resum ràpid: Claude Code CLI és un assistent de codificació basat en terminal impulsat per IA que entén tot el vostre codi base, edita fitxers, executa comandes i s'integra amb eines de desenvolupament mitjançant llenguatge natural. Està disponible com a interfície de línia de comandes, extensió IDE, aplicació d'escriptori i interfície web, donant suport a fluxos de treball automatitzats, revisió de codi i operacions de git directament des de la vostra terminal.

Les interfícies de línia de comandes mai no han estat tan intel·ligents. Claude Code transforma la terminal d'un lloc on escriviu comandes arcàiques en un espai de treball interactiu on el llenguatge natural es troba amb l'execució de codi. Això no és un altre chatbot atrapat en una barra lateral; és una eina de codificació agent que viu on els desenvolupadors treballen realment.

L'eina llegeix tot el vostre codi base, entén el context del projecte, edita diversos fitxers simultàniament i executa comandes en nom vostre. Construït per Anthropic, Claude Code s'executa localment a la vostra terminal mentre es connecta a l'API de Claude per processar les sol·licituds. El resultat? Un assistent de codificació que gestiona tasques rutinàries, explica codi complex i gestiona fluxos de treball de git mitjançant comandes conversacionals.

Què fa diferent Claude Code CLI

Els assistents de codificació tradicionals d'IA ofereixen suggeriments d'autocompleció o responen preguntes en una finestra de xat. Claude Code opera a un nivell completament diferent. És un sistema agent, el que significa que pot planificar tasques de múltiples passos, executar-les autònomament i adaptar-se en funció dels resultats.

La CLI llegeix l'estructura del vostre projecte, entén les relacions dels fitxers i manté el context de la conversa entre sessions. Quan se li demana que corregeixi un error, Claude Code no només suggereix codi. Identifica el problema, modifica els fitxers rellevants, executa proves per verificar la correcció i fins i tot pot confirmar els canvis a git.

Segons la documentació oficial, Claude Code s'integra amb terminals, IDE (VS Code i JetBrains), aplicacions d'escriptori, navegadors i pipelines CI/CD. Aquesta flexibilitat significa que els desenvolupadors poden començar una tasca localment i continuar des del mòbil, o automatitzar les revisions de PR mentre codifiquen en el seu entorn preferit.

Instal·lació i configuració

Fer que Claude Code funcioni triga minuts. El procés d'instal·lació varia lleugerament segons la plataforma, però els passos principals segueixen sent coherents a Windows, macOS i Linux.

Requisits del sistema

Abans d'instal·lar, verifiqueu que el sistema compleix els requisits bàsics. Claude Code s'executa a versions recents de Windows, macOS i la majoria de distribucions de Linux. Alpine Linux i els sistemes basats en musl requereixen dependències addicionals segons la documentació de configuració avançada.

L'eina s'actualitza automàticament per defecte, obtenint la darrera versió a través de canals de llançament configurables. Els equips que necessiten control de versions poden desactivar les actualitzacions automàtiques i gestionar les instal·lacions manualment.

Procés d'instal·lació ràpida

La instal·lació comença descarregant el binari natiu per a la vostra plataforma. La documentació oficial proporciona instal·ladors específics de la plataforma que gestionen les dependències automàticament.

Després de la instal·lació, l'autenticació connecta la vostra CLI local a l'API d'Anthropic. Executeu l'ordre d'autenticació i seguiu les instruccions per enllaçar el vostre compte d'Anthropic. El procés emmagatzema les credencials de forma segura al vostre porta-claus del sistema.

Claude Code CLI installation workflow from download to first session

La verificació confirma que tot funciona correctament. L'ordre d'instal·lació valida el binari, comprova l'estat de l'autenticació i assegura que totes les dependències estiguin presents.

Comandes CLI essencials

L'estructura de comandes de Claude Code equilibra la senzillesa amb el poder. Les comandes bàsiques us permeten començar immediatament, mentre que les opcions avançades permeten fluxos de treball complexos.

Inici de sessions

La comanda més senzilla inicia una sessió interactiva. Simplement escriviu `claude` a la vostra terminal. Això inicia una conversa on Claude pot llegir el vostre codi base, editar fitxers i executar comandes.

Per a tasques puntuals, passeu una indicació directament: `Claude "explica aquest projecte"` inicia una sessió amb aquest missatge inicial. L'opció `-p` executa una consulta i surt immediatament, perfecta per a scripts.

ComandaComportamentCas d'ús
claudeInicia el mode interactiuTreball de desenvolupament general
claude "tasca"Sessió amb indicació inicialExecució de tasques centrades
claude -p "consulta"Consulta única, després surtPreguntes ràpides, scripts
cat fitxer | claude -p "analitza"Processa contingut enviatAnàlisi de registres, depuració
claude -cContinua la sessió anteriorReprendre feina interrompuda

Gestió de converses

L'opció `-c` continua la vostra conversa més recent. El context persisteix entre sessions: Claude recorda el que heu parlat, quins fitxers s'han editat i quines comandes s'han executat.

Per treballar en diverses funcionalitats simultàniament, l'opció `--worktree` crea worktrees de git aïllats. Cada worktree manté un estat de fitxer independent mentre comparteix l'historial de git, evitant que les instàncies de Claude interfereixin entre elles.

Opcions avançades

Diverses opcions modifiquen com es comporta Claude Code. L'opció `--ide` es connecta automàticament al vostre IDE si està disponible. L'opció `--from-pr` inicia una sessió vinculada a una sol·licitud de extracció específica, permetent fluxos de treball de revisió de codi automatitzats.

Les opcions de prompt del sistema modifiquen les instruccions de Claude. Aquestes opcions avançades permeten als equips personalitzar el comportament per a fluxos de treball específics o imposar estàndards organitzatius.

Treballar amb Claude Code a la pràctica

Entendre les comandes és una cosa. Utilitzar-les de manera efectiva requereix comprendre com Claude Code pensa sobre el codi.

Modes d'execució

Claude Code opera en diferents modes segons la tasca. El mode de planificació esbossa els passos abans d'executar. El mode de pregunta espera confirmació abans de fer canvis. El mode d'edició automàtica realitza canvis aprovats automàticament.

Les discussions de la comunitat d'usuaris experimentats indiquen que passen temps significatiu en mode de planificació per refinar els enfocaments abans de l'execució. Aquest flux de treball evita errors i assegura que Claude entengui la tasca correctament.

Comprensió del context i del codi base

Claude Code llegeix tota l'estructura del vostre projecte al començament de cada sessió. Identifica llenguatges de programació, frameworks, eines de compilació i dependències. Aquest context informa cada suggeriment i edició.

L'eina utilitza plugins d'intel·ligència de codi per a llenguatges tipificats, proporcionant una navegació precisa de símbols en lloc de cerca basada en text. Això redueix les lectures innecessàries de fitxers en explorar codi desconegut.

How Claude Code processes tasks from codebase analysis through execution

Operacions de fitxer i integració de Git

Claude Code edita fitxers directament, mostrant diferències abans d'aplicar canvis. Els desenvolupadors revisen les modificacions proposades i les aproven o rebutgen. L'eina gestiona diversos fitxers en una sola operació, mantenint la coherència en canvis relacionats.

La integració de Git és nativa. Claude pot crear branques, confirmar canvis amb missatges descriptius, fer push a repositoris remots i fins i tot crear sol·licituds de extracció mitjançant la integració de GitHub CLI. L'opció `--from-pr` permet la revisió de codi automatitzada, on Claude analitza els canvis de PR i suggereix millores.

Configuració i personalització

Claude Code admet la configuració en diversos àmbits: gestionat (a tot el sistema), usuari (configuració personal), projecte (a nivell de repositori) i local (específic de la màquina). La configuració es fa en cascada, amb àmbits més específics que anul·len els més amplis.

Fitxers de configuració

La configuració es troba en fitxers JSON. La configuració de l'usuari es troba a `~/.claude/`, la configuració del projecte a `.claude/` dins del repositori. Els equips confirmen la configuració del projecte al control de versions, assegurant un comportament coherent per a tots els col·laboradors.

La configuració disponible controla els permisos, l'aïllament, la selecció del model, les dreceres de teclat i la personalització de la interfície d'usuari. La documentació de configuració detalla cada opció i el seu àmbit.

Permisos i seguretat

Les regles de permisos defineixen què pot accedir Claude Code. Els desenvolupadors especifiquen directoris permesos, fitxers exclosos i restriccions de comandes. Això evita que l'eina accedeixi a dades sensibles o executi operacions perilloses.

La configuració d'aïllament afegeix una altra capa de seguretat. Els prefixos de ruta limiten les operacions de fitxer a directoris específics, útil quan es treballa en diversos projectes o en entorns compartits.

Gestió de costos i ús de tokens

Claude Code consumeix tokens d'API amb cada sol·licitud. Els codis base més grans i les tasques complexes utilitzen més tokens. L'ordre `/cost` mostra l'ús de la sessió actual i els costos estimats.

Segons la documentació de gestió de costos, els equips poden reduir l'ús de tokens gestionant el context de manera proactiva, triant els models adequats, reduint la sobrecàrrega del servidor MCP i instal·lant plugins d'intel·ligència de codi. La cerca d'eines difereix automàticament les descripcions d'eines quan superen el 10% de la finestra de context, carregant les eines a demanda en lloc de mantenir totes les definicions en context.

De mitjana, Claude Code costa aproximadament entre 100 i 200 dòlars per desenvolupador al mes amb Sonnet 4.6, tot i que els costos varien significativament segons els patrons d'ús.

Mida de l'equipTPM per usuariRPM per usuari
1-5 usuaris200k-300k5-7
5-20 usuaris100k-150k2.5-3.5
20-50 usuaris50k-75k1.25-1.75
50-100 usuaris25k-35k0.62-0.87
100-500 usuaris15k-20k0.37-0.47

Les recomanacions de límit de taxa varien segons la mida de l'equip. Els equips més petits poden assignar tokens per minut (TPM) i sol·licituds per minut (RPM) més alts per usuari, mentre que les organitzacions més grans distribueixen els límits de manera més conservadora.

Accedeix a crèdits d'IA abans d'executar Claude Code CLI a gran escala

Treballar amb Claude Code CLI sovint significa un ús continuat de l'API, especialment quan es creen scripts, automatitzacions o fluxos de treball de desenvolupadors al voltant dels LLM. Els costos poden augmentar ràpidament a mesura que creix l'ús, i molts desenvolupadors o equips comencen a pagar el preu complet sense comprovar si hi ha crèdits disponibles.

Get AI Perks agrega crèdits i descomptes per a més de 200 eines d'IA, núvol i desenvolupament en un sol lloc, amb un valor total disponible que supera els 7 milions de dòlars a través de programes. Per ara, els desenvolupadors poden accedir a ofertes com 500 dòlars en crèdits d'Anthropic per a fundadors i fins a 15.000 dòlars en crèdits de Claude per a participants seleccionats. La plataforma mostra les condicions, la probabilitat d'aprovació i com sol·licitar-ho, de manera que els desenvolupadors puguin veure ràpidament quins programes val la pena seguir. 

 Abans d'escalar el vostre ús de Claude o integrar-lo més profundament al vostre flux de treball, consulteu Get AI Perks i reclameu qualsevol crèdit que us qualifiqueu primer.

Integració amb eines de desenvolupament

Claude Code s'estén més enllà de la terminal. L'extensió VS Code porta Claude a l'editor amb diferències en línia, referències de fitxers mitjançant @-mencions i dreceres de teclat. Els IDE de JetBrains obtenen una integració similar.

L'extensió de Chrome permet depurar aplicacions web en directe. L'aplicació d'escriptori proporciona una interfície autònoma per als equips que prefereixen GUI a CLI. El control remot permet als desenvolupadors continuar sessions entre dispositius: comenceu a treballar a l'escriptori, continueu des del mòbil.

La integració CI/CD automatitza els fluxos de treball. GitHub Actions i GitLab CI/CD poden activar Claude Code per a revisions de PR, triatge d'incidències i proves automatitzades. La integració de Slack enruta els informes d'errors directament a les sol·licituds de extracció.

Millors pràctiques de la comunitat

Els patrons d'ús del món real revelen estratègies efectives. Les experiències dels usuaris dels repositoris de la comunitat destaquen diverses pràctiques:

Passeu temps refibrant els plans abans de l'execució. La fase de planificació determina l'èxit: córrer a fer edicions sense una direcció clara porta a tokens malgastats i resultats pobres.

Utilitzeu el checkpointing per a tasques llargues. Claude Code admet checkpoints que guarden l'estat de la conversa, permetent la recuperació si les sessions fallen o necessiten una pausa.

Personalitzeu la línia d'estat. Els usuaris avançats configuren pantalles d'estat que mostren el model, el directori, la branca de git, els fitxers no confirmats i l'ús de tokens. Aquesta informació ajuda a monitoritzar el consum de context en temps real.

Aprofiteu els hooks i les habilitats. Els hooks són scripts que s'executen en punts específics del flux de treball (inici de sessió, abans d'edició, després de comandes). Les habilitats són instruccions reutilitzables emmagatzemades per separat del prompt principal. Tant els uns com els altres redueixen la repetició i milloren la coherència.

Preguntes freqüents

Quant costa Claude Code?

Segons la pàgina de preus oficial, Claude Code s'inclou al pla Pro per 17 dòlars al mes amb subscripció anual (o 20 dòlars si es factura mensualment). El pla gratuït inclou Claude Code amb ús limitat. Els preus de l'API varien segons el model: Claude Opus 4.5 costa 5 dòlars per milió de tokens d'entrada i 25 dòlars per milió de tokens de sortida. Consulteu la pàgina de preus oficial per a les tarifes actuals, ja que canvien amb freqüència.

Pot Claude Code funcionar fora de línia?

No. Claude Code requereix una connexió a Internet per comunicar-se amb l'API d'Anthropic. L'eina s'executa localment però envia sol·licituds a servidors al núvol per al processament. Els equips amb requisits estrictes de fora de línia no poden utilitzar Claude Code en la seva forma actual.

Claude Code emmagatzema el meu codi?

Anthropic ofereix zero retenció de dades per als clients empresarials. La documentació d'ús de dades explica que les converses es poden configurar per eliminar-se immediatament després del processament. Les polítiques de retenció per defecte varien segons el pla; consulteu la documentació actual per a més detalls.

Quins models admet Claude Code?

Claude Code funciona amb els models Claude Opus, Sonnet i Haiku. La selecció del model equilibra el rendiment i el cost. Els equips poden configurar models per defecte a la configuració o canviar de model a mig sessió. La documentació de configuració del model cobreix les opcions disponibles.

Poden diversos membres de l'equip utilitzar Claude Code al mateix codi base?

Sí. Els worktrees de Git permeten sessions paral·leles sense conflictes. Cada desenvolupador crea un worktree separat per a la seva tasca. L'opció `--worktree` gestiona això automàticament. La configuració del projecte garanteix un comportament coherent entre els membres de l'equip.

Com actualitzo Claude Code?

Claude Code s'actualitza automàticament per defecte. L'eina comprova noves versions a l'inici i les instal·la automàticament. Els equips poden desactivar les actualitzacions automàtiques i gestionar les versions manualment mitjançant la configuració. Els canals de llançament (estable, beta) controlen quines actualitzacions s'instal·len.

Quina és la diferència entre Claude Code i GitHub Copilot?

GitHub Copilot proporciona suggeriments d'autocompleció mentre escriviu. Claude Code és un sistema agent que planifica i executa tasques de múltiples passos. Copilot ajuda amb línies o funcions individuals. Claude Code gestiona funcionalitats completes, refactoritzacions, correccions d'errors i automatització de fluxos de treball. Les eines es complementen mútuament: molts desenvolupadors utilitzen ambdues.

Avançar amb Claude Code

Claude Code representa un canvi en la manera com els desenvolupadors interactuen amb els assistents de codificació d'IA. La CLI posa les capacitats agents directament a la terminal, on el context és més ric i els fluxos de treball són més ràpids.

Començar triga minuts. La instal·lació, l'autenticació i la primera sessió es realitzen en una sola sessió. Però la mestria requereix experimentació. Proveu diferents modes, configureu permisos, configureu hooks i personalitzeu la configuració per adaptar-vos al vostre flux de treball.

L'eina evoluciona ràpidament. Funcions com subagents, integració del servidor MCP i checkpointing millorat amplien les capacitats regularment. Seguir el registre de canvis oficial us manté al dia amb les noves funcionalitats.

Per als equips que consideren l'adopció, comenceu petit. Executeu Claude Code en un sol projecte, establiu patrons i després amplieu. Documenteu la vostra configuració a la configuració del projecte perquè tot l'equip es beneficiï d'un comportament optimitzat.

A punt per transformar el vostre flux de treball de desenvolupament? Descarregueu Claude Code de la documentació oficial, autentiqueu el vostre compte i inicieu la vostra primera sessió. El futur de la codificació és conversacional, i s'executa a la vostra terminal.

AI Perks

AI Perks ofereix accés a descomptes exclusius, crèdits i ofertes en eines d'IA, serveis al núvol i API per ajudar startups i desenvolupadors a estalviar diners.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.