Esta página está diseñada para ser leída directamente por Claude Code. Contiene las plantillas e instrucciones necesarias para configurar el entorno de un nuevo desarrollador.
Configura mi entorno de desarrollo para Pampling. Lee la wiki: http://192.168.1.10:3001/en/onboarding/setup-automatico
Instalar en tu máquina Windows:
# Node.js 18+ (necesario para Claude Code)
winget install OpenJS.NodeJS.LTS
# Claude Code
npm install -g @anthropic-ai/claude-code
# Git
winget install Git.Git
# Python 3.12+
winget install Python.Python.3.12
# Configurar git
git config --global user.name "Tu Nombre"
git config --global user.email "tu.email@pampling.com"
Necesitas 3 credenciales. Guárdalas en un lugar seguro (gestor de contraseñas).
admin:repository:bitbucket — Crear repos y gestionar deploy keysread:repository:bitbucket — Leer reposwrite:repository:bitbucket — Modificar reposwrite:ssh-key:bitbucket — Añadir deploy keysAnota tu email de Atlassian y el token generado.
El usuario de Coolify lo crea el admin. Pide que te creen una cuenta en http://192.168.1.10:8000
Claude Code - [tu nombre]Necesario para crear bases de datos y consultar logs. Pide al admin que te cree un usuario.
El admin ejecutará en el servidor:
sudo adduser tu-nombre && sudo usermod -aG devs tu-nombre
Desde tu máquina:
# Generar clave SSH si no tienes
ssh-keygen -t ed25519 -C "tu.email@pampling.com"
# Copiar clave pública al servidor
type %USERPROFILE%\.ssh\id_ed25519.pub | ssh tu-nombre@192.168.1.10 "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
# Verificar conexión
ssh tu-nombre@192.168.1.10 "echo OK"
Abre una terminal, ejecuta claude y pega:
Configura mi entorno de desarrollo para Pampling. Lee la wiki: http://192.168.1.10:3001/en/onboarding/setup-automatico
Claude Code te pedirá tus credenciales y generará todo automáticamente.
SECCIÓN TÉCNICA — Esta sección la lee Claude Code. El desarrollador no necesita hacer nada aquí.
Cuando un usuario te pida configurar su entorno leyendo esta wiki, sigue estos pasos:
1. Solicitar datos al usuario (uno a uno):
| Dato | Ejemplo |
|---|---|
| Nombre completo | María García |
| Rol en Pampling | analista de datos |
| Email de Bitbucket/Atlassian | maria.garcia@pampling.com |
| Token de Bitbucket API | ATATT3xFfGF0... |
| Token de Coolify API | 3|abc123... |
| Usuario SSH | maria@192.168.1.10 |
2. Crear directorios:
mkdir -p ~/.claude
mkdir -p ~/repositorio
3. Generar CLAUDE.md usando la plantilla del Fichero 1 de abajo, rellenando los placeholders con los datos del usuario.
4. Generar create_app.md leyendo la página http://192.168.1.10:3001/en/onboarding/fichero-create-app y guardando su contenido (desde # Crear una nueva aplicación hasta el final del fichero) como ~/.claude/create_app.md.
5. Generar settings.json usando la plantilla del Fichero 3 de abajo.
6. Verificar conectividad:
# Test Bitbucket
curl -s -u "{EMAIL}:{BITBUCKET_TOKEN}" https://api.bitbucket.org/2.0/repositories/pampling?pagelen=1 | python -c "import sys,json; d=json.load(sys.stdin); print('Bitbucket OK -', d.get('size','?'), 'repos')"
# Test Coolify
curl -s -H "Authorization: Bearer {COOLIFY_TOKEN}" http://192.168.1.10:8000/api/v1/applications | python -c "import sys,json; apps=json.load(sys.stdin); print('Coolify OK -', len(apps), 'apps')"
# Test SSH
ssh {SSH_USER}@192.168.1.10 "echo SSH OK"
7. Mostrar resumen con todo lo configurado y las rutas de los ficheros generados.
Ruta destino:
C:\Users\USUARIO\.claude\CLAUDE.md
Fichero privado, nunca se sube a ningún repositorio.
# Instrucciones generales
## Usuario
{NOMBRE}, {ROL} en Pampling (marca de moda). Trabaja en Windows 11 con Claude Code.
## Idioma
Responder siempre en español.
## Infraestructura
Servidor local Ubuntu 24.04 con Coolify para despliegue de aplicaciones Docker.
Wiki de infraestructura: http://192.168.1.10:3001/
Para crear un nuevo proyecto/aplicación o gestionar la infraestructura, consultar:
- `.claude/create_app.md` — Workflow para crear aplicaciones nuevas
### Mis credenciales ({NOMBRE})
- **SSH**: `{SSH_USER}@192.168.1.10` (ed25519)
- **Coolify API**: token `{COOLIFY_TOKEN}`
- **Coolify UUIDs**: server `p9oujt6wvwz90l3zgzd1vexy`, project `e11g6dohjsbfsucm9f2r3h9k`, deploy key `lay870h6dq9p25wvj4la8otn`
- **Bitbucket email**: `{BITBUCKET_EMAIL}`
- **Bitbucket API token**: `{BITBUCKET_TOKEN}`
Nota: Las líneas de PostgreSQL y App UUID se añaden automáticamente cuando Claude Code crea una aplicación nueva siguiendo
create_app.md.
Ruta destino:
C:\Users\USUARIO\.claude\create_app.md
Workflow que sigue Claude Code para crear aplicaciones nuevas.
Este fichero tiene su propia página: Ver contenido completo del fichero create_app.md
Claude Code debe leer esa página y guardar su contenido como ~/.claude/create_app.md.
Ruta destino:
C:\Users\USUARIO\.claude\settings.json
Permisos para que Claude Code ejecute comandos sin pedir confirmación.
{
"permissions": {
"allow": [
"Bash(git *)",
"Bash(ssh *)",
"Bash(curl *)",
"Bash(python *)",
"Bash(pip *)",
"Bash(npm *)",
"Bash(node *)",
"Bash(uvicorn *)"
]
}
}
Tras el setup, la estructura del desarrollador debe ser:
C:\Users\USUARIO\
├── .claude\
│ ├── CLAUDE.md ← Credenciales personales (PRIVADO)
│ ├── create_app.md ← Workflow para crear apps
│ └── settings.json ← Permisos de Claude Code
├── .ssh\
│ ├── id_ed25519 ← Clave SSH privada
│ └── id_ed25519.pub ← Clave SSH pública
└── repositorio\ ← Directorio de proyectos