FAQ

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:

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).

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)

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

Find your npm global install location

npm config get prefix

Verify PATH includes npm directory

$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.