mirror of
https://github.com/hanzo-docs/docs.git
synced 2026-10-30 14:41:16 +00:00
59 lines
1.8 KiB
Plaintext
59 lines
1.8 KiB
Plaintext
---
|
|
title: FAQ
|
|
description: Frequently asked questions about Hanzo Dev.
|
|
---
|
|
|
|
## Which models are supported?
|
|
|
|
We recommend the built-in presets that wrap GPT-5.2 (e.g., `code-gpt-5.2-codex`). The default reasoning level is medium — upgrade to high for complex tasks with `/model`.
|
|
|
|
You can also use other models via API-based auth with the `--model` flag.
|
|
|
|
## How do I stop Hanzo Dev from editing my files?
|
|
|
|
By default, Hanzo Dev can modify files in your current working directory (Auto mode). To prevent edits, run in read-only mode:
|
|
|
|
```bash
|
|
dev --sandbox read-only
|
|
```
|
|
|
|
Or change the approval level mid-conversation with `/approvals`.
|
|
|
|
## Does it work on Windows?
|
|
|
|
Running directly on Windows may work but is not officially supported. We recommend [Windows Subsystem for Linux (WSL2)](https://learn.microsoft.com/en-us/windows/wsl/install).
|
|
|
|
## Why can't Hanzo Dev find my agents on Windows?
|
|
|
|
Agent discovery on Windows can be affected by PATH and file extensions. Solutions:
|
|
|
|
### Use absolute paths (recommended)
|
|
|
|
```toml
|
|
[[agents]]
|
|
name = "claude"
|
|
command = "C:\\Users\\YourUser\\AppData\\Roaming\\npm\\claude.cmd"
|
|
enabled = true
|
|
```
|
|
|
|
### Find your npm global install location
|
|
|
|
```cmd
|
|
npm config get prefix
|
|
```
|
|
|
|
### Verify PATH includes npm directory
|
|
|
|
```powershell
|
|
$env:PATH -split ';' | Select-String "npm"
|
|
```
|
|
|
|
### Check file extensions
|
|
|
|
On Windows, Hanzo Dev looks for executables with extensions: `.exe`, `.cmd`, `.bat`, `.com`. Include the correct extension when using absolute paths.
|
|
|
|
## What is the relationship to OpenAI Codex?
|
|
|
|
Hanzo Dev is an enhanced fork of the OpenAI Codex CLI. The original 2021 Codex model was deprecated in March 2023. Hanzo Dev continues to evolve separately with enterprise features, multi-agent orchestration, and Hanzo AI infrastructure integration.
|
|
|