Configuration Reference

File Locations

File	Description
`~/.zen/zen.json`	Main configuration file
`~/.zen/zend.log`	Daemon log
`~/.zen/zend.pid`	Daemon PID file
`~/.zen/logs.db`	Request log database (SQLite)

Full Configuration Example

{
  "version": 7,
  "default_profile": "default",
  "default_client": "claude",
  "proxy_port": 19841,
  "web_port": 19840,
  "providers": {
    "anthropic": {
      "base_url": "https://api.anthropic.com",
      "auth_token": "sk-ant-xxx",
      "model": "claude-sonnet-4-5",
      "claude_env_vars": {
        "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000"
      }
    }
  },
  "profiles": {
    "default": {
      "providers": ["anthropic"]
    }
  },
  "project_bindings": {
    "/path/to/project": {
      "profile": "work",
      "client": "codex"
    }
  }
}

Field Reference

Field	Description
`version`	Config file version number
`default_profile`	Default profile name
`default_client`	Default CLI client (claude/codex/opencode)
`proxy_port`	Proxy server port (default: 19841)
`web_port`	Web management interface port (default: 19840)
`providers`	Provider configuration collection
`profiles`	Profile configuration collection
`project_bindings`	Project binding configuration
`sync`	Config sync settings (optional)