Saltar al contenido
← Blog
IA y Herramientas

Escrito por Denys Havryliak

Claude Code con Xcode: Guía de Flujo de Trabajo 2026 para Ingenieros iOS

Configura Claude Code para Xcode en 2026: instalación, uso junto a Xcode, automatización de SwiftLint y los slash commands y hooks que ahorran horas de verdad en proyectos iOS.

Claude AI logo

TL;DR

  • Claude Code no tiene plugin nativo para Xcode — funciona como CLI en el Terminal, junto a Xcode
  • Instálalo con el script de instalación oficial (se actualiza solo) o con Homebrew
  • Flujo estándar: Terminal en la raíz de tu proyecto → ejecuta claude → edita → Xcode recarga solo
  • Ejecuta /init una vez para generar un CLAUDE.md que documente tus convenciones de Swift
  • Añade un hook PostToolUse de SwiftLint para que cada edición respete el estilo
  • Impacto real en Applefy: dividir un ViewModel de 800 líneas lleva 12 minutos en vez de 90

Escrito por el equipo de Applefy — desarrollamos apps nativas de iOS en Swift y SwiftUI, y Claude Code forma parte de nuestro flujo de trabajo diario en todos los proyectos.

No existe un plugin de Xcode para Claude Code. Apple eliminó el soporte de plugins en Xcode hace años y no lo ha reabierto. Anthropic publica extensiones para VS Code y JetBrains. Xcode se queda sin nada.

Suena a problema. No lo es. El flujo basado en Terminal es más rápido de lo que la mayoría espera, y lo usamos en todos los proyectos iOS de Applefy. Así lo hacemos.

Por qué el Terminal gana al plugin (de momento)

Un plugin nativo mostraría los diffs dentro de Xcode y pasaría el contexto de la selección automáticamente. Útil, pero no imprescindible.

Claude Code en el Terminal ya te da revisión de diffs, mención de archivos con la arroba, slash commands y contexto completo del proyecto. Pierdes la integración visual. Ganas: cero mantenimiento de plugins, toda la potencia del CLI y un flujo que sobrevive a lo que sea que Apple cambie en Xcode 27.

Instalación

Dos caminos. Elige uno.

Recomendado (se actualiza solo): usa el script de instalación oficial de claude.ai/install.sh.

Homebrew (actualizaciones manuales): instala claude-code como cask.

Tras la instalación, claude está disponible de forma global en tu shell. Sin clave de licencia: inicia sesión con tu cuenta de Anthropic la primera vez que lo ejecutes.

Configuración del primer proyecto

Desde la raíz de tu proyecto (el directorio con el .xcodeproj o el Package.swift):

  1. Abre el Terminal y haz cd a tu proyecto
  2. Ejecuta claude
  3. Ejecuta el slash command /init

/init lee tu código y escribe un archivo CLAUDE.md. Este es, con diferencia, el paso más importante. Documenta tus convenciones — versión de Swift, arquitectura (MVVM, TCA, VIPER, la que uses), gestor de dependencias, nomenclatura, patrones de test — para que cada sesión futura tenga contexto sin que tengas que volver a explicarlo.

Sube CLAUDE.md a tu repositorio. Actualízalo cuando cambien los patrones. Tu equipo lo agradecerá.

Un ejemplo real de Applefy

En uno de nuestros proyectos recientes con cliente, el ViewModel de la pantalla de pago había crecido hasta las 800 líneas. Tres responsabilidades, ninguna separación. El clásico problema del código iOS a medio madurar.

A la antigua: un ingeniero sénior lee el archivo, esboza la división, refactoriza durante 90 minutos, ejecuta la batería de tests y arregla los imports rotos.

Con Claude Code:

"Divide CheckoutViewModel en tres archivos: PaymentMethodViewModel, OrderSummaryViewModel, ConfirmationViewModel. Mueve el estado compartido a un CheckoutCoordinator. Actualiza las llamadas y los tests. Sigue nuestros patrones MVVM existentes según CLAUDE.md."

Doce minutos desde el prompt hasta el PR mergeado. Mismo ingeniero, misma profundidad de revisión, misma cobertura de tests. Solo que escribiendo menos.

Ese es el patrón. El criterio del ingeniero no cambió. La velocidad de ejecución sí.

Flujos que ahorran tiempo de verdad

Los cuatro casos en los que Claude Code se gana el sueldo trabajando en iOS:

FlujoTiempo ahorradoNotas
Refactorizar entre archivos70–80%Renombrados, divisiones, migraciones de patrones
Generar boilerplate80–90%Modelos Codable, structs de red, delegados de tablas
Depurar errores de compilación50–70%Más rápido que Stack Overflow para problemas no triviales
Escribir tests60–80%Sigue los patrones de XCTest existentes según CLAUDE.md

Cómo configurar un hook de SwiftLint

La configuración con mayor retorno de todas las que usamos. En el .claude/settings.json de tu proyecto, registra un hook PostToolUse que ejecute swiftlint autocorrect después de cada llamada a las herramientas Edit o Write.

Después de cada edición de archivo, SwiftLint pasa el autocorrect. La salida de Claude respeta el estilo sin limpieza manual.

Slash commands que merecen la pena

ComandoCuándo usarlo
/initLa primera vez en un proyecto — genera CLAUDE.md
/clearSesión larga de compilación en Xcode, contexto cada vez más denso
/compact [notes]Resume antes de limpiar — mantiene el hilo
/modelCambia a Opus para lógica compleja, a Sonnet para ganar velocidad
/helpLista todo lo disponible

Claude Code vs Cursor vs GitHub Copilot en iOS

Hemos usado los tres trabajando en iOS. Nuestra opinión sincera:

HerramientaPunto fuerte en iOSPunto débil
Claude CodeRefactorización multiarchivo, contexto de todo el proyecto, hooksSin interfaz nativa en Xcode
CursorExperiencia de edición inlineConstruido sobre VS Code — quien trabaja en Xcode no aprovecha el IDE
GitHub CopilotAutocompletado en Xcode (limitado)Solo contexto de un archivo, sin capacidad de agente

Para el flujo de trabajo de Applefy — refactorización multiarchivo sobre código Swift en producción — gana Claude Code. Copilot está bien para autocompletar. Cursor es estupendo si de todas formas no trabajas en Xcode.

Lo que Claude Code no hace bien en iOS

Seamos directos: no confiamos en él para todo.

  • Decisiones de arquitectura. Propondrá patrones que parecen correctos y se rompen al escalar. Decide la arquitectura como humano y luego pide a Claude que la implemente.
  • Concurrencia. Los actors y async/await de Swift tienen casos límite que la IA resuelve mal sin que se note. Siempre lo revisa un ingeniero.
  • Código sensible a la memoria. Ciclos de retención en closures. Perfila con Instruments antes de publicar.
  • Correcciones por rechazos de la App Store. Interpretar las guidelines es trabajo humano. (Consulta nuestra guía para publicar en la App Store.)

El patrón: Claude Code es un becario sénior. Brillante ejecutando. Poco fiable con el criterio.

Preguntas frecuentes

¿Existe un plugin de Claude Code para Xcode?

No. La falta de soporte de plugins por parte de Apple lo hace inviable. Ejecuta Claude Code en el Terminal junto a Xcode: es el flujo estándar en iOS a fecha de 2026.

¿Xcode detecta automáticamente los cambios de archivos hechos por Claude Code?

Sí. Xcode detecta los cambios externos en los archivos y recarga. No hace falta sincronizar a mano.

¿Funciona Claude Code con proyectos de SwiftPM y CocoaPods?

Con ambos. Al CLI le da igual tu gestor de dependencias.

¿Puedo ejecutar Claude Code desde el panel de terminal de Xcode?

Sí — abre Xcode → View → Show Terminal, o cualquier ventana del Terminal situada en el directorio del proyecto.

¿Debería subir CLAUDE.md a git?

Sí. Tu equipo se beneficia de compartir convenciones. Actualízalo cuando cambien los patrones.

¿Claude Code funciona igual de bien con SwiftUI y con UIKit?

Sí, con matices. Los patrones de SwiftUI son más verbosos y Claude Code se maneja bien con ellos. El código de UIKit, cargado de delegados, necesita contexto extra: asegúrate de que tu CLAUDE.md describa tus convenciones de delegados.

¿Cómo se compara Claude Code con las funciones de IA integradas en Xcode en 2026?

La función Intelligence de Xcode se ocupa del autocompletado inline y de pequeñas terminaciones. Claude Code se ocupa del trabajo a nivel de agente — refactorizar, editar varios archivos, escribir tests. Se complementan más que compiten.

¿Qué modelo debería usar para trabajar en iOS?

Sonnet para ediciones rutinarias y boilerplate. Opus para trabajo cercano a la arquitectura o cuando la refactorización toca más de 5 archivos. Usa /model para cambiar.

¿Puede Claude Code ejecutar mis builds de Xcode?

Con permiso, sí — puede ejecutar comandos xcodebuild. Lo usamos poco porque las builds de Xcode son lentas; normalmente es más rápido compilar en el propio Xcode.

Estoy contratando ingenieros iOS, ¿deberían conocer Claude Code?

Sí, y no por el motivo que la mayoría piensa. (Consulta nuestra guía de contratación iOS.) La señal real es si lo usan como herramienta o como muleta.

Artículos relacionados

Trabaja con Applefy
Hablemos

Reserva una llamada con nuestro CEO

Retrato de Denys Havryliak, fundador y CEO de Applefy

Denys Havryliak

Fundador y CEO

  • Más de 10 años en ingeniería de software
  • Máster en ciberseguridad
  • Conocimiento profundo y actual de las herramientas de IA

Hablarás con quien construye. Denys trabaja de forma práctica en producto, arquitectura y entrega, y sigue de cerca lo que las herramientas de IA de hoy pueden hacer de verdad en producción, no solo en una demo.