> For the complete documentation index, see [llms.txt](https://kiwi-8.gitbook.io/kiwi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kiwi-8.gitbook.io/kiwi-docs/primeros-pasos.md).

# Primeros pasos

## 1. Configura una clave

Kiwi no guarda claves: lee la variable de entorno que le indiques. Por defecto usa Anthropic:

```sh
export ANTHROPIC_API_KEY="..."
```

Ponlo en tu `~/.zshrc` o `~/.bashrc` para no repetirlo. Si prefieres otro proveedor —OpenAI, Azure, Vertex, o un modelo local— ver [Configuración](/kiwi-docs/configuracion.md).

## 2. Entra en tu proyecto

```sh
cd ~/mi-proyecto
kiwi
```

Kiwi trabaja sobre el directorio actual. La conversación se guarda asociada a ese proyecto, así que mañana puedes retomarla con `kiwi --continue`.

## 3. Pide algo pequeño primero

> ¿qué hace este repo? empieza por el README y la estructura de carpetas

Arrancas en modo **ask**, así que cada edición y cada comando te piden confirmación antes de ejecutarse. Nada pasa a tus espaldas mientras te haces a la herramienta.

## 4. Deja que planifique antes de tocar

Para algo más grande, empieza en modo plan:

```
/plan
```

En plan mode Kiwi **no puede escribir**: solo lee, busca y te devuelve un plan numerado citando los ficheros y las líneas concretas. Cuando el plan te convenza, pasa a trabajar:

```
/work
```

## 5. Revisa lo que hizo

```
/diff
```

Muestra todo lo que ha cambiado en la sesión. `/diff turn` enseña solo el último turno. Y si algo no te gusta:

```
/undo
```

Deshace el último turno — ficheros y conversación a la vez. `/redo` lo trae de vuelta.

## 6. Enséñale tu proyecto

```
/init
```

Escribe un fichero de instrucciones del proyecto, donde puedes dejar por escrito las convenciones de tu código, los comandos de test, o lo que quieras que Kiwi recuerde en cada sesión de ese repositorio.

## Atajos que vale la pena aprender pronto

| Comando    | Qué hace                                     |
| ---------- | -------------------------------------------- |
| `/help`    | la lista completa de comandos                |
| `/status`  | todo sobre la sesión actual en un sitio      |
| `/context` | qué está llenando la ventana de contexto     |
| `/compact` | resume la conversación para liberar contexto |
| `/model`   | cambiar de modelo sin salir                  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kiwi-8.gitbook.io/kiwi-docs/primeros-pasos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.