# Quickstart

> Open a project in KazoCode, choose a model, and have the AI agent make its first change, then review, keep or undo what it did.

This guide takes you from a fresh install to a change made by the agent and reviewed by you.

## 1. Open a project

Open KazoCode and choose **Open Folder** (`Ctrl+K Ctrl+O`), or **Clone Repository** (`Ctrl+Shift+K`) to clone one from Git. The explorer shows the folder, and the agent works inside it.

## 2. Choose a model

The agent needs a model. Open **Settings › Models** (`Ctrl+,`) and add an API key for a provider such as Anthropic, OpenAI, Google or OpenRouter, or point KazoCode at a model running on your computer. See [Models and providers](https://kazocode.app/docs/agent/models.md).

## 3. Ask for something

Open the chat with `Ctrl+Shift+I`, make sure the mode is **Agent**, and describe the task in plain words:

```text
Add a --version flag to the CLI that prints the version from package.json, with a test.
```

The agent reads the files it needs, plans, edits, and runs commands such as your tests. Each file it changes appears in the chat as a change row.

> [!TIP]
> Mention exactly what you mean with `@`. Typing `@` opens **Add Context**, where you can attach files, folders, a piece of code, a selection or terminal output. See [Adding context](https://kazocode.app/docs/agent/context.md).

## 4. Approve what it needs

When the agent wants to do something your [permission mode](https://kazocode.app/docs/agent/permissions.md) doesn't cover, such as running a command, KazoCode asks first. Approve once, approve for the session, or decline and say what to do instead.

## 5. Review the result

Click a change row to open its diff. For each file you can **Keep** the change or **Undo** it, and **Undo All** reverts the whole reply. If the answer went the wrong way, edit your earlier message: the conversation rewinds to that point and the files go back to how they were. See [Reviewing and undoing changes](https://kazocode.app/docs/agent/changes.md).

## Next steps

- Teach the agent your project's conventions with a [`KAZO.md` file](https://kazocode.app/docs/customize/instructions.md).
- Plan bigger work first with [Plan mode](https://kazocode.app/docs/agent/chat.md#modes).
- Run several tasks at once with [sub-agents and the Agent Workspace](https://kazocode.app/docs/agent/agents.md).
