Claude Code - VibeCodeCheap

Claude Code es un agente de programación basado en terminal que entiende tu código base y te ayuda a programar más rápido a través de comandos en lenguaje natural - ejecutando tareas rutinarias, explicando código complejo y manejando flujos de trabajo de git. Claude Code se vuelve aún más potente con el Plan de Coding — el plan Pro ofrece más que Claude Pro (20 USD/mes), el plan Max ofrece más que Claude Max (200 USD/mes). Programa más rápido, depura de manera más inteligente y gestiona flujos de trabajo sin problemas con más tokens y mayor confiabilidad.

Paso 1: Instalar Claude Code

Instalación Recomendada
Instalación Guiada con Cursor

Requisitos: Node.js 18 o más reciente

# Instalar Claude Code
npm install -g @anthropic-ai/claude-code

Si no estás familiarizado con npm pero tienes Cursor, puedes ingresar el comando en Cursor para una instalación guiada:

https://docs.anthropic.com/en/docs/claude-code/overview
Ayúdame a instalar Claude Code

Si encuentras errores de permisos durante la instalación, intenta usar sudo (MacOS/Linux) o ejecuta el símbolo del sistema como administrador (Windows).

Paso 2: Configurar el Plan de Coding

Obtener Clave API

Visita VibeCodeCheap Open Platform, Regístrate o Inicia Sesión.
Crea una Clave API en la página de Claves API.
Copia la Clave API para usar.

Configurar Variables de Entorno

Hay 2 formas de configurar: mediante archivo settings.json (recomendado) o mediante exportación de variables de entorno.

Método 1: Archivo settings.json (Recomendado)
Método 2: Exportar Variables de Entorno
Método 3: Usar flag --settings

Paso 1: Localizar la ruta correcta del archivo settings.json

El archivo de configuración se encuentra en diferentes rutas según tu sistema operativo:

Windows
macOS
Linux

Ruta: %USERPROFILE%\.claude\settings.jsonEjemplo: C:\Users\TuNombre\.claude\settings.json

Ruta: ~/.claude/settings.jsonEjemplo: /Users/TuNombre/.claude/settings.json

Ruta: ~/.claude/settings.jsonEjemplo: /home/TuNombre/.claude/settings.json

Paso 2: Abrir settings.json para editar

Elige uno de los siguientes métodos para abrir el archivo:

Usando comando claude
VS Code
Cursor
Notepad++ / Sublime / Vim
Apertura manual

# En Windows (Git Bash o WSL)
claude --settings "$USERPROFILE\.claude\settings.json"

# En macOS/Linux
claude --settings ~/.claude/settings.json

Este comando abre el archivo en el editor predeterminado de tu sistema. Si no funciona, prueba otro método a continuación.

# En Windows
code "%USERPROFILE%\.claude\settings.json"

# En macOS/Linux
code ~/.claude/settings.json

# En Windows
cursor "%USERPROFILE%\.claude\settings.json"

# En macOS/Linux
cursor ~/.claude/settings.json

# Notepad++ (Windows)
notepad++ "%USERPROFILE%\.claude\settings.json"

# Sublime Text
subl ~/.claude/settings.json

# Vim
vim ~/.claude/settings.json

# Nano
nano ~/.claude/settings.json

Windows:

Abrir Explorador de archivos
Escribir %USERPROFILE%\.claude en la barra de direcciones
Buscar settings.json y abrir con Notepad o cualquier editor

macOS/Linux:

Abrir Finder/Administrador de archivos
Presionar Cmd+Shift+G (macOS) o Ctrl+H para mostrar archivos ocultos
Navegar a ~/.claude/
Abrir settings.json

Paso 3: Agregar configuración al archivo

Agrega los campos env al archivo settings.json:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "tu_clave_api",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

Reemplaza tu_clave_api con tu Clave API de VibeCodeCheap y guarda el archivo.

Solución de problemas comunes

El comando para abrir archivo no funciona o abre archivo incorrecto

Causa: Comandos como code, cursor pueden no estar en PATH, o el archivo se abre en ubicación incorrecta.Solución:

Verificar ubicación del archivo:

# Windows (PowerShell)
ls $env:USERPROFILE\.claude\settings.json

# macOS/Linux
ls -la ~/.claude/settings.json

Si el archivo no existe, crear directorio y archivo:

# Windows (PowerShell)
mkdir -Force $env:USERPROFILE\.claude
echo '{"env":{}}' > $env:USERPROFILE\.claude\settings.json

# macOS/Linux
mkdir -p ~/.claude
echo '{"env":{}}' > ~/.claude/settings.json

Abrir archivo usando ruta absoluta:

# Windows
code "C:\Users\TuNombre\.claude\settings.json"

# macOS
code "/Users/TuNombre/.claude/settings.json"

La configuración no surte efecto después de guardar

Verificar formato JSON: Usar JSONLint para validar
Cerrar todas las terminales que ejecutan Claude Code
Abrir nueva terminal y ejecutar claude nuevamente
Ejecutar /status en Claude Code para verificar configuración

No se encuentra el directorio .claude

Causa: El directorio .claude no se ha creado porque Claude Code no se ha ejecutado aún.Solución:

Ejecutar claude una vez (puede salir inmediatamente)

O crear manualmente:

# Windows
mkdir %USERPROFILE%\.claude

# macOS/Linux
mkdir -p ~/.claude

Archivo settings.json se sobrescribe o pierde configuración

Causa: Claude Code puede sobrescribir automáticamente settings.json en algunos casos.Solución:

Hacer copia de seguridad del archivo de configuración:

cp ~/.claude/settings.json ~/.claude/settings.json.backup

Bloquear archivo para evitar sobrescritura (solo cuando sea necesario):

# macOS/Linux
chmod 444 ~/.claude/settings.json

# Windows (PowerShell - ejecutar como admin)
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $true

Desbloquear cuando necesite editar:

# macOS/Linux
chmod 644 ~/.claude/settings.json

# Windows (PowerShell)
Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $false

WSL: Error 'node: not found' o versión incorrecta de Node

Causa: WSL está usando Node.js de Windows en lugar de la versión de Linux.Verificar:

which node
which npm
# Si el resultado es /mnt/c/... entonces está usando Node de Windows

Solución:

Instalar Node.js para Linux:

# Usando nvm (recomendado)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

# O usando administrador de paquetes
sudo apt update
sudo apt install nodejs npm

Corregir prioridad de PATH - Agregar a ~/.bashrc o ~/.zshrc:

# Asegurar que nvm esté cargado
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# Priorizar rutas de Linux
export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:$PATH"

Aplicar cambios:
```
source ~/.bashrc
```

macOS: Errores de permisos al editar archivos o ejecutar comandos

Causa: macOS tiene seguridad gatekeeper y SIP (System Integrity Protection).Solución:

Permitir que terminal acceda a archivos:
- Abrir Configuración del Sistema > Privacidad y Seguridad > Acceso Completo al Disco
- Agregar Terminal.app o iTerm2

Corregir permisos de directorio:

sudo chown -R $(whoami) ~/.claude
chmod -R u+w ~/.claude

Este método es útil cuando settings.json no funciona o quieres probar rápidamente.

Temporal (Solo en sesión de terminal actual)

# macOS/Linux
export ANTHROPIC_AUTH_TOKEN="tu_clave_api"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"
claude

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="tu_clave_api"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"
claude

Estas variables de entorno solo existen en la terminal actual. Al cerrar la terminal, debes exportarlas nuevamente.

Permanente (Auto-cargar cada vez que abres terminal)

macOS/Linux (Bash)
macOS (Zsh - predeterminado)
Windows (PowerShell)

Agregar a ~/.bashrc o ~/.bash_profile:

# Abrir archivo
nano ~/.bashrc
# o
nano ~/.bash_profile

# Agregar al final del archivo
export ANTHROPIC_AUTH_TOKEN="tu_clave_api"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# Guardar archivo (Ctrl+O, Enter, Ctrl+X)

# Aplicar cambios
source ~/.bashrc
# o
source ~/.bash_profile

Agregar a ~/.zshrc:

# Abrir archivo
nano ~/.zshrc

# Agregar al final del archivo
export ANTHROPIC_AUTH_TOKEN="tu_clave_api"
export ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
export API_TIMEOUT_MS="3000000"

# Guardar archivo (Ctrl+O, Enter, Ctrl+X)

# Aplicar cambios
source ~/.zshrc

Agregar a PowerShell Profile:

# Verificar archivo de perfil
notepad $PROFILE

# Si no existe, crear nuevo
New-Item -Path $PROFILE -Type File -Force

# Agregar al archivo
$env:ANTHROPIC_AUTH_TOKEN="tu_clave_api"
$env:ANTHROPIC_BASE_URL="https://api.vibecodecheap.com/v1/ai"
$env:API_TIMEOUT_MS="3000000"

# Guardar y recargar
. $PROFILE

Verificar variables de entorno establecidas

# macOS/Linux
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Windows (PowerShell)
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL

Si settings.json está en una ubicación diferente o quieres especificar un archivo personalizado.

# Crear settings.json en cualquier ubicación
nano ~/mi-claude-config.json

# Agregar contenido
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "tu_clave_api",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}

# Ejecutar claude con flag --settings
claude --settings ~/mi-claude-config.json

# O crear alias para uso permanente
# Agregar a ~/.bashrc o ~/.zshrc
alias claude-vcc='claude --settings ~/mi-claude-config.json'

# Luego solo escribe
claude-vcc

Paso 3: Comenzar con Claude Code

Después de la configuración, puedes comenzar a usar Claude Code en la terminal:

cd tu-directorio-de-proyecto
claude

Si estás usando Windows, necesitas ejecutar claude usando Git Bash o Ubuntu (WSL) la primera vez.

Al ejecutar Claude Code por primera vez, podrías ver un mensaje de seguridad pidiendo permiso de acceso a archivos:

Do you trust the files in this folder?

 Claude Code may read, write, or execute files contained in this directory. 
 This can pose security risks, so only use files from trusted sources.

 ❯ 1. Yes, proceed
   2. No, exit

Selecciona “Yes, proceed” y presiona Enter para otorgar a Claude Code acceso a los archivos en tu directorio de proyecto.

Preguntas Frecuentes

Cómo Cambiar el Modelo en Uso

Mapeo entre las variables de entorno de modelo interno de Claude Code y los modelos:

Modelo	Multiplicador	Contexto
`claude-sonnet-4-5`	1x	200K tokens
`claude-sonnet-4-5-20250929`	1x	200K tokens
`claude-opus-4-5-20251101`	2x	200K tokens
`gpt-5-mini`	0x (uso gratuito)	128K tokens
`glm-4.6`	0x (uso gratuito)	200K tokens
`glm-4.7`	0x (uso gratuito)	200K tokens

gpt-5-mini, glm-4.6 y glm-4.7 son modelos de uso gratuito con uso ilimitado al suscribirte al Plan de Coding en VibeCodeCheap.

Si necesitas ajustar, puedes editar directamente el archivo de configuración ~/.claude/settings.json:

Modelos Claude
GPT-5 Mini
GLM 4.6
GLM 4.7

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5-mini",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5-mini"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6"
  }
}

{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

Cómo Verificar el Estado Actual del Modelo

Abre una nueva terminal y ejecuta claude, ingresa /help para ver todos los comandos disponibles.

Ingresa /status para verificar el estado actual del modelo.
Ingresa /models para listar todos los modelos disponibles.

La Configuración Manual No Funciona

Si has editado el archivo ~/.claude/settings.json pero los cambios no surten efecto:

Cierra todas las ventanas de Claude Code, abre una nueva terminal y ejecuta claude de nuevo.
Si aún no funciona, intenta eliminar el archivo ~/.claude/settings.json y reconfigura.
Confirma que el formato JSON es correcto, verifica los nombres de las variables y asegúrate de que no falten ni sobren comas.

Versión Recomendada de Claude Code

Recomendamos usar la última versión de Claude Code:

# Verificar versión actual
claude --version

# Actualizar a la última versión
claude update

​Paso 1: Instalar Claude Code

​Paso 2: Configurar el Plan de Coding

​Paso 1: Localizar la ruta correcta del archivo settings.json

​Paso 2: Abrir settings.json para editar

​Paso 3: Agregar configuración al archivo

​Solución de problemas comunes

​Temporal (Solo en sesión de terminal actual)

​Permanente (Auto-cargar cada vez que abres terminal)

​Verificar variables de entorno establecidas

​Paso 3: Comenzar con Claude Code

​Preguntas Frecuentes

​Cómo Cambiar el Modelo en Uso

​Cómo Verificar el Estado Actual del Modelo

​La Configuración Manual No Funciona

​Versión Recomendada de Claude Code

Paso 1: Instalar Claude Code

Paso 2: Configurar el Plan de Coding

Paso 1: Localizar la ruta correcta del archivo settings.json

Paso 2: Abrir settings.json para editar

Paso 3: Agregar configuración al archivo

Solución de problemas comunes

Temporal (Solo en sesión de terminal actual)

Permanente (Auto-cargar cada vez que abres terminal)

Verificar variables de entorno establecidas

Paso 3: Comenzar con Claude Code

Preguntas Frecuentes

Cómo Cambiar el Modelo en Uso

Cómo Verificar el Estado Actual del Modelo

La Configuración Manual No Funciona

Versión Recomendada de Claude Code