Introducción a la IA 2. Configuración del entorno macOS para AI-vibecoding en Claude Code

Esta lección describe el orden correcto para preparar macOS para trabajar con Claude Code (Codex), GitHub, Python, JavaScript, audio, servicios de Google, plugins, MCP, AGENTS.md, skills y la estructura de carpetas de comandos.

Paso 1. macOS actual y una cuenta de macOS con privilegios de administrador

Antes de configurar el entorno para AI-vibecoding en Claude Code (Codex), hay que asegurarse de que el propio ordenador esté preparado para este trabajo a nivel del sistema operativo.

1. Usar una macOS moderna

Es necesario trabajar con Claude Code (Codex) únicamente en una versión actual y moderna de macOS 26 Tahoe con soporte de actualizaciones. No se debe trabajar en versiones antiguas del sistema operativo de hace 3-5 años.

Una macOS antigua casi inevitablemente provocará problemas:

errores de acceso;
errores de permisos;
incompatibilidad con herramientas de desarrollo modernas;
problemas al instalar paquetes y dependencias;
funcionamiento inestable del terminal, navegadores, IDE, Claude Code (Codex) y herramientas relacionadas.

Para AI-vibecoding es importante que el sistema admita versiones modernas de developer tools, herramientas shell, navegadores, Node.js, Python, Docker/OrbStack, GitHub CLI y otros componentes del entorno.

2. Instalar todas las actualizaciones disponibles de macOS

No basta con tener una macOS nueva. Antes de empezar a configurar el entorno de IA en su Desktop o Laptop, debe instalar todas las actualizaciones del sistema disponibles al día de hoy.

La comprobación se realiza mediante:

System Settings -> General -> Software Update

Si macOS ofrece actualizaciones, deben instalarse antes de configurar el entorno de Claude Code (Codex).

Esto reduce el riesgo de errores accidentales relacionados con:

bibliotecas del sistema obsoletas;
security updates incompletas;
incompatibilidad de Xcode Command Line Tools;
problemas con permisos;
funcionamiento inestable del terminal, scripts shell y package managers.

3. Trabajar desde la cuenta principal de administrador

El entorno de AI-vibecoding debe configurarse y utilizarse desde la cuenta principal de macOS con privilegios de administrador.

No debe iniciarse la configuración desde una cuenta limitada, una cuenta guest o un perfil sin acceso admin.

Los privilegios de administrador son necesarios para:

instalar developer tools;
instalar Homebrew y dependencias del sistema;
configurar el shell y las rutas;
gestionar los permisos de macOS;
instalar navegadores, IDE, herramientas CLI y servicios locales;
resolver problemas de acceso a archivos, certificados, claves y servidores locales.

Regla

El primer paso antes de cualquier instalación:

macOS debe ser moderna, estar completamente actualizada y utilizarse desde una cuenta de administrador.

Si no se cumple esta condición, es mejor no iniciar la configuración del entorno para Claude Code (Codex): los errores posteriores parecerán problemas de Claude Code, Node.js, Python, Git o Homebrew, aunque en realidad la causa será un sistema no preparado.

Paso 2. Instalar Claude Code y crear una carpeta de proyectos de trabajo

Después de comprobar macOS, las actualizaciones y los privilegios de administrador, el siguiente paso es instalar Claude Code (Codex) y preparar un lugar en el sistema de archivos donde estarán los proyectos para AI-vibecoding.

1. Dónde guardar los proyectos de Claude Code en macOS

En macOS, el equivalente de la habitual carpeta "Mis documentos" es:

~/Documents

Para trabajar con Claude Code (Codex), es mejor crear dentro de ella una carpeta separada:

~/Documents/Claude
~/Documents/Codex

Precisamente ahí conviene guardar las carpetas de proyectos con las que trabajará Claude Code:

~/Documents/Claude/
  AI/
  Product/
  Project-1/
  Project-2/
  Product-docs/
  Experiments/

Para el onboarding básico del equipo se pueden crear de inmediato dos carpetas iniciales:

~/Documents/Claude/
  AI/
  Product/

AI es una carpeta para configurar Claude Code, formación, documentos de handoff, experimentos con herramientas de IA y materiales sobre AI-workflow.

Product es una carpeta para trabajo de producto: PRD, especificaciones, transcripciones, documentos Markdown, base de conocimientos y archivos que luego pueden sincronizarse con GitHub, Confluence u otros sistemas del equipo.

Es mejor escribir los nombres de las carpetas en alfabeto latino: AI, Product, Claude. Así hay menos probabilidades de encontrar problemas en scripts shell, rutas, CI, package managers y herramientas de desarrollo.

Por qué es mejor usar precisamente `~/Documents/Claude, y no carpetas aleatorias en el escritorio o en Downloads:

la ruta es clara para la persona y para el agente;
permisos de acceso correctos para carpetas y archivos en proyectos de IA (lo más importante);
los proyectos se encuentran en un único lugar predecible;
hay menor riesgo de perder archivos entre descargas y documentos temporales;
es más cómodo dar contexto a Claude: "trabaja en el proyecto de ~/Documents/Claude/...";
es más fácil hacer copias de seguridad;
es más fácil trasladar la estructura de trabajo a un Mac nuevo.

La carpeta puede crearse mediante Finder o Terminal:

mkdir -p "$HOME/Documents/Claude"

2. Instalar Claude Code CLI

Claude Code CLI se necesita para trabajar desde el terminal: abrir la carpeta de un proyecto, ejecutar claude, dar una tarea al agente, permitirle leer archivos, modificar código y ejecutar comandos.

La forma oficial actual de instalación en macOS/Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Después de la instalación hay que comprobar que el comando está disponible:

codex --version

Después se puede ir a la carpeta de trabajo e iniciar Claude Code (Codex):

cd "$HOME/Documents/Claude Code (Codex)"
codex

En el primer inicio, Claude Code (Codex) pedirá iniciar sesión mediante una cuenta de ChatGPT o una OpenAI API key.

3. Instalar Claude Code desktop app

Después de la CLI, en macOS es necesario instalar Claude Code (Codex) desktop app. Para trabajar plenamente con la infraestructura de IA necesita precisamente la versión desktop de Claude, que contiene Claude Code y Claude Co-work. Trabajar con Claude únicamente mediante la versión de navegador limita considerablemente sus posibilidades.

Claude Code (Codex) app se requiere para:

trabajar con carpetas y archivos instalados localmente
trabajar con lenguajes de programación instalados localmente
trabajar plenamente con plugins y con conexión a servicios de Google, Atlassian, Github
coding y vibecoding
utilizar la interfaz de voz y la interfaz de imágenes/capturas de pantalla en coding
trabajar con varios proyectos;
ejecutar actions como dev server, tests, build;
un AI-vibecoding cotidiano más cómodo que usar solo el terminal.

Al instalar Codex Desktop app en un Mac con Apple Silicon hay que elegir la compilación para Apple Silicon. En un Mac con procesadores Intel Core, la compilación para Intel.

4. Cómo debe verse la estructura básica en Mac

La estructura mínima de carpetas locales en el primer paso:

~/Documents/Claude/
  AI/
  Product/

El usuario crea en la carpeta principal Claude dentro de Documents las carpetas de sus proyectos:

cd "$HOME/Documents/Claude/Product"
claude

Y luego añade estos proyectos en Claude Code desktop app mediante Project -> Use an existing folder.

Importante: si la carpeta se crea para un proyecto con el que ya trabaja un equipo, no se deben escribir ahí archivos aleatorios de inmediato. Es necesario encontrar el GitHub repository correspondiente al proyecto y llenar el contenido del proyecto desde ese GitHub repository.

De lo contrario, es muy fácil acabar con dos versiones "actuales" diferentes del proyecto.

5. Regla

El segundo paso de la configuración:

Instalar Claude Code CLI, instalar Claude Code Desktop App y crear una carpeta de trabajo permanente `~/Documents/Claude para todos los proyectos con los que trabajará Claude Code.

No hay que dispersar los proyectos por Desktop, Downloads y carpetas temporales aleatorias. Claude Code funciona mejor cuando tiene una estructura estable y clara del sistema de archivos, con permisos correctos y accesos a carpetas y archivos locales.

Paso 03. Terminal y línea de comandos en macOS

Después de instalar Claude Code (Codex), hay que acordar correctamente qué línea de comandos utiliza el equipo en Mac.

La aplicación de línea de comandos, o terminal, se requiere para iniciar y ejecutar comandos de bajo nivel para el sistema operativo y los archivos al trabajar con coding y vibecoding.

En Windows solemos decir "instalar PowerShell 7". En macOS la situación es distinta: la línea de comandos básica ya está integrada en el sistema.

1. Qué es el equivalente a PowerShell 7 en macOS

En macOS hay dos cosas distintas que se confunden con frecuencia:

una aplicación de terminal, es decir, la ventana donde se introducen los comandos;
un shell, es decir, el programa que entiende y ejecuta esos comandos.

La aplicación de terminal integrada se llama:

Terminal.app

El shell estándar integrado en las versiones modernas de macOS:

zsh

No es necesario instalar zsh por separado. Ya forma parte de macOS moderno y normalmente se inicia por defecto dentro de Terminal.app estándar.

Es decir, el equivalente básico de una línea de comandos de trabajo en Mac no es PowerShell, sino la combinación:

Terminal.app + zsh

Esto es suficiente para ejecutar comandos de instalación, iniciar Claude Code (Codex) CLI, trabajar con Git, Homebrew, Node.js, Python y proyectos.

Comprobar qué shell se está utilizando actualmente:

echo "$SHELL"

El resultado normal esperado:

/bin/zsh

Comprobar la versión de zsh:

zsh --version

2. Es suficiente el Terminal.app integrado

Sí, para empezar basta con el Terminal.app integrado.

Ya está presente en macOS y se encuentra aquí:

Applications -> Utilities -> Terminal

O puede abrirse mediante Spotlight:

Cmd + Space -> Terminal -> Enter

Para la primera configuración del entorno de IA no es necesario instalar un terminal adicional. Cuantos menos pasos innecesarios haya antes de tener Claude Code funcionando, mejor.

4. Cuándo conviene instalar iTerm2

Después de la configuración básica se puede instalar iTerm2 como una aplicación de terminal más cómoda.

iTerm2 no sustituye al shell. Solo sustituye la ventana del terminal. Dentro de ella normalmente seguirá funcionando el mismo zsh.

iTerm2 es útil si una persona necesita:

pestañas cómodas y split panes;
perfiles;
búsqueda rápida en el historial de salida;
configuración más flexible de fuentes y colores;
un trabajo diario cómodo en el terminal.

Pero iTerm2 no debe ser un primer paso obligatorio. Primero el equipo debe saber abrir el Terminal.app habitual y ejecutar comandos básicos.

6. Qué debe saber hacer cada miembro del equipo

Antes de seguir instalando el entorno, la persona debe saber:

abrir Terminal.app;
ir a la carpeta de proyectos:

cd "$HOME/Documents/Claude"

ver la carpeta actual:

pwd

ver la lista de archivos:

ls

crear una carpeta:

mkdir -p "$HOME/Documents/Claude"

iniciar Claude Code:

claude

7. Regla

El tercer paso de la configuración:

En macOS el equipo trabaja mediante el Terminal.app integrado y el shell estándar zsh. iTerm2 puede instalarse más tarde como una ventana de terminal más cómoda, pero no como requisito obligatorio para empezar.

Este enfoque es más sencillo, está más cerca de macOS mismo y es más compatible con la mayoría de developer tools que se utilizan en AI-vibecoding.

Paso 04. Capturas de pantalla en macOS para trabajar con Claude Code

Para AI-vibecoding con Claude Code (Codex), las capturas de pantalla son una de las principales formas de transmitir contexto. El equipo debe poder capturar rápidamente la ventana o zona de pantalla necesaria e insertar de inmediato la imagen en Claude Code.

1. Se necesita una aplicación de capturas de pantalla independiente

En la primera etapa no es necesario instalar una aplicación de capturas de pantalla independiente.

macOS ya cuenta con una herramienta integrada para capturas de pantalla. Es suficientemente buena para el trabajo básico con Claude Code:

capturar toda la pantalla;
capturar una zona seleccionada;
capturar una ventana concreta;
copiar la captura directamente al portapapeles;
insertar una captura de pantalla en Claude Code (Codex) sin guardar el archivo en el disco.

Este es exactamente el escenario necesario para comunicarse con Claude Code (Codex) mediante capturas de pantalla y mensajes de voz.

2. El requisito principal

El requisito principal para la herramienta de capturas:

Pulsar una tecla rápida, seleccionar una ventana o zona concreta, colocar la imagen en el portapapeles e insertarla de inmediato en Claude Code (Codex).

En Mac, la inserción normalmente no se realiza mediante Ctrl+V, sino mediante:

Cmd+V

Es decir, el escenario de trabajo es el siguiente:

hacer una captura -> la captura llega al clipboard -> abrir Claude Code (Codex) -> pulsar Cmd+V

3. Teclas rápidas básicas de macOS

Captura de una zona de pantalla en un archivo:

Shift+Cmd+4

Captura de una zona de pantalla directamente al portapapeles:

Ctrl+Shift+Cmd+4

Después hay que seleccionar con el ratón la zona necesaria. La captura no se guardará como un archivo independiente, sino que llegará al clipboard. Después puede insertarse en Claude Code (Codex) mediante Cmd+V.

Captura de una ventana concreta al portapapeles:

Ctrl+Shift+Cmd+4 -> Space -> clic en la ventana necesaria

Esta es la variante más importante para trabajar con Claude Code (Codex), porque permite mostrar rápidamente al agente una ventana concreta: el navegador, el terminal, un error, el IDE, los ajustes de macOS o el resultado de funcionamiento de una aplicación.

Panel Screenshot:

Shift+Cmd+5

Mediante él se puede elegir el modo de captura o grabación de pantalla, así como configurar dónde se guardan las capturas de pantalla.

4. Best practice para el equipo

Estándar del equipo:

Herramienta principal: macOS Screenshot integrado
Habilidad obligatoria: captura de una zona o ventana directamente al portapapeles
Inserción principal en Claude Code (Codex): Cmd+V
Herramienta de capturas de terceros: no obligatoria al inicio

Cada miembro del equipo debe aprender al menos dos comandos:

Ctrl+Shift+Cmd+4

para la captura de una zona al portapapeles.

Ctrl+Shift+Cmd+4 -> Space -> click

para la captura de una ventana concreta al portapapeles.

5. Regla

El cuarto paso de la configuración:

El equipo utiliza macOS Screenshot integrado y debe saber obligatoriamente realizar una captura de una zona o ventana concreta directamente al portapapeles, para insertarla en Claude Code (Codex) mediante Cmd+V.

Esto es crítico, porque el trabajo eficaz con Claude Code (Codex) se basa no solo en texto, sino también en capturas rápidas de errores, interfaces, terminal, navegador y resultados de funcionamiento de la aplicación.

Paso 05. Xcode Command Line Tools en macOS

En Windows, para proyectos JavaScript/Node.js a veces es necesario instalar Microsoft Visual Studio Build Tools 2022 para compilar native dependencies: paquetes que durante npm install o pnpm install compilan código C/C++ mediante node-gyp.

En macOS se instalan Xcode Command Line Tools.

Este punto debe realizarse antes de instalar Git, GitHub CLI, Homebrew, paquetes Python, paquetes Node.js y FFmpeg, porque Xcode Command Line Tools proporcionan a macOS el developer toolchain básico.

1. Xcode Command Line Tools en macOS

Las build tools en macOS son herramientas de Apple:

Xcode Command Line Tools

También se denominan:

Command Line Tools for Xcode

Proporcionan al sistema el compiler toolchain necesario para compilar native packages:

clang;
make;
headers;
SDK;
developer command-line utilities.

2. Está incluido de forma predeterminada en macOS

Xcode Command Line Tools son herramientas de Apple para macOS, pero no siempre están instaladas en un Mac limpio.

Podrían haberse instalado anteriormente, por ejemplo:

al instalar Git;
al ejecutar por primera vez un developer command;
al instalar Homebrew;
al instalar Xcode;
al ejecutar xcode-select --install.

Por eso, el enfoque correcto es:

no asumirlo, sino comprobarlo

3. Cómo comprobar la instalación

Comprobar la ruta a las active developer tools:

xcode-select -p

Si las tools están instaladas, el comando mostrará una ruta, por ejemplo:

/Library/Developer/CommandLineTools

Comprobar el compiler:

clang --version

Comprobar make:

make --version

Si estos comandos funcionan, las build tools básicas están listas.

4. Cómo instalar Xcode Command Line Tools

Si las tools no están instaladas:

xcode-select --install

macOS abrirá una ventana del sistema de instalación. Hay que aceptar la instalación y esperar a que termine.

Después de la instalación, volver a comprobar:

xcode-select -p
clang --version
make --version

5. Normalmente no se necesita Xcode completo

La aplicación Xcode completa ocupa mucho espacio y no siempre es necesaria.

Para la mayoría de las tareas de Claude Code (Codex), Node.js, Python, Homebrew, Git y native npm/pnpm dependencies basta con:

Xcode Command Line Tools

Xcode completo solo se necesita si el proyecto está explícitamente relacionado con:

desarrollo de iOS;
macOS app development;
proyectos Swift/Objective-C;
Xcode projects;
simuladores de iPhone/iPad;
compilación de aplicaciones Apple.

Si no existen esas tareas, no instalamos Xcode completo por defecto.

6. Relación con Node.js y pnpm

Algunos paquetes JavaScript pueden iniciar node-gyp durante la instalación y compilar un native module.

Si Xcode Command Line Tools no está instalado, pueden verse errores como:

gyp ERR!
No Xcode or CLT version detected
make failed
clang not found

En ese caso, hay que comprobar e instalar Xcode Command Line Tools.

7. No buscar instrucciones por cuenta propia

Regla estricta:

Si pnpm install, npm install, Python package install o Homebrew falla con un error de compilación en macOS, hay que preguntar a Claude Code (Codex) qué build tools se necesitan. No hay que buscar instrucciones aleatorias en internet.

La consulta correcta:

Claude, en macOS la compilación de una native dependency falla al instalar paquetes de Node.js/Python. Este es el log completo del error. Comprueba si están instaladas las Xcode Command Line Tools y dime qué comandos ejecutar.

Si aparece una ventana de instalación del sistema:

Claude, macOS propone instalar Command Line Tools for Xcode. ¿Esto es necesario para el entorno de Claude Code? Esta es la captura de pantalla.

8. No reparar developer tools al azar

No hay que ejecutar sin instrucciones comandos como:

sudo xcode-select --switch ...
sudo rm -rf /Library/Developer/CommandLineTools

Esto puede romper Homebrew, Git, Python packages y Node.js native builds.

Si xcode-select o clang se comportan de forma extraña, hay que mostrar a Claude Code (Codex):

xcode-select -p
xcode-select --version
clang --version
make --version

así como el texto completo del error.

9. Regla

El quinto paso de la configuración:

En macOS instalamos Xcode Command Line Tools para el entorno de Claude Code. Este paso se realiza antes de instalar Git y el resto de developer tools. Si la instalación de Xcode da errores incomprensibles, o si los errores aparecen durante el trabajo con Xcode, vuelva dos pasos atrás y compruebe si su macOS es limpia y nueva. Si no lo es, reinstale macOS después de guardar sus archivos personales y de trabajo. En una macOS limpia no habrá errores con Xcode.

Comprobación:

xcode-select -p
clang --version
make --version

Instalación si es necesaria:

xcode-select --install

Regla adicional:

Si falla la compilación de paquetes JavaScript/Python, no reparamos el compiler toolchain al azar. Preguntamos a Claude Code (Codex) y actuamos según la instrucción exacta para macOS.

Paso 06. Instalar y configurar Git

Git es una herramienta obligatoria para AI-vibecoding con Claude Code (Codex). Sin Git es más difícil e incluso imposible modificar código de forma segura, comprobar diff, revertir errores, hacer commits, abrir pull request y entender qué ha cambiado exactamente el agente.

Antes de este punto deben estar instaladas o comprobadas las Xcode Command Line Tools. En macOS son precisamente ellas las que proporcionan las developer tools básicas mediante las cuales a menudo se instala o activa Git.

1. Git viene en macOS de forma predeterminada

En macOS, Git suele estar disponible después de instalar Xcode Command Line Tools.

Puede comprobarse en Terminal.app:

git --version

Si Git ya está instalado, el comando mostrará una versión, por ejemplo:

git version 2.x.x

Si Git no está instalado, macOS puede proponer instalar Xcode Command Line Tools. Es la vía normal en Mac.

Comando para instalar Xcode Command Line Tools:

xcode-select --install

Después de la instalación hay que volver a comprobar:

git --version

2. No buscar por cuenta propia el enlace a Git

Si necesita un enlace actual para descargar Git o no entiende qué método de instalación elegir, no debe buscarlo por cuenta propia en artículos y vídeos aleatorios.

Regla:

Hay que preguntar a Claude Code (Codex) el enlace actual o el método de instalación de Git.

Ejemplo de consulta:

Claude, necesito instalar Git en macOS. Indícame el método oficial actual de instalación para mi caso y dame un enlace si hace falta.

En macOS, la mayoría de las veces ni siquiera se necesita un enlace: bastan Xcode Command Line Tools o Homebrew. Pero si Claude Code (Codex) recomienda descargar un instalador, debe proporcionar un enlace oficial actual y explicar por qué se ha elegido esa variante.

3. No adivinar las casillas del instalador

En el instalador de Git para Windows realmente hay muchas pantallas con ajustes y casillas. En macOS este escenario se encuentra con menos frecuencia, pero la regla debe seguir siendo común para el equipo.

Regla estricta:

No adivine los ajustes del instalador de Git. Si en la pantalla aparecen casillas, opciones de PATH, editor, line endings, SSH, credential helper u otros ajustes incomprensibles, debe enviar una captura de pantalla a Claude Code y preguntar qué elegir.

La consulta correcta:

Claude, estoy instalando Git y te enviaré capturas de pantalla de las pantallas con ajustes. Por favor, dime qué casillas y opciones elegir para que Git quede configurado para AI-vibecoding con Claude Code en macOS.

Después, envíe a Claude Code las capturas de cada paso de instalación incomprensible y él explicará qué elegir y por qué.

Esto es importante porque ajustes incorrectos de Git pueden llevar a problemas:

Git no se encuentra en el terminal;
los commits se crean con nombre o email incorrectos;
las claves SSH no funcionan;
GitHub pide una contraseña una y otra vez;
cambian los saltos de línea en los archivos;
Claude Code ve cambios adicionales en diff;
pull/push funcionan de forma inestable.

4. Ruta recomendada para instalar Git en macOS

Para el equipo, la ruta básica es la siguiente:

Abrir Terminal.app.
Comprobar Git:

git --version

Si Git no está instalado, instalar Xcode Command Line Tools:

xcode-select --install

Después de la instalación, volver a comprobar:

git --version

Más adelante, después de instalar Homebrew, se puede instalar, si es necesario, un Git más reciente mediante Homebrew:

brew install git

Pero en la primera etapa no hay que complicarlo. Si Git mediante Xcode Command Line Tools funciona, es suficiente para empezar.

5. Configuración básica de Git

Después de instalarlo, hay que indicar una vez el nombre y el email para los commits:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Comprobar los ajustes:

git config --global --list

Como mínimo deben verse:

user.name=Your Name
[email protected]

Es mejor utilizar el email asociado a la cuenta de GitHub. Si se utiliza un GitHub noreply email privado, hay que obtenerlo de los ajustes de GitHub e insertarlo aquí.

6. Git debe funcionar desde la carpeta de proyectos de Claude Code

Después de configurar, hay que comprobar Git en la carpeta de trabajo:

cd "$HOME/Documents/Claude"
git --version

Si el comando muestra la versión de Git, significa que Claude Code CLI también podrá usar Git dentro de los proyectos.

Para un proyecto concreto es útil comprobar:

git status

Si la carpeta ya es un Git repository, el comando mostrará el estado de la copia de trabajo. Si no, Git dirá honestamente que no es un repository. Es normal.

7. Qué más es importante para Claude Code (Codex)

Para AI-vibecoding, Git no es necesario solo "para que esté instalado". Se necesita como sistema de seguridad.

Antes de una tarea importante conviene tener un estado limpio:

git status

Si hay cambios importantes sin commit, deben guardarse o hacerse commit antes de que Claude Code empiece a modificar activamente el proyecto.

Después de trabajar Claude Code, hay que volver a mirar:

git diff
git status

Así la persona entiende qué archivos han cambiado y qué hizo exactamente el agente.

8. Regla

El sexto paso de la configuración:

Git debe estar instalado, disponible desde Terminal.app, configurado con user.name y user.email correctos, y comprobado en la carpeta `~/Documents/Claude.

Regla estricta adicional:

No busque instrucciones aleatorias ni adivine las casillas del instalador de Git. El método de instalación actual y todos los ajustes incomprensibles deben preguntarse a Claude Code (Codex), enviando capturas de pantalla de las pantallas de instalación.

Así Git se convierte no en un programa aleatorio del ordenador, sino en una base adecuada para el trabajo seguro de Claude Code (Codex) con código.

Paso 07. Instalar Homebrew

Después de Xcode Command Line Tools y Git hay que instalar Homebrew.

Homebrew es un package manager para macOS. Se necesita para instalar y actualizar cómodamente developer tools, command-line utilities, libraries y algunas aplicaciones desktop.

Para el entorno de Claude Code (Codex), Homebrew es especialmente útil porque permite instalar cómodamente:

GitHub CLI (gh);
FFmpeg;
libsndfile para paquetes Python de audio;
Node.js, si el equipo elige la vía de Homebrew;
Python versions, si el equipo elige la vía de Homebrew;
command-line tools adicionales.

1. Homebrew no forma parte de macOS

Homebrew no es una parte estándar de macOS.

Debe instalarse por separado.

Comprobar si Homebrew está instalado:

brew --version

Si el comando no se encuentra, Homebrew todavía no está instalado o no se ha añadido a PATH.

2. Por qué instalamos Homebrew después de Git

Homebrew utiliza activamente la infraestructura de desarrollo de macOS y GitHub.

Por eso, el orden correcto es:

Xcode Command Line Tools -> Git -> Homebrew

Xcode Command Line Tools proporciona el compiler/developer toolchain.

Git es necesario para trabajar con repositorios y puede ser utilizado por Homebrew.

Homebrew se instala ya sobre esta capa básica.

3. No buscar por cuenta propia el comando de instalación

Regla estricta:

Hay que preguntar a Claude Code (Codex) el enlace a Homebrew y el comando de instalación de Homebrew. No hay que buscar instrucciones aleatorias en internet ni copiar comandos de artículos, vídeos o foros.

La consulta correcta:

Claude, necesito instalar Homebrew en macOS para el entorno de Claude Code. Indícame el comando oficial actual de instalación, comprueba el orden de los pasos y dime qué hacer después de la instalación con PATH.

En el momento de redactar esta instrucción, el install script oficial de Homebrew tiene este aspecto:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Pero en la instrucción de trabajo para el equipo, la regla principal sigue siendo la misma:

El comando actual se obtiene de Claude Code (Codex), y Claude Code debe basarse en el sitio oficial de Homebrew.

4. Instalación

Antes de instalar, comprobar:

xcode-select -p
git --version

Si ambos pasos funcionan, pregunte a Claude Code el comando actual de instalación de Homebrew y ejecútelo en Terminal.app.

Después de iniciar el installer, lea atentamente la salida. El installer de Homebrew normalmente explica qué va a hacer y puede pedir la contraseña de administrador.

Si aparece un prompt incomprensible, no adivine la respuesta:

Claude, estoy instalando Homebrew en macOS. Esta es la captura/salida del installer. Dime qué elegir y si puedo continuar.

5. PATH después de instalar Homebrew

Después de la instalación, Homebrew casi siempre imprime un bloque Next steps.

Puede contener comandos que hay que añadir al shell config para que brew se encuentre en Terminal.app.

En un Mac Apple Silicon, Homebrew normalmente se instala aquí:

/opt/homebrew

En un Mac Intel, Homebrew normalmente se instala aquí:

/usr/local

Pero los comandos para PATH no deben inventarse manualmente.

Regla estricta:

Los comandos del bloque Next steps deben mostrarse a Claude Code (Codex) o copiarse en Claude Code y ejecutarse solo después de la confirmación. Especialmente si se trata de ~/.zprofile, ~/.zshrc o PATH.

La consulta correcta:

Claude, Homebrew se instaló y mostró Next steps. Este es el texto completo. Dime qué comandos ejecutar para que brew se añada correctamente al PATH en mi Mac.

6. Comprobación de la instalación

Después de la instalación, abra una nueva ventana de Terminal.app y ejecute:

brew --version
brew doctor

brew --version debe mostrar la versión de Homebrew.

brew doctor puede mostrar advertencias. No todas las advertencias son críticas, pero hay que leerlas.

Si brew doctor muestra un warning o error incomprensible, no repare al azar:

Claude, esta es la salida de brew doctor en macOS. Explica qué advertencias son importantes para el entorno de Claude y qué se puede corregir de forma segura.

7. Qué se puede instalar mediante Homebrew

Después de instalar Homebrew se pueden instalar developer tools:

brew install gh
brew install ffmpeg
brew install libsndfile

Pero es mejor obtener cada comando de instalación concreto del punto correspondiente de la instrucción o preguntarlo a Claude Code (Codex).

Homebrew no es una razón para instalar todo globalmente sin criterio.

8. No usar sudo aleatorio

Si una instrucción aleatoria propone reparar Homebrew mediante:

sudo chown
sudo chmod
sudo rm -rf

hay que detenerse y preguntar a Claude Code (Codex).

Homebrew puede pedir contraseña durante la instalación, pero el trabajo habitual con brew install ... normalmente no debe convertirse en un conjunto caótico de comandos sudo.

9. Regla

El séptimo paso de la configuración:

Después de Xcode Command Line Tools y Git instalamos Homebrew. Homebrew no forma parte de macOS, pero se necesita como package manager para instalar GitHub CLI, FFmpeg, audio libraries y otras developer tools.

Regla estricta adicional:

El enlace, el comando de instalación y la configuración de PATH de Homebrew se obtienen de Claude Code (Codex). No buscamos instrucciones aleatorias en internet, no editamos shell config al azar y no ejecutamos comandos sudo sin comprenderlos.

Paso 08. Instalar GitHub CLI

Después de instalar Git y Homebrew hay que instalar GitHub CLI. Es la interfaz de línea de comandos de GitHub que permite trabajar con GitHub desde Terminal.app: autorizarse, comprobar repositorios, crear pull request, ver issues, leer estados de CI y realizar otras acciones sin cambiar al navegador.

GitHub CLI se ejecuta con el comando:

gh

1. Primero se necesita una cuenta de GitHub

GitHub CLI debe instalarse y configurarse solo después de que la persona ya tenga una cuenta corporativa de GitHub.

Por qué:

después de instalar gh habrá que autorizarse en GitHub;
para la autorización se necesita una cuenta de GitHub existente;
sin autorización, GitHub CLI está instalado pero es casi inútil para el trabajo real;
Claude Code (Codex) no podrá ayudar con pull request, issues y GitHub workflows mediante el gh local si el usuario no ha iniciado sesión en GitHub.

Regla:

Primero crear o preparar una cuenta de GitHub, después instalar y autorizar GitHub CLI.

2. No buscar por cuenta propia el comando de instalación

En Windows, GitHub CLI se instala con frecuencia directamente desde la línea de comandos mediante un comando especial. En macOS también existe un método de instalación por comando, pero no hay que buscarlo manualmente en internet.

Regla estricta:

Hay que preguntar a Claude Code (Codex) el comando actual de instalación de GitHub CLI.

Ejemplo de consulta:

Claude, necesito instalar GitHub CLI en macOS. Indícame el comando oficial actual de instalación para mi Mac y ten en cuenta si tengo Homebrew.

Esto es importante porque el método de instalación depende de la situación:

si Homebrew está instalado;
Mac Apple Silicon o Intel Mac;
GitHub.com normal o GitHub Enterprise;
si existen restricciones corporativas para instalar paquetes;
si hace falta instalar mediante package manager o mediante binary/pkg oficial.

En el momento de redactar esta instrucción, el método básico oficial para macOS mediante Homebrew es:

brew install gh

Pero en la instrucción de trabajo para el equipo la regla principal sigue siendo la misma: no buscar artículos aleatorios, sino preguntar a Claude Code (Codex) y utilizar el método oficial.

3. Comprobar la instalación

Después de la instalación hay que comprobar que el comando gh esté disponible:

gh --version

Si el comando muestra la versión de GitHub CLI, la instalación se realizó correctamente.

Si Terminal.app indica que no se encuentra gh, no hay que adivinar la solución, sino preguntar a Claude Code (Codex):

Claude, instalé GitHub CLI en macOS, pero el comando gh no se encuentra en Terminal.app. Ayúdame a comprobar PATH y corregir la instalación.

4. Autorizarse en GitHub

Después de la instalación hay que realizar la autorización:

gh auth login

Normalmente GitHub CLI hará varias preguntas:

GitHub.com o GitHub Enterprise Server;
HTTPS o SSH;
abrir el navegador para autorizarse o insertar token;
qué Git protocol utilizar de forma predeterminada.

Si la persona no está segura de qué elegir, debe enviar una captura a Claude Code (Codex) y preguntar.

Ejemplo de consulta:

Claude, estoy ejecutando gh auth login en macOS. Esta es la captura con las opciones. Dime qué elegir para trabajar normalmente con GitHub y Claude Code.

5. Comprobar la autorización

Después de iniciar sesión hay que comprobar el estado:

gh auth status

Resultado esperado: GitHub CLI debe mostrar que el usuario está autorizado en GitHub.

Si se utilizan varias cuentas o GitHub Enterprise, hay que comprobar explícitamente en qué cuenta se ha iniciado sesión.

6. Comprobar el funcionamiento en la carpeta de proyectos de Claude Code

Después de instalar y autorizarse hay que ir a la carpeta de trabajo:

cd "$HOME/Documents/Claude"

Y comprobar:

gh auth status
gh repo list

Si gh repo list muestra los repositorios de la cuenta, GitHub CLI está listo para trabajar.

Dentro de un GitHub repository concreto, es útil comprobar:

gh repo view

Si el comando muestra información sobre el repositorio actual, significa que la carpeta local está vinculada con GitHub.

7. Particularidades de macOS

En macOS, GitHub CLI normalmente se instala de forma más cómoda mediante Homebrew:

brew install gh

Pero esto presupone que Homebrew ya está instalado. Si Homebrew todavía no está instalado, primero hay que ir al punto de la instrucción sobre Homebrew o preguntar a Claude Code (Codex) qué método de instalación elegir ahora.

En Mac es importante recordar:

los comandos se ejecutan en Terminal.app;
el shell normalmente es zsh;
la inserción de texto y capturas suele realizarse mediante Cmd+V;
si aparecen solicitudes de acceso del sistema, no hay que pulsar al azar, sino enviar una captura a Claude Code;
si la autorización abre un navegador, hay que iniciar sesión precisamente en la cuenta de GitHub adecuada.

8. Regla

El octavo paso de la configuración:

GitHub CLI se instala solo después de preparar la cuenta de GitHub. Hay que preguntar a Claude Code el comando actual de instalación. Después de instalar, es obligatorio ejecutar gh auth login y comprobar el resultado mediante gh auth status.

Regla adicional:

Si durante la instalación o la autorización de GitHub CLI aparecen opciones de elección, casillas, preguntas sobre HTTPS/SSH, browser login, token o GitHub Enterprise que no se entienden, la persona no adivina la respuesta, sino que envía una captura de pantalla a Claude Code (Codex).

GitHub CLI debe convertirse en el puente estándar entre la carpeta local del proyecto, GitHub y Claude Code (Codex).

Paso 09. Instalar Python en macOS

Python en el entorno para Claude Code (Codex) no es necesario porque nos guste o no nos guste este lenguaje.

Python se necesita porque gran parte de las automatizaciones simples en AI-vibecoding se realizan cómodamente precisamente con scripts Python:

tomar datos de un archivo y colocarlos en otro;
parsear CSV, JSON, Markdown, HTML o un log de texto;
preparar un pequeño informe;
renombrar un conjunto de archivos;
comprobar la estructura de carpetas;
preparar datos para importar;
escribir rápidamente un utility script de un solo uso;
automatizar una acción rutinaria que es lenta y arriesgada hacer a mano.

Para Claude Code (Codex), Python no es una cuestión de gusto, sino una herramienta de trabajo obligatoria.

1. Python es obligatorio

Cada Mac preparado para AI-vibecoding con Claude Code (Codex) debe tener un Python 3 funcional.

Comprobar la presencia de Python:

python3 --version

Comprobar pip:

python3 -m pip --version

Si estos comandos no funcionan o muestran una versión inadecuada, hay que instalar Python.

2. No buscar por cuenta propia el enlace

No hay que buscar por cuenta propia en internet el enlace actual para descargar Python ni el comando de instalación actual.

Regla:

Hay que preguntar a Claude Code (Codex) el enlace para descargar Python y el método de instalación.

Ejemplo de consulta:

Claude, necesito instalar Python en macOS para AI-vibecoding. Indícame el enlace oficial actual o el comando de instalación. Necesito una versión estable de Python 3.12.x, no la versión experimental/latest más nueva.

Esto es importante porque en el sitio de Python puede haber un botón grande con la versión más nueva, pero para nuestra tarea no hace falta la versión más nueva. Necesitamos la versión más estable y compatible del lenguaje de programación Python para automatizaciones cotidianas.

3. Qué versión de Python instalar

Para nuestro entorno de Claude Code (Codex), el estándar básico:

Python 3.12.x

A 18 de junio de 2026, la última versión de la rama 3.12 es Python 3.12.13.

Al mismo tiempo, ya existen ramas oficiales más nuevas: Python 3.13 está en bugfix support y Python 3.14 es la latest feature release. Pero para un AI-vibecoding estable no perseguimos la versión más nueva.

Por qué elegimos 3.12.x:

rama madura y ampliamente compatible;
buena compatibilidad con bibliotecas;
menor riesgo de que los automation scripts simples se rompan por cambios recientes;
versión lo suficientemente nueva para la mayoría de herramientas Python modernas;
entorno más predecible para el equipo.

Regla estricta:

Para el entorno básico de Claude Code instalamos Python 3.12.x. Python 3.14 y las versiones más nuevas no se instalan por defecto hasta que el equipo haya decidido actualizar el estándar por separado y comprobado la compatibilidad.

4. Python integrado en macOS

En macOS puede haber componentes del sistema Python o developer tools relacionados con Python.

Regla:

No tocar el Python del sistema de macOS ni contar con él como Python de trabajo para Claude Code (Codex).

El Python del sistema es necesario para macOS mismo o Apple developer tools. No debe eliminarse, sobrescribirse ni repararse manualmente.

Para el trabajo con Claude Code (Codex) se instala un Python separado de usuario/desarrollador.

5. Dónde instalar Python en macOS

En Windows a veces se utiliza una instalación en la raíz del disco C:\, para que Python esté disponible de forma predecible.

En macOS no hay que hacerlo así. macOS tiene otra estructura del sistema de archivos y otro enfoque para instalar developer tools.

El enfoque correcto:

no instalar Python en la raíz del disco;
no modificar manualmente las carpetas del sistema;
utilizar el installer oficial de macOS de python.org o un package manager;
comprobar la disponibilidad mediante Terminal.app.

El installer oficial de macOS de Python normalmente instala Python en una ubicación developer esperada por el sistema como:

/Library/Frameworks/Python.framework/Versions/3.12

Y añade los comandos para iniciar Python 3.12 a las rutas estándar.

Si Python se instala mediante Homebrew, se instalará en el prefijo de Homebrew:

/opt/homebrew

en un Mac Apple Silicon, o:

/usr/local

en un Mac Intel.

Ambas variantes son normales. Para el equipo es más importante no la carpeta física de instalación, sino que en Terminal.app funcionen de forma estable los comandos:

python3 --version
python3 -m pip --version

6. Método de instalación recomendado

Para los miembros del equipo sin experiencia segura con package managers, la vía más clara:

Preguntar a Claude Code (Codex) el enlace oficial actual a Python 3.12.x para macOS.
Descargar el installer oficial de macOS desde python.org.
Ejecutar el installer.
No adivinar ajustes incomprensibles si aparecen, sino enviar una captura a Claude Code (Codex).
Después de la instalación, abrir un nuevo Terminal.app.
Comprobar:

python3 --version
python3 -m pip --version

Para personas que ya tienen Homebrew instalado, es posible la variante:

brew install [email protected]

Pero el comando de instalación debe preguntarse previamente a Claude Code (Codex), porque Homebrew, PATH y la política del equipo pueden diferir.

7. Comprobación después de la instalación

Después de la instalación hay que ejecutar:

python3 --version

Resultado esperado para nuestro estándar:

Python 3.12.x

Comprobar pip:

python3 -m pip --version

Comprobar dónde se encuentra Python:

which python3

Comprobar que Python puede ejecutar un script simple:

python3 -c "print('Python is ready for Claude Code (Codex) automation')"

8. Entornos virtuales

Para los proyectos es importante no instalar todas las bibliotecas Python globalmente sin necesidad.

Dentro de un proyecto concreto, es mejor utilizar un entorno virtual:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

Después de activar .venv, las bibliotecas se instalan dentro del proyecto, no en el Python global.

Claude Code (Codex) debe ver y utilizar ese entorno si los scripts Python pertenecen a un proyecto concreto.

9. Qué hacer si la versión no coincide

Si después de instalar el comando:

python3 --version

muestra una versión distinta de Python 3.12.x, no hay que eliminar Python al azar ni modificar los archivos del sistema.

Hay que preguntar a Claude Code (Codex):

Claude, instalé Python en macOS, pero python3 --version muestra una versión incorrecta. Ayúdame a entender qué Python se está utilizando ahora, dónde está instalado y cómo configurar de forma segura Python 3.12.x para Claude Code (Codex).

10. Regla

El noveno paso de la configuración:

Python es obligatorio para el entorno de Claude Code, porque la mayoría de automatizaciones simples se realizan cómodamente mediante scripts Python. Para un entorno básico y estable instalamos Python 3.12.x, no tocamos el Python del sistema de macOS y no instalamos Python manualmente en la raíz del disco.

Regla adicional:

El enlace de descarga, el comando de instalación y cualquier ajuste incomprensible del installer deben preguntarse a Claude Code (Codex), no buscarse en fuentes aleatorias ni adivinarse.

Paso 10. Instalar los paquetes Python must-have

Después de instalar Python hay que preparar un conjunto básico de paquetes Python utilizado en el trabajo cotidiano con Claude Code (Codex).

Este es un paso extremadamente importante, porque sin los paquetes necesarios para sus tareas en los lenguajes de programación durante vibecoding puede caer fácilmente en sobreconsumo o en un bucle debido a un paquete faltante, y su Claude Code puede no informarle de ello. Como resultado perderá mucho tiempo y gasto de tokens.

Siempre, antes de una tarea grande o un proyecto, primero piense y pregunte a Claude Code en qué lenguaje de programación realizaremos esta tarea y qué paquetes necesarios del lenguaje de programación necesitaremos.

Estos paquetes no se necesitan "por si acaso", sino para escenarios reales de AI-vibecoding:

trabajo con OpenAI API;
trabajo con imágenes;
trabajo con audio;
preparación y procesamiento de transcripciones de voz;
voice activity detection;
utilities locales de ML/audio.

1. Los paquetes no se instalan globalmente, sino en virtual environment

Regla principal:

Los paquetes Python para proyectos de Claude Code no se instalan globalmente sin necesidad. Deben instalarse en .venv dentro de un proyecto concreto o dentro de un proyecto bootstrap separado del entorno.

La razón es sencilla: distintos paquetes Python y distintas versiones de paquetes pueden ser incompatibles entre sí. Si se instala todo globalmente, tarde o temprano una automatización romperá otra.

Plantilla de trabajo:

cd "$HOME/Documents/Claude Code (Codex)"
mkdir -p python-tooling
cd python-tooling
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

Después de activar el entorno, el prompt del terminal normalmente muestra (.venv).

2. Conjunto compatible de paquetes pinned

Para nuestra práctica fijamos un conjunto compatible de versiones:

imageio-ffmpeg==0.6.0
openai==2.33.0
numpy==1.26.4
torch==2.5.1
librosa==0.10.2.post1
soundfile==0.12.1
webrtcvad==2.0.10
Resemblyzer==0.1.4
setuptools==80.9.0

Esto es importante: las versiones están fijadas no por estética, sino porque en el trabajo práctico distintas versiones de paquetes Python entran a menudo en conflicto entre sí.

Regla estricta:

No actualizar estos paquetes automáticamente a versiones más nuevas. Si desea actualizar un paquete, primero pregunte a Claude Code (Codex), compruebe la compatibilidad y ejecute una instalación de prueba en un .venv separado.

3. Crear un archivo requirements

Dentro del proyecto debe crearse el archivo:

requirements-codex-python-tooling.txt

Contenido:

imageio-ffmpeg==0.6.0
openai==2.33.0
numpy==1.26.4
torch==2.5.1
librosa==0.10.2.post1
soundfile==0.12.1
webrtcvad==2.0.10
Resemblyzer==0.1.4
setuptools==80.9.0

Instalación:

python -m pip install -r requirements-codex-python-tooling.txt

4. Qué hacen estos paquetes

openai==2.33.0 se necesita para trabajar con OpenAI API.

numpy==1.26.4 se necesita como biblioteca básica para datos numéricos, arrays, audio y dependencias de ML.

torch==2.5.1 se necesita para tareas de ML/audio y dependencias como Resemblyzer.

librosa==0.10.2.post1 se necesita para análisis y procesamiento de archivos de audio.

soundfile==0.12.1 se necesita para leer y escribir archivos de audio.

imageio-ffmpeg==0.6.0 se necesita para tareas que requieren procesamiento ffmpeg mediante Python.

webrtcvad==2.0.10 se necesita para voice activity detection: determinar dónde hay voz en el audio y dónde hay silencio o ruido.

Resemblyzer==0.1.4 se necesita para speaker/audio embeddings y tareas relacionadas con la voz.

setuptools==80.9.0 se necesita como dependencia básica de compilación para paquetes Python.

5. Particularidades de macOS

En macOS, algunos paquetes pueden requerir developer tools del sistema.

Antes de instalar este conjunto deben realizarse los pasos anteriores:

está instalada una macOS moderna;
están instaladas las actualizaciones del sistema;
el usuario trabaja desde una cuenta admin;
está instalado Git;
están instaladas Xcode Command Line Tools;
está instalado Python 3.12.x.

Comprobación de Xcode Command Line Tools:

xcode-select -p

Si las tools no están instaladas:

xcode-select --install

6. `soundfile` y libsndfile

El paquete soundfile funciona mediante la biblioteca del sistema libsndfile.

Si soundfile se instaló, pero la importación o lectura de audio falla con un error sobre libsndfile, hay que instalar la biblioteca del sistema mediante Homebrew:

brew install libsndfile

Después comprobar de nuevo:

python -c "import soundfile; print(soundfile.__version__)"

7. `webrtcvad` puede compilarse desde el código fuente

webrtcvad==2.0.10 puede requerir compilación. Por ello, Xcode Command Line Tools deben estar instaladas antes de intentar instalar el paquete.

Si la instalación de webrtcvad==2.0.10 falla en un Mac concreto, no hay que cambiar caóticamente las versiones de todos los paquetes.

Hay que preguntar a Claude Code (Codex):

Claude, en macOS no se instala webrtcvad==2.0.10 en Python 3.12 .venv. Este es el texto completo del error. Ayúdame a entender si faltan compiler tools, wheel, pip/setuptools o si hace falta un fallback compatible.

Un posible fallback para un proyecto separado es el paquete webrtcvad-wheels, que cuenta con binary wheels para macOS. Pero no sustituye al conjunto pinned básico sin una decisión separada del equipo.

8. `torch` en macOS

PyTorch admite macOS, pero la instalación depende de la versión de Python, la arquitectura del Mac y los paquetes wheel disponibles.

Para nuestro baseline utilizamos:

torch==2.5.1

Si torch==2.5.1 no se instala en un Mac concreto, no hay que actualizar de inmediato todo el archivo requirements.

Hay que preguntar a Claude Code (Codex):

Claude, en macOS, en Python 3.12 .venv, no se instala torch==2.5.1. Este es el error. Comprueba la compatibilidad con la arquitectura de mi Mac y propón una variante segura sin romper el resto del conjunto pinned.

9. Comprobación de la instalación

Después de instalar los paquetes hay que comprobar las importaciones:

python - <<'PY'
import imageio_ffmpeg
import openai
import numpy
import torch
import librosa
import soundfile
import webrtcvad
import resemblyzer
import setuptools

print("imageio-ffmpeg", imageio_ffmpeg.__version__)
print("openai", openai.__version__)
print("numpy", numpy.__version__)
print("torch", torch.__version__)
print("librosa", librosa.__version__)
print("soundfile", soundfile.__version__)
print("webrtcvad import ok")
print("Resemblyzer import ok")
print("setuptools", setuptools.__version__)
PY

Si todas las importaciones han pasado, el Python tooling está listo para trabajar.

10. No instalar paquetes antes de Python

Los paquetes no se pueden instalar antes de que esté instalado y comprobado el Python correcto.

Orden correcto:

Python 3.12.x está instalado.
python3 --version muestra Python 3.12.x.
Se ha creado .venv.
.venv está activado.
Se ha actualizado pip.
Se ha instalado el archivo requirements pinned.
Se ha realizado la comprobación de importaciones.

11. Regla

El décimo paso de la configuración:

Los paquetes Python must-have se instalan solo en .venv, estrictamente con versiones pinned, mediante un archivo requirements. Este conjunto es necesario para OpenAI API, imágenes, audio, transcripciones y automatizaciones simples de Claude Code (Codex).

Regla adicional:

Si un paquete no se instala en macOS, no actualice todo el conjunto al azar. Debe enviar a Claude Code el texto completo del error y solicitar un fix seguro para el Mac concreto, Python 3.12.x y el conjunto pinned actual.

Utilice siempre solo paquetes estrictamente oficiales y seguros para trabajar; no se pueden utilizar paquetes de origen incomprensible, esto puede provocar una vulnerabilidad en su código.

Paso 11. Instalar el entorno JavaScript: Node.js y pnpm

Después de Python hay que preparar el entorno JavaScript. Para Claude Code (Codex) es una capa must-have igual de necesaria, porque una enorme cantidad de proyectos modernos, herramientas frontend, dev servers, CLI utilities, build systems e integraciones de IA funcionan mediante Node.js.

Necesitamos el entorno JavaScript no porque JavaScript sea mejor o peor que Python, sino porque en el trabajo real de AI-vibecoding Claude Code (Codex) encuentra constantemente:

aplicaciones web;
proyectos frontend;
React, Next.js, Vite y frameworks similares;
paquetes npm/pnpm/yarn;
dev servers;
Playwright/browser automation;
OpenAI SDK para JavaScript/TypeScript;
procesamiento de archivos, imágenes, audio y vídeo mediante Node tooling.

Asimismo, MiniApps funcionan precisamente con lenguajes de programación de scripting.

1. Qué se debe instalar

Conjunto JavaScript básico:

Node.js
pnpm

Node.js es un runtime que ejecuta JavaScript fuera del navegador.

pnpm es un package manager que a menudo trabaja con dependencias de forma más rápida y ordenada que npm normal. Si el proyecto utiliza pnpm-lock.yaml, hay que trabajar precisamente mediante pnpm.

Importante:

En este paso instalamos solo Node.js y pnpm. No instalamos de antemano todos los posibles paquetes JavaScript para OpenAI, audio, vídeo, imágenes, frontend y tests.

npm normalmente se instala técnicamente junto con Node.js, pero como estándar de comandos para nuestros proyectos preferimos pnpm si el proyecto concreto no requiere otro package manager.

Node.js también tiene core modules integrados, por ejemplo fs, path, http, crypto. Son parte del propio Node.js; no pueden ni deben instalarse o eliminarse por separado. La frase "Node.js sin todos los paquetes" en nuestra instrucción significa:

instalamos el runtime Node.js, pero no instalamos globalmente dependencias de proyectos

2. Node.js no está integrado en macOS

A diferencia de zsh, Node.js no es una parte estándar de macOS.

Debe instalarse por separado.

Comprobar si Node.js está instalado:

node --version

Comprobar npm:

npm --version

Comprobar pnpm:

pnpm --version

Si no se encuentran node o pnpm, el entorno JavaScript todavía no está listo.

3. Qué versión de Node.js instalar

Para el entorno de Claude Code (Codex) hay que instalar una versión estable LTS de Node.js, no Current/latest.

A 18 de junio de 2026, el Node.js LTS oficial es:

Node.js v24.17.0 LTS

Al mismo tiempo, Node.js v26.x ya existe como Current, pero no se instala por defecto para el entorno básico estable.

Regla:

Para el equipo instalamos Node.js LTS. Current/latest se instala solo si un proyecto concreto lo exige explícitamente.

4. No buscar por cuenta propia el enlace o comando de instalación

El enlace actual para descargar Node.js o el comando de instalación debe preguntarse a Claude Code (Codex).

Ejemplo de consulta:

Claude, necesito instalar Node.js en macOS para AI-vibecoding. Indícame el método oficial actual de instalación. Necesito una versión LTS, no Current.

Esto es importante porque en el sitio de Node.js puede haber varias variantes:

LTS;
Current;
macOS installer;
Homebrew;
version manager;
Apple Silicon;
Intel Mac.

No hay que elegir al azar.

5. Enfoque recomendado en macOS

Para el equipo hay dos variantes normales.

Variante 1: installer oficial de nodejs.org.

Esta vía es más sencilla para principiantes. La persona descarga el installer LTS, instala Node.js y luego comprueba:

node --version
npm --version

Variante 2: version manager, por ejemplo fnm o nvm.

Esta vía es mejor para desarrolladores que trabajan con varios proyectos en diferentes versiones de Node.js.

En macOS hay que tener en cuenta la arquitectura del Mac:

Apple Silicon: arm64
Intel Mac: x64

Si una persona descarga manualmente un installer, debe elegir la variante correcta para su Mac. Si no está segura, debe preguntar a Claude Code y enviar una captura de la página de descarga o la salida:

uname -m

Variantes esperadas:

arm64
x86_64

El estándar del equipo puede formularse así:

Para principiantes: installer oficial Node.js LTS.
Para desarrolladores con varios proyectos: version manager.
Regla principal: en todas partes usamos Node.js LTS, si el proyecto no requiere otra cosa.

Si la persona no entiende qué variante elegir, pregunta a Claude Code (Codex).

6. Instalar pnpm

Después de instalar Node.js hay que instalar o activar pnpm.

Una variante moderna y segura se realiza a menudo mediante Corepack, que se entrega junto con Node.js:

corepack enable
corepack prepare pnpm@latest --activate

Después comprobar:

pnpm --version

Si el comando se ejecuta en un Mac corporativo y corepack enable pide permisos o falla por permissions, no hay que ejecutar comandos sudo aleatorios de internet. Hay que enviar a Claude Code (Codex) la salida completa del error.

Si Corepack no está disponible o el comando no funciona, no hay que adivinar el fix. Hay que preguntar a Claude Code:

Claude, instalé Node.js LTS en macOS, pero no puedo activar pnpm mediante Corepack. Esta es la salida del terminal. Ayúdame a instalar pnpm de forma segura.

7. No instalar paquetes de proyecto globalmente

Globalmente solo deben estar disponibles herramientas básicas como node, npm, pnpm.

Las dependencias de proyecto deben instalarse dentro de cada proyecto concreto:

cd "$HOME/Documents/Claude Code (Codex)/my-project"
pnpm install

o, si el proyecto utiliza npm:

npm install

No se pueden instalar globalmente al azar paquetes como:

npm install -g openai
npm install -g typescript
npm install -g vite

si el proyecto no lo requiere explícitamente.

Para nuestro equipo esta es una regla estricta separada:

Node.js se instala sin un conjunto global de paquetes JS adicionales. Todos los paquetes para OpenAI, voz, audio, transcripción, imágenes, vídeo, frontend y tests se instalan solo dentro de un proyecto concreto después de comprobar package.json y lockfile.

8. Antes de trabajar con un proyecto, preguntar por los paquetes JS necesarios

Antes de empezar a trabajar con un proyecto concreto JavaScript/TypeScript hay que preguntar a Claude Code (Codex) qué dependencias se necesitan precisamente para este proyecto.

Ejemplo de consulta:

Claude, empiezo a trabajar con este proyecto en macOS. Mira package.json, lockfile y la estructura del proyecto. Dime qué paquetes Node.js hay que instalar y qué package manager utilizar: npm, pnpm o yarn.

Para proyectos con OpenAI, voz, audio, transcripción, imágenes y vídeo hay que hacer una pregunta separada:

Claude, el proyecto trabajará con OpenAI API, voz, audio, transcripción, imágenes y vídeo. Comprueba qué paquetes JavaScript/TypeScript se necesitan, qué versiones son compatibles y propone una instalación sin conflictos de dependencias.

Claude Code (Codex) debe revisar:

package.json;
pnpm-lock.yaml;
package-lock.json;
yarn.lock;
README;
.nvmrc;
.node-version;
engines en package.json;
scripts existentes.

9. Cómo elegir el package manager en un proyecto

No elegir el package manager al azar.

Regla:

Si existe pnpm-lock.yaml -> utilizar pnpm.
Si existe package-lock.json -> utilizar npm.
Si existe yarn.lock -> utilizar yarn.
Si no hay lockfile -> preguntar a Claude Code (Codex) qué elegir para el proyecto.

Para proyectos nuevos se puede utilizar pnpm si no existen restricciones.

10. Paquetes frecuentes para proyectos de IA/media

No hay que instalar de antemano todos estos paquetes en cada proyecto, pero el equipo debe entender qué categorías se encuentran normalmente:

OpenAI API: openai;
esquemas y validación: zod;
imágenes: sharp, jimp;
browser automation: playwright;
vídeo/audio mediante ffmpeg: fluent-ffmpeg, ffmpeg-static;
lectura de metadata de audio/vídeo: music-metadata;
WAV/audio utilities: wavefile, node-wav;
TypeScript tooling: typescript, tsx, ts-node;
tests: vitest, jest, playwright/test.

Pero una vez más:

Estos paquetes no se instalan automáticamente. Deben seleccionarse para el proyecto y la tarea concretos.

11. Comprobación de la instalación

Después de instalar el entorno JavaScript, ejecutar:

node --version
npm --version
pnpm --version

Comprobar la ejecución de un JavaScript simple:

node -e "console.log('Node.js is ready for Claude Code (Codex) automation')"

Comprobar la carpeta de proyectos:

cd "$HOME/Documents/Claude Code (Codex)"
node --version
pnpm --version

12. Regla

El undécimo paso de la configuración:

En macOS hay que instalar Node.js LTS, npm y pnpm. Node.js no está integrado en macOS. Preguntamos a Claude Code (Codex) el comando actual o enlace de instalación, no lo buscamos aleatoriamente en internet.

Regla adicional:

Antes de trabajar con cada proyecto JavaScript/TypeScript hay que preguntar a Claude Code (Codex) qué package manager utilizar y qué paquetes exactos se necesitan para OpenAI, voz, audio, transcripción, imágenes, vídeo y otras tareas del proyecto.

Así el entorno JavaScript se vuelve gestionable, y no un conjunto de paquetes globales instalados al azar.

Paso 12. Permitir a Claude Code y developer tools trabajar con internet en macOS

En Windows, Claude Code (Codex) puede no acceder a internet debido a Windows Defender Firewall u otras reglas de seguridad. En macOS también es posible un problema parecido, pero funciona de otra manera.

La diferencia principal:

El macOS Firewall integrado gestiona principalmente las conexiones entrantes al Mac. Los problemas con internet saliente se relacionan más a menudo no con el propio macOS Firewall, sino con VPN, proxy, políticas MDM corporativas, DNS, antivirus, network filters o aplicaciones firewall de terceros.

Por eso, en macOS hay que comprobar varias capas.

1. Qué debe tener acceso a internet

Para el funcionamiento normal del entorno Claude Code (Codex), las siguientes aplicaciones y herramientas necesitan internet:

Claude Code (Codex) Desktop app;
Claude Code (Codex) CLI;
Terminal.app;
navegador mediante el cual se realiza login;
Git;
GitHub CLI (gh);
Homebrew;
Node.js/npm/pnpm;
Python/pip;
package managers y dev servers de proyectos concretos.

Si una de estas herramientas no puede salir a internet, el trabajo de Claude Code se romperá con errores extraños: no se descargan packages, no funciona login, GitHub no se abre, porque Claude Code (Codex) no puede utilizar funciones de red.

2. Comprobar el internet básico desde Terminal.app

Antes de configurar firewall hay que comprobar que internet funciona desde el terminal:

curl -I https://www.apple.com
curl -I https://github.com
curl -I https://api.openai.com

Si estos comandos no reciben respuesta, el problema no está en Claude Code (Codex) como tal. Hay que diagnosticar la red, DNS, proxy, VPN o restricciones corporativas.

3. Comprobar macOS Firewall

Abrir los ajustes:

Apple menu -> System Settings -> Network -> Firewall

Si Firewall está desactivado, el macOS Firewall integrado no debería bloquear Claude Code (Codex).

Si Firewall está activado, abrir:

Firewall -> Options

Y comprobar que no haya una prohibición explícita para Claude Code (Codex) app, Terminal.app, el navegador u otras developer tools.

Si una aplicación se añade a la lista y junto a ella aparece block/deny, hay que cambiar la regla a allow.

Importante:

No hace falta desactivar firewall por completo sin motivo. Primero hay que permitir una aplicación o servicio concreto.

Regla estricta:

Hay que preguntar a Claude Code cómo configurar correctamente macOS Firewall para Claude Code, Terminal.app, dev server u otra developer tool. No hay que inventar ajustes por cuenta propia ni buscar instrucciones aleatorias en internet.

La consulta correcta:

Claude, estoy configurando macOS Firewall para trabajar con Claude Code y developer tools. Esta es la captura de los ajustes actuales de Firewall/Options y la descripción del problema. Dime qué aplicaciones permitir y qué ajustes elegir.

4. Permitir una aplicación mediante Firewall Options

Si Claude Code (Codex) Desktop app u otra aplicación necesaria está bloqueada:

Abrir System Settings.
Ir a Network.
Abrir Firewall.
Pulsar Options.
Añadir la aplicación necesaria mediante +.
Elegir Allow incoming connections.
Guardar los ajustes.

Esto es especialmente importante para aplicaciones que levantan un servidor local, dev server o aceptan conexiones locales.

5. Internet saliente: dónde suele estar el problema real

Si Claude Code, curl, git, gh, brew, npm, pnpm o pip no pueden conectarse a internet y macOS Firewall no muestra una prohibición explícita, hay que comprobar:

si VPN está activado;
si existe un proxy corporativo;
si el Mac está gestionado mediante MDM;
si está instalado un firewall de terceros: Little Snitch, LuLu, Radio Silence, endpoint security corporativo;
si se bloquean los dominios openai.com, chatgpt.com, api.openai.com, github.com, npmjs.com, pypi.org;
si DNS está roto;
si la red requiere captive portal login, por ejemplo en una oficina, hotel o aeropuerto.

En Mac, precisamente estas capas bloquean con más frecuencia las conexiones salientes de aplicaciones.

6. No adivinar los permisos

Si macOS muestra un popup con permiso de red, firewall warning o security prompt, la persona no debe pulsar al azar.

Regla:

Hacer una captura del popup y enviarla a Claude Code con una pregunta sobre qué pulsar.

Ejemplo de consulta:

Claude, macOS muestra un permiso de red para Claude Code/Terminal/dev server. Esta es la captura. Dime qué elegir para que Claude Code pueda trabajar con internet y dev servers locales, pero sin debilitar innecesariamente la seguridad.

7. Comprobar Claude Code CLI

Después de configurar la red, comprobar Claude Code CLI:

codex --version

Después iniciar:

codex

Si no funciona login o una solicitud de red, hay que copiar el error o enviar una captura a Claude Code (Codex).

8. Comprobar package managers

Comprobar que los principales package managers acceden a internet:

git ls-remote https://github.com/openai/codex.git
gh auth status
brew update
python3 -m pip index versions openai
pnpm view openai version

Si algún comando falla, no hay que reinstalar inmediatamente toda la herramienta. Hay que determinar qué capa de red concreta bloquea el acceso.

9. Estándar del equipo

Para el equipo fijamos:

Comprobamos macOS Firewall, pero no lo consideramos la única causa de problemas de red.
Claude Code app, Terminal.app y developer tools deben tener permiso de red.
Los bloqueos salientes se buscan más frecuentemente en VPN/proxy/MDM/firewall de terceros.
Los security y firewall prompts incomprensibles se envían mediante captura de pantalla a Claude Code.

10. Regla

El duodécimo paso de la configuración:

En macOS hay que comprobar que Claude Code (Codex) Desktop app, Claude Code CLI, Terminal.app, Git, GitHub CLI, Homebrew, pip y pnpm pueden acceder a internet. El macOS Firewall integrado normalmente gestiona conexiones entrantes, pero sus Options deben comprobarse si una aplicación está bloqueada explícitamente.

Regla adicional:

Si Claude Code o developer tools no acceden a internet, no desactive la seguridad a ciegas. Hay que comprobar Firewall, VPN, proxy, DNS, MDM y network filters de terceros, y enviar a Claude Code mediante captura todos los cuadros de permisos incomprensibles.

Paso 13. Configurar PATH en macOS

En Windows existe la variable Path, donde se especifican las carpetas con programas que deben ejecutarse desde el terminal. En macOS existe la misma idea, pero normalmente se llama:

PATH

PATH es una lista de carpetas en las que el shell busca comandos.

Si un comando está en el ordenador, pero su carpeta no llegó a PATH, Terminal.app y Claude Code (Codex) no podrán iniciarlo correctamente.

1. Por qué PATH es importante para Claude Code

Claude Code ejecuta constantemente comandos:

git;
gh;
codex;
python3;
pip;
node;
npm;
pnpm;
brew;
curl.

Si no se encuentra algún comando, Claude Code puede empezar a entrar en un bucle, proponer soluciones alternativas, reinstalar cosas innecesarias o diagnosticar mal el problema. Esto lleva a pérdida de tiempo y a un enorme sobreconsumo de tokens.

Por ello, después de instalar cada herramienta hay que comprobar no solo el hecho de la instalación, sino también que el comando esté disponible desde Terminal.app.

2. Cómo ver PATH

Mostrar el PATH actual:

echo "$PATH"

Variante más legible:

echo "$PATH" | tr ':' '\n'

Cada línea es una carpeta separada donde el shell busca comandos ejecutables.

3. Cómo comprobar un comando concreto

Comprobar si se encuentra el comando:

command -v git
command -v gh
command -v codex
command -v python3
command -v node
command -v pnpm
command -v brew

También se puede utilizar:

which git
which gh
which codex
which python3
which node
which pnpm
which brew

Si el comando está configurado correctamente, macOS mostrará la ruta al archivo ejecutable, por ejemplo:

/usr/bin/git
/opt/homebrew/bin/brew
/opt/homebrew/bin/node

Si el comando no se encuentra, habrá un error como:

command not found

o un resultado vacío.

4. Carpetas PATH típicas en macOS

En macOS se encuentran con frecuencia estas rutas:

/usr/bin
/bin
/usr/sbin
/sbin
/usr/local/bin
/opt/homebrew/bin

En un Mac Apple Silicon, Homebrew normalmente se encuentra aquí:

/opt/homebrew/bin

En un Mac Intel, Homebrew suele encontrarse aquí:

/usr/local/bin

Para el installer Python de python.org pueden aparecer rutas como:

/Library/Frameworks/Python.framework/Versions/3.12/bin

Para Node.js instalado mediante version manager, pueden aparecer rutas dentro de la home folder del usuario.

5. Dónde se configura PATH en zsh

En las versiones modernas de macOS, el shell estándar es zsh.

Para zsh se utilizan con mayor frecuencia los archivos:

~/.zprofile
~/.zshrc

Pero no se pueden editar manualmente sin entenderlo.

Importante:

No hay que insertar líneas al azar en .zshrc, .zprofile, .bash_profile u otros archivos shell.

Una línea incorrecta en PATH puede romper el terminal, package managers o provocar que se ejecute la versión equivocada de Python/Node/Git.

6. Homebrew y PATH

Después de instalar Homebrew en macOS, normalmente él mismo muestra el comando que hay que añadir al shell profile.

En Apple Silicon suele parecerse a:

eval "$(/opt/homebrew/bin/brew shellenv)"

Pero no se puede copiar esta línea a todos sin comprobar.

Acción correcta:

hacer una captura o copiar la salida del Homebrew installer -> enviarla a Claude Code -> ejecutar el comando exacto que Claude Code confirmó para el Mac concreto

7. Qué debe funcionar después de configurar PATH

Checklist mínimo:

git --version
gh --version
codex --version
python3 --version
node --version
pnpm --version

Si Homebrew está instalado:

brew --version

Si todos los comandos se inician desde una nueva ventana de Terminal.app, PATH está configurado suficientemente bien para Claude Code.

8. Después de cambiar PATH hay que abrir un nuevo Terminal.app

Después de modificar shell profile, una ventana antigua de Terminal.app puede no ver los cambios.

Hay que:

Cerrar la ventana actual de Terminal.app.
Abrir una nueva ventana de Terminal.app.
Ejecutar de nuevo las comprobaciones:

echo "$PATH" | tr ':' '\n'
command -v codex
command -v gh
command -v python3
command -v node
command -v pnpm

9. No buscar por cuenta propia instrucciones de PATH

Regla estricta:

Al configurar PATH en macOS hay que entender claramente qué línea exacta y en qué archivo exacto hay que añadir. Esto debe preguntarse a Claude Code, no buscarse en internet ni inventarse por cuenta propia.

La consulta correcta:

Claude Code, estoy configurando PATH en macOS para el entorno de Claude Code. Esta es la salida de echo "$PATH", command -v brew, command -v codex, command -v gh, command -v python3, command -v node, command -v pnpm. Dime si hay que añadir algo a ~/.zprofile o ~/.zshrc, y dame el comando exacto.

Si no se encuentra algún comando:

Claude Code, en macOS el comando node/pnpm/gh/codex/python3 no se encuentra en Terminal.app. Esta es la salida de echo "$PATH" y command -v. Ayúdame a corregir PATH de forma segura.

10. No usar sudo sin motivo

Para configurar PATH casi nunca hace falta utilizar sudo.

Si una instrucción de internet propone:

sudo nano /etc/paths

o editar archivos PATH del sistema, esto es una señal de alerta.

Para un entorno normal de Claude Code casi siempre bastan los archivos shell del usuario:

~/.zprofile
~/.zshrc

No se pueden modificar archivos del sistema como /etc/paths sin una razón explícita y sin la confirmación de Claude Code.

11. Regla

El decimotercer paso de la configuración:

En macOS hay que comprobar que todos los comandos clave del entorno Claude Code están disponibles desde Terminal.app mediante PATH: git, gh, codex, python3, node, pnpm, brew.

Regla estricta adicional:

PATH en macOS no se configura al azar. No buscamos comandos aleatorios en internet, no editamos .zshrc, .zprofile ni archivos del sistema sin entenderlo. Siempre preguntamos a Claude Code, mostramos el PATH actual y seguimos la instrucción exacta para el Mac concreto.

Paso 14. Instalar FFmpeg para trabajar con audio y vídeo

En nuestro trabajo, Claude Code recibe con frecuencia tareas relacionadas con audio:

preparar una transcripción de voz;
cortar un archivo de audio;
convertir un formato;
extraer audio de vídeo;
comprobar la duración de un archivo;
normalizar o preparar un archivo para su posterior procesamiento;
utilizar herramientas Python y JavaScript que necesitan ffmpeg.

Por ello, FFmpeg es una herramienta del sistema obligatoria para el entorno Claude Code (Codex).

1. Qué es FFmpeg

FFmpeg es un conjunto de herramientas command-line para trabajar con audio y vídeo.

Los comandos más importantes:

ffmpeg
ffprobe

ffmpeg realiza conversión, corte, extracción de audio y otras operaciones.

ffprobe muestra información técnica sobre un archivo multimedia: duración, codecs, pistas, bitrate, sample rate y otros parámetros.

2. FFmpeg no está integrado en macOS

FFmpeg normalmente no es una parte estándar de macOS.

Debe instalarse por separado.

Comprobar si FFmpeg está instalado:

ffmpeg -version
ffprobe -version

Si los comandos no se encuentran, hay que instalar FFmpeg.

3. No buscar por cuenta propia el enlace o comando

En Windows, FFmpeg se instala con frecuencia manualmente: descargar un archivo desde un enlace, descomprimirlo, colocarlo en la carpeta raíz del disco C:\ y después especificar la ruta en Path.

En macOS, el enfoque principal es diferente. Con mayor frecuencia, FFmpeg se instala mediante package manager, normalmente Homebrew.

Regla estricta:

Hay que preguntar a Claude Code el enlace para descargar FFmpeg, el comando de instalación y la instrucción para especificar la ruta. No hay que buscar instrucciones aleatorias en internet ni inventar la ruta por cuenta propia.

La consulta correcta:

Claude, necesito instalar FFmpeg en macOS para trabajar con audio, vídeo y transcripciones. Indícame el método oficial/recomendado actual de instalación para mi Mac y dime si hay que configurar PATH.

Si la instalación es manual:

Claude, estoy instalando FFmpeg manualmente en macOS. Dime dónde colocar correctamente ffmpeg y ffprobe, y qué línea añadir a PATH para zsh. Este es mi echo "$PATH" actual y uname -m.

4. Método recomendado en macOS

Si Homebrew ya está instalado y funciona, el método recomendado:

brew install ffmpeg

Después de la instalación comprobar:

ffmpeg -version
ffprobe -version

Si los comandos funcionan, normalmente no es necesario especificar la ruta por separado: Homebrew instala los binarios en su prefix, que ya debe estar en PATH.

En un Mac Apple Silicon normalmente es:

/opt/homebrew/bin

En un Mac Intel suele ser:

/usr/local/bin

5. Si Homebrew no está instalado

Si Homebrew todavía no está instalado, no hay que descargar inmediatamente un archivo aleatorio de FFmpeg.

Hay que preguntar a Claude Code (Codex):

Claude, mi Mac todavía no tiene Homebrew, pero necesito instalar FFmpeg para el entorno de Claude Code. ¿Qué es más correcto: instalar primero Homebrew o utilizar un binary manual? Dame una instrucción segura para macOS.

En la mayoría de los casos, la vía correcta para el equipo:

primero Homebrew -> después brew install ffmpeg

La instalación manual de binary es admisible solo si existe una razón para no utilizar Homebrew.

6. Instalación manual en macOS

La instalación manual de FFmpeg en macOS no se realiza por defecto.

Si aun así es necesaria, no hay que colocar archivos en la raíz del disco como en Windows.

En macOS es mejor utilizar una ubicación Unix de usuario o estándar, por ejemplo:

~/bin

o otra carpeta que Claude Code haya confirmado explícitamente para el Mac concreto.

Después de esto, la ruta a la carpeta debe llegar a PATH.

Pero una vez más:

Dónde colocar exactamente ffmpeg y ffprobe, y qué línea exacta añadir a ~/.zprofile o ~/.zshrc, debe preguntarse a Claude Code teniendo en cuenta el PATH actual.

7. Comprobar PATH

Después de instalar, comprobar que Terminal.app ve los comandos:

command -v ffmpeg
command -v ffprobe

Resultado esperado para una instalación mediante Homebrew en Apple Silicon:

/opt/homebrew/bin/ffmpeg
/opt/homebrew/bin/ffprobe

Resultado esperado para una instalación mediante Homebrew en Intel Mac:

/usr/local/bin/ffmpeg
/usr/local/bin/ffprobe

Si command -v no muestra nada, significa que FFmpeg está instalado en otro lugar o que la carpeta no llegó a PATH.

Entonces hay que preguntar a Claude Code:

Claude Code, FFmpeg está instalado en macOS, pero command -v ffmpeg no muestra nada. Esta es la salida de echo "$PATH", brew --prefix y ls de la carpeta necesaria. Ayúdame a añadir FFmpeg a PATH de forma segura.

8. Comprobar el funcionamiento con un archivo

Después de instalar es útil comprobar no solo la versión, sino también el propio funcionamiento de ffprobe.

Ejemplo:

ffprobe -hide_banner path/to/audio-or-video-file

Si todavía no hay archivo, basta con:

ffmpeg -version
ffprobe -version

9. Relación con Python y JavaScript

Algunos paquetes Python y JavaScript pueden utilizar FFmpeg internamente:

imageio-ffmpeg;
audio/video processing scripts;
transcription pipelines;
video conversion utilities;
tools that extract audio from video.

Es importante entender:

El paquete Python imageio-ffmpeg no elimina la necesidad de tener ffmpeg del sistema si el proyecto o los scripts de Claude Code esperan los comandos command-line ffmpeg y ffprobe.

Por ello, la comprobación ffmpeg -version es obligatoria.

10. No usar sudo sin motivo

Durante la instalación mediante Homebrew normalmente no hay que utilizar sudo manualmente.

Si una instrucción aleatoria propone:

sudo cp ffmpeg /usr/bin
sudo nano /etc/paths

esto es una señal de alerta.

Hay que detenerse y preguntar a Claude Code.

11. Regla

El decimocuarto paso de la configuración:

Para trabajar con audio, vídeo y transcripciones en macOS hay que instalar FFmpeg y comprobar los comandos ffmpeg y ffprobe.

Vía recomendada:

brew install ffmpeg

Regla estricta adicional:

El enlace para descargar FFmpeg, el comando de instalación y la instrucción de PATH siempre se preguntan a Claude Code. No buscamos instrucciones aleatorias en internet, no colocamos archivos en carpetas del sistema ni especificamos rutas al azar.

Paso 15. Instalar un editor de texto para Markdown y YAML

Para el entorno Claude Code (Codex) en macOS es obligatorio contar con un buen editor de texto.

Su tarea no es sustituir un IDE ni convertirse en la principal herramienta de programación. Su tarea es más sencilla e importante:

abrir rápidamente un archivo Markdown;
abrir rápidamente un archivo YAML;
leer la estructura de un documento;
corregir texto, encabezados, listas, configuraciones;
ver syntax highlighting;
no romper la codificación;
no convertir plain text en rich text;
no añadir formato invisible.

1. Por qué TextEdit no es suficiente

macOS cuenta con TextEdit integrado, pero no lo consideramos un editor suficiente para el entorno Claude Code (Codex).

La razón: TextEdit está orientado no solo a plain text, sino también a rich text. Esto aumenta el riesgo de romper accidentalmente Markdown, YAML o un archivo de configuración.

Para nuestro trabajo se necesita precisamente un plain-text editor.

2. Formatos principales

El editor debe trabajar con seguridad al menos con:

.md
.markdown
.yaml
.yml
.txt
.json
.toml
.env

Son especialmente importantes:

Markdown
YAML

Markdown se necesita para instrucciones, documentación, prompts, archivos handoff, product docs y materiales de Claude Code (Codex).

YAML se necesita para configuraciones, CI/CD, GitHub Actions, docker-compose, archivos de automatización y descripciones de infraestructura.

3. Editores Best practice en macOS

Para macOS, las variantes normales:

CotEditor
Sublime Text
BBEdit
Visual Studio Code

CotEditor

Un buen plain-text editor gratuito y nativo de macOS.

Adecuado como variante básica para el equipo si se necesita un editor sencillo, rápido y claro para Markdown/YAML.

Sublime Text

Un editor profesional muy rápido.

Adecuado como variante de pago o freemium para quienes están acostumbrados a Sublime en lugar de Notepad++.

BBEdit

Un editor de texto profesional clásico de macOS.

Es bueno para archivos de texto grandes, búsqueda, plain text, Markdown, HTML/XML y textos técnicos.

4. Estándar recomendado para el equipo

Estándar mínimo:

CotEditor

Estándar ampliado:

CotEditor + Visual Studio Code

Alternativa de pago/profesional:

Sublime Text o BBEdit

Lo principal:

En Mac debe haber al menos un plain-text editor normal que abra rápidamente Markdown y YAML.

5. No buscar por cuenta propia el enlace

Regla estricta:

Hay que preguntar a Claude Code (Codex) el enlace para descargar el editor de texto y el método de instalación. No hay que buscar sitios de descarga aleatorios en internet.

La consulta correcta:

Claude, necesito instalar en macOS un editor de texto para Markdown y YAML en el entorno de Claude Code. Indícame la fuente oficial de descarga para CotEditor/Sublime Text/BBEdit y la mejor opción para mi tarea.

Si la persona ya ha elegido un editor:

Claude, quiero instalar Sublime Text/CotEditor/BBEdit en macOS. Dame la fuente oficial de descarga y comprueba qué build elegir para Apple Silicon o Intel Mac.

6. Instalación

Fuentes seguras posibles:

sitio oficial del editor;
Mac App Store;
Homebrew cask oficial, si el equipo ya utiliza Homebrew.

No se pueden descargar editores de random download-sites, mirrors, fuentes "free cracked", "portable build" y similares.

Si la instalación se realiza mediante Homebrew, el comando también se pregunta a Claude Code:

Claude, ¿se puede instalar el editor de texto elegido mediante Homebrew cask en macOS? Dame un comando seguro y la fuente oficial.

7. Comprobación después de la instalación

Después de instalar hay que comprobar:

El editor se abre.
Se puede abrir .md.
Se puede abrir .yaml y .yml.
Se ve el resaltado de sintaxis.
El archivo se guarda como plain text.
El editor no añade formato rich-text.

Archivos de prueba:

test.md
test.yaml

Ejemplo de YAML:

name: codex-macos-setup
tools:
  - codex
  - git
  - homebrew

Ejemplo de Markdown:

# Claude Code macOS setup

- Markdown works
- YAML works

8. Configurar la apertura de archivos

Después de la instalación se puede configurar el default editor para .md, .yaml, .yml.

Pero no es obligatorio hacerlo de forma idéntica para todas las personas.

Si hace falta convertir el editor en la aplicación predeterminada, pregunte a Claude Code:

Claude, quiero convertir CotEditor/Sublime Text/BBEdit en el editor predeterminado para .md, .yaml y .yml en macOS. Dame una instrucción paso a paso mediante Finder.

9. No instalar extensions adicionales sin comprobar

Si se utiliza VS Code u otro editor con extensions/plugins, no se pueden instalar extensions aleatorias.

Regla:

Las extensions para Markdown, YAML, GitHub, OpenAI, formatting y preview se instalan solo después de comprobarlas con Claude Code (Codex).

La razón: las extensions tienen acceso a archivos del proyecto y pueden afectar a la seguridad, formato y comportamiento del editor.

10. Regla

El decimoquinto paso de la configuración:

En macOS debe estar instalado obligatoriamente un plain-text editor para trabajar rápidamente con Markdown y YAML. La variante mínima recomendada es CotEditor. Las alternativas profesionales son Sublime Text o BBEdit. VS Code se puede utilizar como un code editor más pesado.

Regla estricta adicional:

El enlace de descarga, el método de instalación, la elección de build Apple Silicon/Intel y la configuración del default editor se preguntan a Claude Code. No descargamos editores de random download-sites ni instalamos extensions sin comprobar.

Paso 16. Instalar Obsidian para documentos Markdown de producto

Si se dedica al trabajo de producto, un editor de texto habitual puede quedarse rápidamente corto.

Los archivos Markdown se vuelven muchos. Aparecen carpetas, subcarpetas, borradores, traducciones, archivos handoff, source of truth, call notes, tesis de producto, ADR, vision documents y otros materiales.

En un editor de texto habitual se puede empezar a confundir rápidamente:

dónde está el archivo necesario;
qué versión está actualizada;
qué documentos están relacionados entre sí;
dónde está la carpeta de producto Data;
qué pertenece al proyecto y qué a un borrador antiguo;
qué archivos ya están listos y cuáles siguen en trabajo.

Para esto se necesita Obsidian.

1. Qué es Obsidian

Obsidian es una aplicación local para trabajar con archivos Markdown y una base de conocimientos.

Importante:

Obsidian funciona localmente.
Obsidian funciona sobre una carpeta habitual con archivos Markdown.
Obsidian no convierte sus documentos en un formato web cerrado.
Obsidian no requiere autorización obligatoria para el trabajo básico.
Obsidian es gratuito para utilizar.

No es un servicio web, ni SaaS, ni un sustituto de GitHub/Google Drive/Confluence.

Es una capa local para trabajar cómodamente con su carpeta de documentos Markdown.

2. Primera supercapacidad: ver la estructura de los archivos de producto

Obsidian se puede conectar a su carpeta de producto, por ejemplo:

~/Documents/Claude/Product/Data

o a otra carpeta donde se encuentre la base de conocimientos de producto.

Después de esto, Obsidian muestra:

árbol de archivos;
carpetas;
documentos Markdown;
enlaces entre notas;
búsqueda rápida;
preview Markdown;
navegación cómoda.

Esto es especialmente importante para el trabajo de producto, donde no hace falta simplemente abrir un archivo, sino comprender toda la estructura de documentos.

3. Segunda supercapacidad: edición paralela con IA

Obsidian es muy cómodo para el trabajo conjunto de una persona y una IA.

Escenario:

Por un lado está abierto Obsidian.
En él, la persona edita manualmente un documento Markdown.
Por otro lado está abierto Claude Code/Codex/interfaz de IA.
La persona pide a la IA modificar ese mismo documento: sustituir un término, reescribir un bloque, estructurar una sección, limpiar una repetición, traducir texto o adaptar el archivo a una plantilla.
El cambio aparece en el archivo.
Obsidian muestra inmediatamente el documento actualizado.

Esto se siente casi como una edición conjunta de un documento por una persona y una IA.

Ejemplos de tareas:

Claude Code (Codex), sustituye en este documento el término MetaSites por Metasites.
Claude Code (Codex), adapta este Markdown a la estructura Source of Truth.
Claude Code (Codex), extrae todas las preguntas a Dima en una sección separada.
Claude Code (Codex), comprueba que el YAML frontmatter no esté roto.
Claude Code (Codex), haz la traducción rusa junto al inglés, sin perder la estructura.

Para el trabajo de producto esto es muy eficaz.

4. Tercera supercapacidad: plugins de Obsidian

Obsidian cuenta con un sistema de plugins desarrollado.

Los plugins pueden ayudar a:

organizar la base de conocimientos;
trabajar con tablas;
mejorar la búsqueda;
construir dashboards;
vincular documentos;
trabajar con templates;
mejorar la navegación;
gestionar tareas.

Pero los plugins de Obsidian no deben instalarse inmediatamente en bloque.

Regla estricta:

Al inicio utilizamos Obsidian como un Markdown workspace local. Instalamos plugins más tarde, solo si está claro qué tarea resuelven.

Antes de instalar un plugin hay que preguntar a Claude Code (Codex):

Claude, quiero instalar un plugin de Obsidian para mi base de producto de archivos Markdown. Explica si lo necesito, si es seguro y qué tarea concreta resuelve.

5. Cuarta posibilidad: gráfico de conocimiento

Obsidian tiene graph view: un gráfico visual de relaciones entre documentos.

Se puede construir un gráfico de conocimiento, y tiene un aspecto interesante.

Pero la posición actual honesta:

Todavía no hemos aprendido a aplicar eficazmente graph view en el trabajo cotidiano de producto.

Por eso se puede estudiar graph view, pero no debe considerarse una parte obligatoria del workflow básico.

Ahora es más importante para nosotros:

la estructura de carpetas;
búsqueda rápida;
edición cómoda de Markdown;
trabajo paralelo con IA;
guardar documentos como archivos .md locales habituales.

6. Instalación de Obsidian

Obsidian debe descargarse solo de la fuente oficial.

Regla estricta:

Hay que preguntar a Claude Code (Codex) el enlace para descargar Obsidian y el método de instalación. No hay que buscar random download-sites.

La consulta correcta:

Claude, necesito instalar Obsidian en macOS para trabajar con una base Markdown de producto. Dame la fuente oficial de descarga, dime qué build elegir para Mac y explica cómo conectar una carpeta Data local como vault.

Para macOS, el installer oficial normalmente se descarga desde el sitio de Obsidian, después de lo cual la aplicación se arrastra a Applications.

7. Cómo conectar la carpeta de producto

En Obsidian, la carpeta de trabajo se llama:

vault

Para trabajo de producto, vault debe apuntar a una carpeta existente con archivos Markdown.

Por ejemplo:

~/Documents/Claude/Product/Data

~/Documents/Claude/<project>/Data

No hay que crear un vault nuevo aleatorio si ya tiene una carpeta de trabajo con documentos.

Hay que preguntar a Claude Code (Codex):

Claude, ayúdame a elegir la carpeta correcta del vault de Obsidian para mi trabajo de producto. Esta es la estructura de ~/Documents/Claude. Quiero editar archivos Markdown de producto y no romper la conexión con GitHub/Confluence.

8. Obsidian y Git

Obsidian edita archivos habituales en el disco.

Si esta carpeta es un Git repository, los cambios de Obsidian serán visibles mediante:

git status
git diff

Esto es cómodo, pero requiere disciplina.

Regla:

Antes de la edición masiva de documentos con IA en Obsidian hay que comprobar git status para entender qué cambios ya existen.

9. Obsidian no sustituye a Confluence

Obsidian es cómodo solo para el trabajo local con Markdown.

Confluence se necesita para publicación, lectura conjunta, acceso corporativo y páginas acordadas.

La combinación correcta:

Obsidian = edición local y estructura de Markdown
Claude Code (Codex) = edición con IA y automatización
GitHub = versión y sincronización
Confluence = publicación y consumo corporativo

10. Regla

El decimosexto paso de la configuración:

Si se dedica al trabajo de producto, instale Obsidian como una capa local para documentos Markdown y conéctelo a la carpeta Data correcta u otra base de conocimientos de producto.

Regla estricta adicional:

Obsidian se descarga solo de la fuente oficial que solicitamos a Claude Code (Codex). El vault se elige conscientemente: debe apuntar a la carpeta local correcta de documentos, y no crear una estructura nueva aleatoria.

Paso 17. Instalar un IDE o code editor, pero no convertirlo en la interfaz principal de IA

Después de instalar un plain-text editor para Markdown y YAML se puede instalar un editor de código completo: VS Code, Cursor o un equivalente.

Es importante distinguir los términos cuidadosamente.

VS Code, Cursor, Windsurf y aplicaciones similares se llaman con frecuencia IDE, pero técnicamente muchas están más cerca de:

code editor / AI code editor

Un IDE completo normalmente incluye un conjunto integrado más pesado de capacidades: project system, debugger, profiler, GUI builders, language-specific tooling, etc. Pero en el habla cotidiana los desarrolladores suelen llamar IDE a VS Code y Cursor. En esta instrucción puede utilizarse el término general:

IDE / code editor

1. El IDE es necesario, pero no es el primer ni el principal paso

En los antiguos hábitos del desarrollador, instalar VS Code, Cursor u otro IDE se considera con frecuencia el primer y principal paso de configuración del ordenador.

En el entorno Claude Code (Codex) ya no es así.

El IDE se necesita para:

leer y editar código;
navegar por el proyecto;
resaltado de sintaxis;
trabajar con Git diff;
ejecutar scripts localmente;
debugging;
workflows TypeScript/Python/React/Node.js;
corrección manual puntual de archivos.

Pero el IDE no debe ser la interfaz principal de comunicación con IA.

2. Por qué la interfaz principal de IA es Claude Code (Codex) GUI

Nuestro trabajo con Claude Code (Codex) no se basa solo en texto.

Utilizamos constantemente:

mensajes de voz;
grandes planteamientos orales de tareas;
capturas de errores;
capturas de interfaces;
cuestionarios de IA;
imágenes y diseños;
archivos;
diálogo secuencial;
comprobación de resultados;
explicación del contexto en lenguaje humano habitual.

Claude Code (Codex) GUI es más cómodo para este modo, porque se adapta mejor a conversar con el agente, transmitir capturas, contexto de voz y archivos.

IDE/code editor es bueno dentro del código, pero peor como interfaz conversacional principal para AI-vibecoding.

3. La dura nueva realidad

Los desarrolladores están acostumbrados a pensar:

primero instalamos IDE -> después empezamos a trabajar

Para el trabajo con Claude Code (Codex) es más correcto:

primero preparamos macOS, Claude Code, terminal, Git, Homebrew, Python, Node.js, PATH y herramientas multimedia -> después instalamos IDE/code editor como una herramienta de trabajo adicional

El IDE ya no es el centro de todo el desarrollo.

El centro del workflow de AI-vibecoding es Claude Code (Codex) y un entorno correctamente preparado.

4. Por qué no conviene realizar el trabajo de IA solo mediante IDE

No prohibimos VS Code, Cursor ni sus equivalentes.

Pero no recomendamos en absoluto construir todo el trabajo de IA solo mediante IDE, porque:

la entrada de voz en IDE suele ser menos cómoda que en un workflow Claude Code (Codex) especialmente organizado;
el trabajo con capturas e imágenes puede ser más lento;
no siempre es cómodo transmitir gran contexto por voz;
no siempre es cómodo mantener un diálogo largo de producto o arquitectura;
el IDE provoca entrar directamente en el código, en lugar de formular primero correctamente la tarea;
el desarrollador empieza a discutir con el agente a nivel de archivos, en vez de proporcionar primero contexto completo, criterios de finalización y restricciones.

Sí, los editores modernos evolucionan. VS Code cuenta con Copilot Chat, extensions, capacidades de voz/speech e image inputs. Cursor se posiciona como un editor agent-first. Pero esto no elimina nuestra regla de equipo ahora mismo:

IDE/code editor es una herramienta para trabajar con código. Claude Code (Codex) GUI es la interfaz principal para plantear tareas, comunicación por voz, capturas, archivos y trabajo con agentes.

5. Qué IDE/code editor instalar en macOS

Variantes normales:

Visual Studio Code
Cursor
Windsurf
JetBrains IDEs

Para nuestro equipo, la variante básica:

Visual Studio Code

Si la persona ya utiliza Cursor, puede instalar Cursor, pero no convertirlo en la única interfaz de IA del equipo.

JetBrains IDEs tienen sentido para stacks concretos: Java, Kotlin, backend, mobile, heavy refactoring. Pero no son obligatorios para el entorno básico Claude Code (Codex).

6. No descargar IDE de fuentes aleatorias

Regla estricta:

Hay que preguntar a Claude Code (Codex) el enlace para descargar VS Code, Cursor u otro IDE/code editor. No hay que buscar el instalador en internet por cuenta propia.

La consulta correcta:

Claude, necesito instalar VS Code/Cursor en macOS para el entorno de Claude Code. Dame la fuente oficial de descarga, dime qué build elegir para Apple Silicon o Intel Mac, y qué comprobar después de la instalación.

Si la instalación se realiza mediante Homebrew:

Claude, ¿se puede instalar VS Code/Cursor mediante Homebrew cask en macOS? Dame un comando seguro y la fuente oficial.

7. Qué comprobar después de la instalación

Después de instalar IDE/code editor hay que comprobar:

La aplicación se abre.
Se puede abrir una carpeta de proyecto desde `~/Documents/Claude.
Se ven los archivos del proyecto.
Se abren .md, .yaml, .json, .ts, .js, .py.
El terminal dentro del editor ve los comandos:

git --version
python3 --version
node --version
pnpm --version
codex --version

El editor no rompe line endings, encoding y YAML indentation.

Si el terminal integrado del IDE no ve comandos, pero el Terminal.app habitual sí los ve, significa que hay un problema con shell/PATH dentro del IDE. Hay que mostrarlo a Claude Code (Codex).

8. Extensions y plugins

No hace falta instalar muchas extensions de inmediato.

Categorías mínimamente útiles:

Markdown;
YAML;
Git/GitHub;
Python;
JavaScript/TypeScript;
formatter/linter solo para el proyecto concreto.

Regla estricta:

Las extensions se instalan solo después de comprobarlas con Claude Code y solo para una tarea concreta. No instalamos AI/extensions packs aleatorios.

La razón: las extensions tienen acceso a workspace, archivos, terminal, environment variables y en ocasiones tokens, y deben ser solo versiones oficiales y seguras. Instalar una extension desconocida puede provocar una vulnerabilidad en su desktop.

9. Cómo explicar esto a los desarrolladores

Formulación para el equipo:

No les quitamos VS Code ni Cursor. Pueden utilizarlos para leer y editar código.

Pero el AI-workflow principal del equipo se realiza mediante Claude Code (Codex) GUI, porque ahí es más rápido y natural plantear tareas por voz, adjuntar capturas, proporcionar archivos, discutir arquitectura y comprobar el resultado.

El IDE sigue siendo una herramienta de trabajo manual con código. Claude Code (Codex) GUI se convierte en la interfaz principal de trabajo con el agente de IA.

No es una cuestión de gusto. Es una cuestión de velocidad, calidad de contexto y reducción de la cantidad de errores.

10. Regla

El decimoséptimo paso de la configuración:

En macOS se puede y se debe instalar IDE/code editor, normalmente VS Code o Cursor. Pero el IDE no es la interfaz principal de IA del equipo. La interfaz principal de AI-vibecoding es Claude Code (Codex) GUI.

Regla estricta adicional:

El IDE se descarga solo de la fuente oficial que solicitamos a Claude Code (Codex). Las extensions se instalan con cuidado y solo después de comprobarlas. Si el terminal del IDE no ve git, python3, node, pnpm o codex, no lo repare al azar, sino que muestre a Claude Code (Codex) la salida de los comandos y el PATH actual.

Paso 19. Por qué es necesaria toda esta configuración

Después de realizar todos los puntos anteriores, el usuario obtiene un entorno macOS configurado de calidad para trabajar con Claude Code, Codex y otras herramientas de desarrollo de IA.

Esta instrucción no es necesaria por formalidad ni por amor a instalar programas.

Se necesita para que AI-vibecoding sea rápido, predecible, seguro y económicamente razonable.

1. No obligar a la IA a desarrollar herramientas faltantes

Si en el ordenador no están instalados Git, Python, Node.js, pnpm, FFmpeg, GitHub CLI, Xcode Command Line Tools u otra herramienta básica, el agente de IA empieza a gastar tiempo no en la tarea, sino en corregir el entorno inexistente.

Esto lleva a escenarios malos:

Claude Code (Codex) intenta sustituir la herramienta faltante con un script temporal;
Claude Code empieza a buscar soluciones alternativas;
el agente propone instalaciones innecesarias;
la tarea se expande;
aumenta el gasto de tokens;
aumenta el tiempo de ejecución;
el coste final del trabajo se vuelve varias veces mayor.

Es importante que su Claude Code durante vibecoding puede no comunicarle la falta de una herramienta, y usted nunca se enterará de ello. Pero observará durante mucho tiempo el trabajo del agente de IA resolviendo problemas interminables.

Conclusión correcta:

Las herramientas básicas deben instalarse de antemano. La IA no debe gastar tiempo de trabajo inventando lo que debería ser parte del entorno.

2. No obligar a la IA a luchar con accesos y permisos

Un Mac mal preparado puede romper el trabajo de Claude Code (Codex) no por un error en el código, sino por el entorno:

no hay privilegios de administrador;
macOS antigua;
las actualizaciones no están instaladas;
Terminal.app no ve comandos;
PATH está roto;
firewall o VPN bloquea la red;
GitHub CLI no está autorizado;
Google API no está activada;
FFmpeg no se encuentra;
Python packages se instalan globalmente y entran en conflicto;
los paquetes Node.js se instalaron mediante el package manager equivocado;
el terminal del IDE ve otro environment.

En estas condiciones, la IA empieza a luchar no con la tarea, sino con el ordenador.

Esto hace que AI-vibecoding sea lento, caro y desagradable. A menudo lleva a la decepción de que la IA es tonta y funciona mal.

Es importante que su Claude Code durante vibecoding puede no comunicarle la falta de un acceso o permiso, y usted nunca se enterará de ello. Pero observará durante mucho tiempo el trabajo del agente de IA resolviendo problemas interminables de accesos.

Conclusión correcta:

El entorno debe configurarse de modo que Claude Code (Codex) pueda leer inmediatamente archivos, ejecutar comandos, descargar dependencias, trabajar con GitHub, audio, vídeo, Python, Node.js y Google APIs.

3. Protegerse de los bucles

Uno de los problemas más costosos del desarrollo con IA es entrar en un bucle.

Un bucle surge cuando el agente intenta una y otra vez resolver el mismo problema de infraestructura:

el comando no se encuentra;
el paquete no se instala;
PATH no se actualizó;
permissions no permiten leer o escribir un archivo;
una network request está bloqueada;
API no está activada;
credentials no funcionan;
falta el compiler;
no se encuentra FFmpeg;
las versiones Python/Node entran en conflicto.

Cada uno de estos ciclos consume:

tiempo del usuario;
tokens;
dinero;
atención;
confianza en la herramienta de IA.

Es importante que su Claude Code durante vibecoding, en caso de haber caído en un bucle, no le comunicará el problema real; posiblemente solo pueda adivinarlo por el contexto de los mensajes.

Conclusión correcta:

Una buena configuración previa del entorno es una protección contra los bucles de Claude Code o Codex.

4. Por qué el orden es importante

El orden de instalación no es aleatorio.

No se puede empezar por el IDE y esperar que todo lo demás aparezca solo.

La secuencia correcta reduce la cantidad de errores:

macOS -> admin account -> Claude Code (Codex) -> Terminal/zsh -> screenshots -> Xcode Command Line Tools -> Git -> Homebrew -> GitHub CLI -> Python -> Python packages -> Node.js/pnpm -> network/firewall -> PATH -> FFmpeg -> text editor -> IDE -> plugins -> Google APIs

Si se altera el orden, se pueden producir errores extraños:

Git está instalado, pero faltan compiler tools;
Homebrew está instalado, pero brew no está en PATH;
GitHub CLI está instalado, pero no hay GitHub account;
Python packages se instalan en una versión incorrecta de Python;
Node.js está presente, pero pnpm no funciona;
FFmpeg está instalado, pero Claude Code (Codex) no lo ve;
existen Google API credentials, pero las API no están activadas.

5. Sentido económico

Estas reglas ahorran:

tiempo;
dinero;
tokens;
nervios;
horas de trabajo del equipo.

También aumentan la calidad del resultado:

Claude Code (Codex) se distrae menos;
menos instalaciones aleatorias;
menos conflictos de versiones;
menos errores de acceso;
menos bloqueos de red;
menos pánico manual;
más desarrollo estable.

6. Sentido humano

El objetivo de esta instrucción es hacer que el trabajo con IA sea agradable, no decepcionante.

Un entorno mal configurado crea la sensación de que la IA "se atasca", "entra en un bucle", "no sabe", "no puede instalar el paquete", "no entiende Mac" o "rompe el proyecto".

A menudo el problema no está en la IA.

El problema es que el ordenador no fue preparado para AI-vibecoding.

El entorno correcto cambia la sensación de trabajo:

menos lucha -> más resultado
menos diagnóstico -> más desarrollo
menos irritación -> más disfrute de la IA

7. Regla final

El decimonoveno paso de la configuración:

Seguir toda la instrucción y el orden de instalación no por burocracia, sino para ahorrar tiempo, dinero y atención. Un buen entorno no permite que Claude Code y Codex se desvíen hacia el desarrollo de herramientas faltantes, luchen con accesos y caigan en costosos ciclos de errores.

Resultado:

Un Mac configurado correctamente hace AI-vibecoding más rápido, más barato, más tranquilo y mucho más agradable.

Paso 20. Configurar plugins de Claude Code (Codex) y servidores MCP

Después de configurar el entorno macOS, se puede pasar a configurar el propio Claude Code (Codex).

En esta etapa es importante instalar plugins que conecten Claude Code (Codex) a los servicios de trabajo del equipo: correo, calendario, documentos, tareas, repositorios, diseño y sistemas internos.

1. Qué es un plugin en Claude Code (Codex)

En Claude Code (Codex), un plugin es un installable bundle que amplía las capacidades del agente.

Un plugin puede incluir:

skills;
app integrations/connectors;
MCP servers;
comandos;
hooks;
assets;
ajustes y metadata.

De forma simplificada se puede pensar así:

plugin = paquete preparado de capacidades para Claude Code (Codex)

A menudo dentro de un plugin realmente hay un MCP server y un conjunto de skills para trabajar con él. Pero técnicamente un plugin puede ser más amplio que simplemente "MCP server + skills".

2. Qué es un servidor MCP

Un MCP server es una capa entre la interfaz de IA y un backend/service externo.

Permite a Claude Code (Codex) trabajar con un sistema externo mediante tools:

leer datos;
buscar datos;
crear tareas;
actualizar documentos;
trabajar con archivos;
obtener contexto;
ejecutar operaciones permitidas.

Fórmula simple:

MCP server = puente entre el chat de IA y el backend de otro producto

Por ejemplo, un servidor MCP puede conectar Claude Code (Codex) a:

GitHub;
Gmail;
Google Drive;
Google Calendar;
Jira;
Confluence;
Figma;
backend interno;
Xolo;
Metasites;
cualquier otro producto que tenga una interfaz MCP.

3. Plugins y MCP no son lo mismo

Es importante distinguir:

Plugin
MCP server
Connector/App integration
Skill

Plugin es el empaquetado de capacidades.

MCP server es una de las formas de proporcionar a Claude Code (Codex) tools para trabajar con un servicio externo.

Skill es una instrucción o workflow que enseña a Claude Code (Codex) a realizar correctamente un tipo concreto de tareas.

Connector/app integration es una conexión autorizada a un servicio como Google Drive, Gmail, Calendar, GitHub o Atlassian.

En el habla cotidiana se puede decir "plugin de Gmail" o "plugin de GitHub", pero es importante entender que dentro puede haber un conjunto de componentes diferentes.

4. Qué plugins se necesitan en primer lugar

Para nuestro trabajo de producto, corporativo y de desarrollo, el conjunto básico:

Google services
Atlassian Rovo
GitHub
Figma

Google services

Se necesitan para trabajar con:

Gmail;
Google Calendar;
Google Drive;
Google Docs;
Google Sheets;
Google Slides.

Estos plugins/connectors permiten a Claude Code (Codex) ayudar con correo, calendario, documentos, archivos, hojas de cálculo y presentaciones.

Atlassian Rovo

Se necesita para trabajar con:

Jira;
Confluence;
tareas;

Importante: el nombre correcto del plugin para Jira es Atlassian Rovo

GitHub

Se necesita para coordinar el desarrollo:

repositorios;
issues;
pull requests;
review comments;
CI;
GitHub Actions;
draft PR;
escenarios de handoff de desarrollo.

Figma

Se necesita para trabajar con diseño:

leer el contexto de diseño;
crear o actualizar diseños;
trabajar con componentes;
construir pantallas;
preparar design-to-code workflow;
trabajar con FigJam/Slides, si se requiere.

Figma no es un plugin obligatorio para cada persona, pero para trabajo relacionado con producto y diseño es muy eficaz.

5. Dónde instalar plugins

En Claude Code (Codex) app hay que abrir la sección:

Plugins

Después:

Encontrar el plugin necesario.
Abrir sus details.
Pulsar install/add.
Si el plugin requiere conexión a un servicio externo, realizar authorization.
Después de instalar, iniciar un nuevo thread o reiniciar la sesión de trabajo si Claude Code (Codex) lo requiere.

En Claude Code (Codex) CLI se pueden abrir plugins mediante:

/plugins

7. La autorización es obligatoria

Después de instalar la mayoría de los plugins de trabajo hay que autorizarse.

Esto es normal: la autorización da al plugin acceso precisamente a sus datos en un servicio concreto.

Ejemplos:

Gmail plugin debe obtener acceso a Gmail;
Google Calendar plugin debe obtener acceso al calendario;
Google Drive plugin debe obtener acceso a Drive/Docs/Sheets/Slides;
GitHub plugin debe obtener acceso a GitHub;
Atlassian Rovo debe obtener acceso al workspace de Jira/Confluence;
Figma plugin debe obtener acceso a los archivos de Figma.

Sin autorización, un plugin puede estar instalado, pero no podrá trabajar con datos reales.

8. Seguridad de la autorización

Los plugins deben autorizarse solo:

en un ordenador de trabajo protegido;
en la cuenta de trabajo correcta;
para servicios que realmente utiliza;
entendiendo qué permissions se conceden;
sin dar acceso excesivo.

Si la ventana de autorización muestra scopes/permissions incomprensibles, hay que hacer una captura y preguntar a Claude Code (Codex).

La consulta correcta:

Claude, estoy autorizando un plugin para Gmail/Google Drive/GitHub/Atlassian/Figma. Esta es la captura de permissions. Explica qué estoy permitiendo exactamente y si es seguro para la tarea de trabajo.

9. Conexión directa de servidores MCP

No todos los sistemas externos se proporcionan como un marketplace plugin preparado.

A veces hay que conectar un MCP server directamente mediante los ajustes de Claude Code o Codex.

Ejemplos:

MCP server Xsolla;
MCP server Metasites;
MCP server de un producto concreto;
backend personalizado;
MCP server local para desarrollo.

Regla:

Si un MCP server no es un plugin oficial del marketplace, debe conectarse solo siguiendo la instrucción exacta del propietario del servidor y después de comprobarlo con Claude Code (Codex).

10. No conectar plugins ni servidores MCP desconocidos

Los plugins y servidores MCP pueden obtener acceso a datos de trabajo.

Por ello, no se puede:

instalar random plugins;
conectar MCP endpoints incomprensibles;
conceder permissions sin entenderlos;
utilizar cuentas personales en lugar de cuentas de trabajo;
conectar servicios corporativos desde un ordenador no protegido;
guardar tokens/secrets en archivos abiertos.

11. Consulta correcta a Claude Code (Codex)

Antes de instalar un plugin:

Claude, necesito configurar plugins para el entorno de trabajo Claude Code. Utilizo Gmail, Google Calendar, Google Drive, Jira, Confluence, GitHub y Figma. Indícame qué plugins oficiales instalar, en qué orden y qué authorization steps esperar.

Antes de conectar un MCP server:

Claude, necesito conectar un MCP server a Claude Code. Esta es la documentación o endpoint del propietario del servidor. Comprueba la seguridad, explica qué tools proporcionará y dime cómo conectarlo correctamente en los ajustes.

12. Regla

El vigésimo paso de la configuración:

Después de configurar el entorno macOS hay que configurar los plugins de Claude Code (Codex): Google services, Atlassian Rovo, GitHub, Figma y otras integraciones de trabajo que la persona realmente necesite.

Regla estricta adicional:

Cada plugin debe autorizarse en la cuenta de trabajo correcta y hay que entender qué permissions obtiene. Los servidores MCP se conectan solo desde fuentes de confianza, siguiendo la instrucción del propietario y después de comprobarlo con Claude Code (Codex).

Paso 21. Configurar AGENTS.md, skills y la estructura de carpetas de proyectos

Después de configurar plugins, connectors y servidores MCP hay que configurar el comportamiento del propio Claude Code/Codex dentro de sus proyectos.

Tres grandes temas:

AGENTS.md
skills
estructura correcta de carpetas

Esto ya no es instalación del sistema operativo. Es la configuración de cómo el agente de IA comprenderá su trabajo, sus reglas, sus proyectos y sus procesos de equipo.

1. AGENTS.md: reglas generales para el agente de IA

AGENTS.md es un archivo de instrucciones para Claude Code (Codex).

Establece reglas consistentes:

cómo trabajar con el proyecto;
qué comandos ejecutar;
qué archivos no tocar;
qué comprobaciones son obligatorias;
cómo presentar el resultado;
cómo trabajar con Git;
cómo tratar la seguridad;
qué acuerdos del proyecto respetar.

De forma simplificada:

AGENTS.md = reglas de comportamiento de Claude Code (Codex) en su workspace

2. AGENTS.md global y de proyecto

Existen distintos niveles de reglas.

Archivo global:

~/.codex/AGENTS.md

Establece las reglas personales del usuario para todos los proyectos.

Archivo de proyecto:

<project-root>/AGENTS.md

Establece las reglas de un proyecto o repositorio concreto.

Dentro de subcarpetas puede haber reglas más concretas:

<project-root>/services/payments/AGENTS.md
<project-root>/apps/web/AGENTS.md

Claude Code (Codex) lee las instrucciones desde el nivel general hacia el más concreto. Por ello, las reglas más cercanas a la carpeta actual del proyecto pueden precisar o sobrescribir las reglas más generales.

3. AGENTS.md requiere una configuración independiente

AGENTS.md no puede escribirse al azar.

No es lugar para filosofía extensa ni para deseos contradictorios.

Un buen AGENTS.md debe ser:

corto;
concreto;
verificable;
relacionado con comandos reales del proyecto;
claro para la IA;
útil para tareas repetitivas.

Ejemplo de temas para AGENTS.md:

Usa pnpm si existe pnpm-lock.yaml.
Antes de los cambios comprueba git status.
No hagas commit de secrets.
Después de modificar scripts Python ejecuta pytest, si hay tests.
Después de modificar frontend ejecuta lint/build, si los comandos están disponibles.
No añadas nuevas production dependencies sin confirmación.

4. Skills: procesos de trabajo reutilizables

Skills son reusable workflows para Claude Code (Codex).

Un skill puede contener:

SKILL.md;
instrucciones;
archivos reference;
scripts;
templates;
assets.

De forma simplificada:

skill = habilidad de trabajo repetible que Claude Code (Codex) puede invocar

Por ejemplo:

carga de archivos Markdown en Confluence;
trabajo con service desk;
triage de tareas;
generación de status report;
publicación de documentos Product;
procesamiento de transcript;
preparación de Jira tickets;
trabajo con pipelines internos.

5. Por qué los skills ahorran tiempo

Si realiza una operación parecida cada día, debe convertirla en un skill.

Ejemplo:

subir un archivo a Confluence

Sin skill, Claude Code (Codex) debe entender de nuevo cada vez:

dónde está el archivo;
qué script utilizar;
qué credentials se necesitan;
cómo hacer dry-run;
cómo comprobar el resultado;
qué errores son típicos;
cómo no romper la publicación.

Con skill, esto se convierte en un workflow consistente.

Resultado:

Los skills ahorran tiempo, reducen errores y hacen que Claude Code (Codex) se parezca no a un asistente aleatorio, sino a un miembro del equipo formado.

6. Dónde se encuentran los skills

Para skills de proyecto:

<project-root>/.agents/skills

Para skills personales del usuario:

~/.agents/skills

Para skills del equipo o del sistema pueden utilizarse otras ubicaciones gestionadas.

Importante:

Los skills deben instalarse y almacenarse conscientemente. No hay que copiar skills aleatorios sin entender qué hacen.

7. Skills de la empresa y Neuronet

Si ya existen skills preparados en la empresa, deben utilizarse.

Son especialmente útiles:

skills para cargar archivos en Confluence;
skills para service desks;
skills para Jira;
skills para Confluence;
skills para workflows internos;
skills para tareas repetitivas de producto/documentación;
skills para escenarios Neuronet.

No son decoración. Son un enorme ahorro de tiempo.

Regla:

Si existe un skill preparado de la empresa para una tarea, primero utilizamos el skill, no pedimos a Claude Code (Codex) que reinvente el proceso cada vez.

8. Estructura correcta de carpetas

Además de AGENTS.md y skills hay que configurar correctamente las carpetas.

La combinación más importante:

carpeta local del proyecto
carpeta/workspace en Claude Code o Codex
GitHub repository

Estas tres capas deben apuntar al mismo proyecto.

Si divergen, empiezan los problemas:

Claude Code (Codex) trabaja en la carpeta equivocada;
GitHub repo no corresponde a los archivos locales;
la IA modifica el proyecto equivocado;
las instrucciones AGENTS.md no se cargan;
los skills están en el lugar equivocado;
Git status muestra cambios incorrectos;
el pull request sale de la rama equivocada;
el equipo no entiende dónde está la versión actual.

9. Estructura recomendada

Carpeta básica de proyectos en Mac:

~/Documents/Claude

Dentro de ella:

~/Documents/Claude/AI
~/Documents/Claude/Product
~/Documents/Claude/project-a
~/Documents/Claude/project-b
~/Documents/Claude/product-docs

Para el primer onboarding del equipo son especialmente útiles dos carpetas iniciales:

~/Documents/Claude/AI
~/Documents/Claude/Product

AI es para configurar Claude Code, instrucciones de IA, documentos handoff, formación y materiales de trabajo sobre procesos de IA.

Product es para la base de producto, documentos Markdown, PRD, especificaciones, transcripciones y archivos que pueden sincronizarse con GitHub y Confluence.

Cada carpeta de proyecto debe corresponder a su GitHub repository o ser explícitamente un non-code workspace.

Ejemplo:

~/Documents/Claude/my-app
  .git/
  AGENTS.md
  .agents/skills/
  package.json
  README.md

Claude Code/Codex debe abrirse precisamente en la carpeta del proyecto, no en una carpeta padre aleatoria.

10. Onboarding de un nuevo miembro: carpetas, Claude Code (Codex) y GitHub

Para un nuevo miembro del equipo, el orden debe ser el siguiente:

Abrir Documents.
Crear la carpeta Claude Code (Codex).
Dentro, crear las carpetas iniciales AI y Product u otras carpetas que el equipo haya acordado previamente.
En Claude Code/Codex, crear un proyecto no "desde cero", sino mediante la opción Use Existing Folder, Open Existing Folder o un botón equivalente para elegir una carpeta ya existente.
Elegir una carpeta concreta del proyecto, por ejemplo ~/Documents/Claude Code (Codex)/Product, no todo Documents.
No escribir archivos aleatorios en la nueva carpeta del equipo antes del llenado inicial desde un GitHub repository, plantilla aprobada o source of truth ya existente.
Obtener acceso a la cuenta corporativa de GitHub y al repository necesario. Para trabajo de equipo, normalmente se necesita precisamente una cuenta corporativa, no un GitHub personal.
Pedir al propietario del repository que añada al usuario como collaborator o conceda acceso mediante la organización.
Conectar la carpeta local al GitHub repository mediante Git remote o clone correcto.
Autorizar GitHub CLI y GitHub plugin en Claude Code (Codex), si se utilizan en el trabajo.
Comprobar que la carpeta local, el workspace de Claude Code (Codex) y el GitHub repository apunten al mismo proyecto.

Idea principal:

Primero creamos la carpeta correcta, después abrimos precisamente esa carpeta en Claude Code, después la vinculamos con GitHub. No creamos copias paralelas del proyecto en lugares diferentes.

Si la carpeta local ya está creada, en Claude Code hay que elegir precisamente la carpeta existente. Si se empieza a crear nuevos proyectos sin vincularlos a una carpeta real, muy rápidamente aparecerá el caos: Claude Code trabajará en un directorio, GitHub estará vinculado a otro y la persona buscará archivos en un tercero.

11. Disciplina de chats y agents dentro del proyecto

En Claude Code y Codex, un chat dentro de un proyecto no es simplemente una conversación aleatoria. En la práctica, cada chat empieza a comportarse como un agente de trabajo con una función determinada.

Por ello, para trabajo serio no se pueden mezclar todos los temas en un solo chat.

Buenos ejemplos de chats separados:

Claude Code setup
GitHub Updates
Product docs
Confluence upload
Lessons
Bug triage

Mala práctica:

Un chat para configurar simultáneamente Claude Code, GitHub sync, decisiones de producto, bugs, transcripciones y notas personales.

En ChatGPT normal, un chat mezclado aún puede ser tolerable. En Claude Code/Codex rápidamente se vuelve perjudicial, porque el agente de IA empieza a vincular entre sí contextos, tareas, carpetas y reglas no relacionadas.

Regla:

Cada chat de trabajo debe tener una función clara. Si aparece un nuevo tema grande, es mejor crear un chat separado dentro del mismo proyecto que romper el contexto del actual.

Ejemplo separado de un chat importante:

GitHub Updates

Este chat puede utilizarse solo para tareas de sincronización de la carpeta local con GitHub: comprobar cambios, hacer commit, preparar pull request, obtener actualizaciones, comprobar el estado del repository. Esto protege al equipo de una situación donde las operaciones de GitHub se dispersan por conversaciones aleatorias.

12. Comprobación de la combinación de carpetas

Antes de un trabajo serio hay que comprobar:

pwd
git status
git remote -v
ls

Entender:

dónde estoy;
si es el proyecto correcto o no;
si existe un Git repo;
qué GitHub remote está conectado;
si se ve AGENTS.md;
si existe .agents/skills;
si no hay cambios sin commit que no se puedan perder.

Si hay dudas, hay que preguntar a Claude Code (Codex):

Claude, comprueba que mi carpeta local del proyecto, workspace de Claude Code y GitHub repository estén vinculados correctamente. Esta es la salida de pwd, git status y git remote -v.

13. No mezclar carpetas de trabajo

No se puede llevar el mismo proyecto simultáneamente en varias carpetas no acordadas:

~/Downloads/project
~/Desktop/project
~/Documents/Claude/project

Esto casi garantiza confusión.

Regla:

Para cada proyecto debe haber una carpeta local principal, un Claude Code (Codex)/Claude Code workspace claro y un GitHub repository.

14. Qué configurar mediante Claude Code

Estos temas no se pueden configurar al azar.

Hay que preguntar a Claude Code (Codex):

Claude, ayúdame a configurar AGENTS.md para este proyecto. Primero lee README, package.json/pyproject, la estructura de carpetas y los comandos existentes. Después propone un AGENTS.md corto.

Claude, ¿qué skills de la empresa necesito instalar para trabajar con Confluence, Jira, service desk y Product docs?

Claude, comprueba la estructura de carpetas del proyecto y la conexión con GitHub. Dime dónde debe estar AGENTS.md y dónde deben estar los project skills.

15. Regla

El vigésimo segundo paso de la configuración:

Después de instalar plugins y MCP hay que configurar AGENTS.md, skills, la estructura de carpetas y la disciplina de chats de trabajo. Esto establece las reglas de comportamiento del agente de IA, conecta workflows reutilizables y protege de la confusión entre la carpeta local, el workspace Claude Code/Codex y el GitHub repository.

Regla estricta adicional:

AGENTS.md, skills, la estructura de carpetas y la vinculación con GitHub no se configuran al azar. Primero pedimos a Claude Code que lea el proyecto, compruebe la vinculación con GitHub y proponga reglas mínimas y exactas para el trabajo concreto.

Paso 1. macOS actual y una cuenta de macOS con privilegios de administrador

1. Usar una macOS moderna

2. Instalar todas las actualizaciones disponibles de macOS

3. Trabajar desde la cuenta principal de administrador

Regla

Paso 2. Instalar Claude Code y crear una carpeta de proyectos de trabajo

1. Dónde guardar los proyectos de Claude Code en macOS

2. Instalar Claude Code CLI

3. Instalar Claude Code desktop app

4. Cómo debe verse la estructura básica en Mac

5. Regla

Paso 03. Terminal y línea de comandos en macOS

1. Qué es el equivalente a PowerShell 7 en macOS

2. Es suficiente el Terminal.app integrado

4. Cuándo conviene instalar iTerm2

6. Qué debe saber hacer cada miembro del equipo

7. Regla

Paso 04. Capturas de pantalla en macOS para trabajar con Claude Code

1. Se necesita una aplicación de capturas de pantalla independiente

2. El requisito principal

3. Teclas rápidas básicas de macOS

4. Best practice para el equipo

5. Regla

Paso 05. Xcode Command Line Tools en macOS

1. Xcode Command Line Tools en macOS

2. Está incluido de forma predeterminada en macOS

3. Cómo comprobar la instalación

4. Cómo instalar Xcode Command Line Tools

5. Normalmente no se necesita Xcode completo

6. Relación con Node.js y pnpm

7. No buscar instrucciones por cuenta propia

8. No reparar developer tools al azar

9. Regla

Paso 06. Instalar y configurar Git

1. Git viene en macOS de forma predeterminada

2. No buscar por cuenta propia el enlace a Git

3. No adivinar las casillas del instalador

4. Ruta recomendada para instalar Git en macOS

5. Configuración básica de Git

6. Git debe funcionar desde la carpeta de proyectos de Claude Code

7. Qué más es importante para Claude Code (Codex)

8. Regla

Paso 07. Instalar Homebrew

1. Homebrew no forma parte de macOS

2. Por qué instalamos Homebrew después de Git

3. No buscar por cuenta propia el comando de instalación

4. Instalación

5. PATH después de instalar Homebrew

6. Comprobación de la instalación

7. Qué se puede instalar mediante Homebrew

8. No usar sudo aleatorio

9. Regla

Paso 08. Instalar GitHub CLI

1. Primero se necesita una cuenta de GitHub

2. No buscar por cuenta propia el comando de instalación

3. Comprobar la instalación

4. Autorizarse en GitHub

5. Comprobar la autorización

6. Comprobar el funcionamiento en la carpeta de proyectos de Claude Code

7. Particularidades de macOS

8. Regla

Paso 09. Instalar Python en macOS

1. Python es obligatorio

2. No buscar por cuenta propia el enlace

3. Qué versión de Python instalar

4. Python integrado en macOS

5. Dónde instalar Python en macOS

6. Método de instalación recomendado

7. Comprobación después de la instalación

8. Entornos virtuales

9. Qué hacer si la versión no coincide

10. Regla

Paso 10. Instalar los paquetes Python must-have

1. Los paquetes no se instalan globalmente, sino en virtual environment

2. Conjunto compatible de paquetes pinned

3. Crear un archivo requirements

4. Qué hacen estos paquetes

5. Particularidades de macOS

6. soundfile y libsndfile

7. webrtcvad puede compilarse desde el código fuente

6. `soundfile` y libsndfile

7. `webrtcvad` puede compilarse desde el código fuente

8. `torch` en macOS