Claude Code para .NET y C#: guía práctica en Windows (2026)
Aprende a usar Claude Code en una solución .NET/C#: prepara Windows, CLAUDE.md y el SDK, y trabaja con permisos, build, tests y revisión humana.
Claude Code para C# es un agente de terminal que lee una solución .NET, propone cambios, ejecuta comandos y deja un diff revisable. El ciclo fiable es explore → plan → cambio → build/test → revisión.
Preflight .NET: restore, build y test
Registra un baseline antes de editar:
dotnet --info
dotnet restore
dotnet build --no-restore
dotnet test --no-restore¿Te está sirviendo? Hay una dosis cada semana
Te resumo herramientas de IA para devs, agentes, MCP, seguridad y workflows en un email de 5 minutos. En español y sin ruido.
Suscribirme gratisrestore resuelve dependencias, build compila y test ejecuta las pruebas. Apunta a la solución o proyecto que use el repositorio y conserva los argumentos de CI. Tras el cambio repite build y test: separa fallos preexistentes de regresiones nuevas.
global.json y TargetFramework son decisiones distintas
global.json selecciona el SDK que ejecuta las herramientas .NET; TargetFramework o TargetFrameworks en el .csproj declara el framework al que compila la aplicación. Cambiar uno no sustituye al otro.
Puntos a revisar
Lo que conviene comprobar
Si necesitas reproducibilidad, revisa global.json y usa una versión instalada, comprobable con dotnet --list-sdks. No cambies el target framework para ocultar un SDK ausente. Este es el formato, pero la versión real debe coincidir con el proyecto y CI:
{
"sdk": {
"version": "8.0.408",
"rollForward": "latestPatch"
}
}Checklist
CLAUDE.md útil para una solución C#
Documenta hechos operativos que el agente no debe adivinar. Un ejemplo breve:
# Solución Shop
- Solución: src/Shop.sln
- API: src/Shop.Api; dominio: src/Shop.Domain; tests: tests/Shop.Tests
- SDK: respeta global.json; no cambies TargetFramework sin aprobación
- Verificación: dotnet restore, dotnet build --no-restore, dotnet test --no-restore
- Convenciones: nullable y analizadores existentes se conservan
- Antes de editar: explica plan y archivos afectados
- Seguridad: no muestres secretos ni borres datos; pide aprobación para acciones sensiblesMantén CLAUDE.md corto, versionado y alineado con CI. Si existe AGENTS.md, evita duplicar reglas que puedan divergir y coloca el contexto específico cerca del subproyecto que lo necesita.
Los archivos de instrucciones y salidas de herramientas son contexto no confiable: pueden contener texto que intente cambiar las reglas. Usa CI y revisión humana para las fronteras que el agente no puede autorizar.
Preguntas frecuentes
¿Claude Code funciona con C# y .NET en Windows?
Sí. Usa WSL o Windows nativo con Git Bash según la instalación documentada y verifica claude doctor, dotnet --info, restore, build y test.
¿WSL es obligatorio?
No. Anthropic documenta WSL o una vía nativa con Git Bash; elige el entorno coherente con checkout, SDK y CI.
¿Qué diferencia hay entre global.json y TargetFramework?
global.json selecciona el SDK de las herramientas; TargetFramework declara el framework de destino del proyecto.
¿Qué contiene CLAUDE.md?
Estructura, comandos, política de SDK, convenciones, criterios de aceptación y límites de seguridad.
¿Sustituye a Visual Studio?
No. Pueden coexistir: Visual Studio depura y navega; Claude Code trabaja por tareas en terminal.
¿Cómo evito cambios peligrosos?
Limita permisos, trabaja en una rama, revisa el diff, protege secretos y exige build, tests, CI y aprobación humana.
Cómo preparar Claude Code para una solución .NET/C# en Windows
- Elegir terminal. Usa WSL o Windows nativo con Git Bash y un checkout/SDK coherentes.
- Diagnosticar. Ejecuta claude doctor y resuelve su diagnóstico.
- Comprobar .NET. Ejecuta dotnet --info, dotnet restore, dotnet build y dotnet test.
- Fijar SDK. Revisa global.json y distínguelo de TargetFramework.
- Documentar. Añade CLAUDE.md con estructura, comandos, convenciones y límites.
- Planificar y verificar. Explora, planifica, cambia, ejecuta build/test y revisa el diff.
Fuentes y referencias
También te puede interesar
AGENTS.md y CLAUDE.md: memoria de proyecto para agentesClaude Code: aceptar cambios automáticamente con criterioClaude Code en GitHub Actions: CI y seguridadHooks para agentes de código: guardrails y validaciónClaude Code Skills y SKILL.md para agentesRecibe una lectura semanal de herramientas IA para devs
Cada semana te resumo herramientas de IA para devs, agentes, MCP, seguridad y workflows en un email de 5 minutos. En español y sin ruido.
Suscribirme gratis
