Resum ràpid: La instal·lació de Claude Code a Windows requereix configurar WSL2 (Windows Subsystem for Linux), instal·lar Ubuntu i executar un simple script d'instal·lació. El procés permet als usuaris de Windows accedir a l'assistent de codificació d'IA d'Anthropic a través del seu terminal. Hi ha binaris natius per a Windows disponibles, tot i que WSL2 segueix sent la millor pràctica per a la instal·lació a Windows.
Claude Code és un assistent de codificació basat en IA que opera directament al terminal, ajudant els desenvolupadors a crear funcions, corregir errors i automatitzar tasques de desenvolupament. Però hi ha un inconvenient per als usuaris de Windows.
Claude Code està disponible com a executable natiu per a Windows i es pot instal·lar via npm o mitjançant una descàrrega binària directa sense WSL2. No obstant això, requereix el Windows Subsystem for Linux (WSL2), i el mètode d'instal·lació oficial encara es basa en WSL2.
Així és com podeu fer-lo funcionar a Windows 11 o Windows 10.
Requisits del sistema
Abans de començar la instal·lació, verifiqueu que la màquina Windows compleix aquests requisits:
- Windows 10 1809+ o Windows Server 2019+
- Windows 11 (qualsevol versió)
- Almenys 4 GB de RAM disponible
- Privilegis administratius al sistema
- Connexió a Internet per descarregar WSL2 i Ubuntu
La instal·lació requereix espai al disc per a WSL2, Ubuntu i Claude Code.
Pas 1: Habilita el Windows Subsystem for Linux
WSL2 proporciona un entorn Linux directament dins de Windows. És la base que permet que Claude Code funcioni.
Obriu PowerShell com a Administrador. Feu clic dret al botó d'inici i seleccioneu "Windows PowerShell (Admin)" o "Terminal (Admin)" a Windows 11.
Executeu aquest comandament:
wsl --install
Aquest comandament habilita les funcions necessàries de Windows i instal·la Ubuntu com a distribució Linux predeterminada. És probable que el sistema demani un reinici.
Després de reiniciar, WSL2 completa la configuració automàticament. Ubuntu es llança i demana un nom d'usuari i una contrasenya. Aquestes credencials són només per a l'entorn Linux; no necessiten coincidir amb les credencials de Windows.
Pas 2: Verifica la instal·lació de WSL2
Un cop el sistema es reiniciï i Ubuntu finalitzi la seva configuració inicial, verifica que WSL2 s'està executant correctament.
Obre el terminal d'Ubuntu (cerca "Ubuntu" al menú d'inici) i executa:
wsl --version
Això mostra la informació de la versió de WSL. Busca "WSL version: 2.x.x" a la sortida.
Si el comandament mostra WSL1 en lloc d'això, actualitza a WSL2 amb:
wsl --set-default-version 2
Pas 3: Instal·la Claude Code
Ara anem a la instal·lació real de Claude Code. La documentació oficial proporciona un script d'instal·lació d'una sola línia.
Al terminal d'Ubuntu, executa:
curl -fsSL claude.ai/install.sh | bash
El script descarrega el binari de Claude Code, estableix els permisos necessaris i l'afegeix al PATH del sistema. La durada de la instal·lació varia segons la velocitat d'Internet i les especificacions del sistema.
Segons la documentació oficial de Claude Code, l'instal·lador detecta automàticament l'arquitectura del sistema i descarrega la versió binària adequada.
Problemes comuns d'instal·lació
Alguns usuaris de Windows informen que veuen "command not found: claude" després de la instal·lació. Això sol passar perquè la variable PATH no s'ha actualitzat.
Tanca i torna a obrir el terminal d'Ubuntu, i després torna a provar-ho. Si el problema persisteix, aquesta configuració de ruta pot ajudar com a solució no oficial:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Pas 4: Autentica Claude Code
Claude Code requereix autenticació amb un compte d'Anthropic abans d'utilitzar-lo.
Executa aquest comandament:
claude
El terminal mostra una URL i demana autenticació. El procés varia lleugerament per a usuaris individuals en comparació amb comptes d'equip:
| Tipus de compte | Mètode d'autenticació | Què es requereix |
|---|---|---|
| Individual | Clau API personal | Compte d'Anthropic amb accés API |
| Equip/Organització | Token d'organització | Token d'autenticació proporcionat per l'administrador |
Obre la URL proporcionada en un navegador, inicia sessió al compte d'Anthropic i autoritza Claude Code. El terminal confirma l'autenticació correcta.
Treball amb projectes de Windows a WSL2
Aquí és on les coses es posen complicades. Els sistemes de fitxers de Windows i els sistemes de fitxers de WSL2 estan separats.
Els fitxers de Windows són accessibles des de WSL2 a /mnt/c/ (per a la unitat C:), /mnt/d/ (per a la unitat D:), etc. Però hi ha un cost de rendiment. Les discussions de la comunitat indiquen diferències de rendiment entre els directoris muntats a Windows i els directoris nadius de WSL2.
Per obtenir el millor rendiment, copia els fitxers del projecte al directori d'inici de WSL2:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
El compromís? La integració de l'IDE es torna més complexa. Visual Studio Code ho gestiona bé amb la seva extensió Remote-WSL, però altres IDEs poden tenir problemes.
Prova de la instal·lació
Verifica que Claude Code funciona correctament amb una prova senzilla.
Navega a un directori de projecte (o crea una carpeta de prova):
mkdir ~/claude-test
cd ~/claude-test
claude "crea un simple script de Python 'hello world'"
Claude Code hauria de respondre, crear el fitxer i mostrar el codi. Això confirma que la instal·lació ha tingut èxit.
Deixa de pagar de més, reclama els crèdits d'IA disponibles primer
La instal·lació de Claude Code a Windows sol ser ràpida. El cost real apareix més tard quan els desenvolupadors comencen a provar prompts, a executar scripts i a integrar el model en aplicacions. Aquesta fase d'experimentació pot generar moltes trucades a l'API, i molts equips només s'adonen del cost després de començar a construir.
Abans de gastar diners en ús, val la pena comprovar si teniu dret a crèdits d'IA o programes de partners. Get AI Perks recopila aquestes oportunitats en un sol lloc, llistant crèdits i descomptes de proveïdors d'IA, plataformes cloud i eines per a desenvolupadors, juntament amb instruccions senzilles sobre com reclamar-los.
Abans d'executar el vostre primer projecte de Claude Code, consulteu Get AI Perks i reclameu els crèdits d'IA que poden cobrir els vostres costos de desenvolupament.
Preguntes freqüents
Pot Claude Code executar-se de forma nativa a Windows sense WSL2?
Sí, però WSL2 segueix sent el millor mètode d'instal·lació per a Windows.
Claude Code funciona amb el Terminal de Windows?
Sí. El Terminal de Windows pot obrir pestanyes d'Ubuntu, permetent l'accés a Claude Code sense canviar a una finestra d'Ubuntu separada. Al Terminal de Windows, feu clic a la fletxa desplegable i seleccioneu Ubuntu de la llista de perfils.
Les meves eines de desenvolupament existents de Windows funcionaran amb Claude Code?
Depèn de l'eina. Visual Studio Code s'integra bé mitjançant l'extensió Remote-WSL. Les IDE de JetBrains i altres eines poden requerir configuració addicional. La documentació oficial esmenta VS Code i JetBrains com a plataformes compatibles.
Com actualitzo Claude Code a Windows?
Claude Code s'actualitza automàticament per defecte. Per actualitzar manualment, executeu `claude update` al terminal d'Ubuntu. La funció d'actualització automàtica es pot desactivar mitjançant fitxers de configuració si cal per a entorns empresarials.
Quina és la diferència entre Claude Code i l'API de Claude?
Claude Code és un assistent de codificació basat en terminal que executa comandaments i edita fitxers. L'API de Claude proporciona accés programàtic al model de llenguatge de Claude per crear aplicacions personalitzades. Cobreixen diferents propòsits i requereixen diferents processos de configuració.
Puc utilitzar Claude Code amb projectes .NET a Windows?
Sí, però amb advertències. Les discussions de la comunitat indiquen que el suport del SDK de .NET a WSL2 funciona, però requereix la instal·lació de la versió Linux del SDK de .NET dins d'Ubuntu. El .NET instal·lat a Windows no serà accessible des de WSL2.
Quant costa Claude Code?
El preu depèn de l'ús i del tipus de compte. Consulteu el lloc web oficial d'Anthropic per conèixer els nivells de preus actuals i els plans per a equips, ja que els costos varien segons el consum de l'API i els requisits de l'organització.
Passos següents després de la instal·lació
Amb Claude Code instal·lat, comença a explorar les seves capacitats. La documentació de inici ràpid recomana començar amb tasques senzilles com ara explicacions de codi abans de passar a operacions més complexes.
Prova aquests comandaments per familiaritzar-te:
- claude "explica aquesta funció" -- Obtenir explicacions de codi
- claude commit -- Generar missatges de commit de Git
- claude -c -- Continuar la conversa més recent
La documentació oficial proporciona guies detallades per a la integració d'IDE, la instal·lació de plugins i opcions de configuració avançada. Per a equips, la configuració gestionada pel servidor i el seguiment d'analítiques ofereixen control addicional sobre les implementacions de Claude Code.
La configuració de WSL2 pot semblar passos addicionals en comparació amb les aplicacions natives de Windows, però actualment és l'única manera d'executar Claude Code a Windows. La bona notícia? Un cop configurat, funciona perfectament i s'integra amb la majoria dels fluxos de treball de desenvolupament.
