# Manual de uso — 01 Kiro Sonnet Agent

## Inicio rápido (3 pasos)

```powershell
# 1. Gateway (terminal siempre abierta)
cd C:\xampp\htdocs\AiAgentSetups\01-kiro-sonnet-agent
.\start-gateway.ps1

# 2. Verificar (otra terminal)
.\verify.ps1

# 3. Usar agente → elige UNA opción abajo
```

---

## ¿Qué IDE usar?

| Prioridad | Programa | Instalar |
|-----------|----------|----------|
| **1ª opción** | VS Code + **Cline** | Extensión `Cline` |
| **2ª opción** | **Claude Code** (terminal) | `npm i -g @anthropic-ai/claude-code` |
| **3ª opción** | Cursor + **Cline** | Misma extensión dentro de Cursor |
| Opcional | VS Code + **Continue** | Ya configurado |

---

## Cline — paso a paso

1. Abre **VS Code**.
2. `Ctrl+Shift+X` → busca **Cline** → Instalar.
3. Configura Cline 3.x (obligatorio):

```powershell
cd C:\xampp\htdocs\AiAgentSetups\01-kiro-sonnet-agent
.\scripts\configure-cline-v3.ps1
```

4. **Recarga VS Code**: `Ctrl+Shift+P` → `Developer: Reload Window`.
5. Abre tu proyecto: `Archivo → Abrir carpeta`.
6. Clic en icono **Cline** → Settings (⚙️) → confirma:
   - **API Provider:** Anthropic
   - **Anthropic API Key:** valor de `config/state.json` → `proxyApiKey`
   - ☑ **Use custom base URL:** `http://127.0.0.1:8000`
   - **Model:** `claude-sonnet-4-5`
7. Escribe en el chat: *"Analiza la estructura de este proyecto"*.

> Cline 3.x **no** lee la API key del JSON antiguo de VS Code. La guarda en `%USERPROFILE%\.cline\data\secrets.json`.

---

## Claude Code — paso a paso

```powershell
cd C:\xampp\htdocs\AiProyectos   # o tu proyecto
claude
```

Dentro:
```
/status
Explícame qué hace kiro-gateway-main
```

---

## Puerto ocupado (error 10048)

```powershell
# ¿Quién usa el puerto?
.\scripts\show-port-owner.ps1 -Port 8000

# Si es tu propio gateway → NO arranques otro, úsalo directamente

# Si quieres otro puerto:
.\scripts\set-gateway-port.ps1 -Auto
.\start-gateway.ps1
```

---

## Manual completo

Ver: `C:\xampp\htdocs\AiAgentSetups\MANUAL-AVANZADO.md`