## FAQ

### Which models are supported?

The default is `zen5-coder`. The built-in presets also cover `zen5`, `zen5-pro`,
`zen5-flash`, `zen5-mini`, and the `enso` family. Pick one with `/model` in the
TUI or `--model` on the command line; the default reasoning level is medium.

The gateway is the authority on the catalog — there is no allowlist in the
client — so `curl https://catalog.hanzo.ai/v1/models` lists everything you can
pass to `--model`.

### Why does `o3` or `o4-mini` not work for me?

It's possible that your [API account needs to be verified](https://help.openai.com/en/articles/10910291-api-organization-verification) in order to start streaming responses and seeing chain of thought summaries from the API. If you're still running into issues, please let us know!

### How do I stop Dev from editing my files?

By default, Dev can modify files in your current working directory (Auto mode). To prevent edits, run `dev` in read-only mode with the CLI flag `--sandbox read-only`. Alternatively, you can change the approval level mid-conversation with `/approvals`.

### Does it work on Windows?

Running Dev directly on Windows may work, but is not officially supported. We recommend using [Windows Subsystem for Linux (WSL2)](https://learn.microsoft.com/en-us/windows/wsl/install).

### Why can't Dev find my agents on Windows?

On Windows, agent discovery can be affected by PATH configuration and file extensions. If you see errors like `Agent 'xyz' could not be found`, try these solutions:

**1. Use absolute paths (recommended):**

Edit your `~/.code/config.toml` to use full paths to agent executables:

```toml
[[agents]]
name = "claude"
command = "C:\\Users\\YourUser\\AppData\\Roaming\\npm\\claude.cmd"
enabled = true

[[agents]]
name = "gemini"
command = "C:\\Users\\YourUser\\AppData\\Roaming\\npm\\gemini.cmd"
enabled = true
```

Replace `YourUser` with your actual Windows username.

**2. Find your npm global install location:**

Run this command to find where npm installs global packages:
```cmd
npm config get prefix
```

The executables will be in the returned directory. For example, if it returns `C:\Users\YourUser\AppData\Roaming\npm`, your agent commands will be at:
- `C:\Users\YourUser\AppData\Roaming\npm\claude.cmd`
- `C:\Users\YourUser\AppData\Roaming\npm\gemini.cmd`
- `C:\Users\YourUser\AppData\Roaming\npm\coder.cmd`

**3. Verify PATH includes npm directory:**

In PowerShell:
```powershell
$env:PATH -split ';' | Select-String "npm"
```

In Command Prompt:
```cmd
echo %PATH% | findstr npm
```

If npm's directory isn't in your PATH, you can either:
- Add it to your system PATH (requires restart)
- Use absolute paths in your config (recommended)

**4. Check file extensions:**

On Windows, Dev looks for executables with these extensions: `.exe`, `.cmd`, `.bat`, `.com`. Ensure your agent command includes the correct extension when using absolute paths.

**Related:** See [agents](./config.md#agents) in the configuration reference.