Installation

Installation

  1. Run the installation command
npm install -g  @dahawa/hawa-code
  1. Configure API Key
  • Configuration file path: ~/.hcode/config.json
{
  "sources": {
    "openai": {
      "base_url": "https://api.openai.com/v1",
      "auth_token": "{apikey}",
      "api_type": "openai",
      "models": ["gpt-5.5", "gpt-5.4-mini"]
    },
    "kimi": {
      "base_url": "https://api.kimi.com/coding",
      "auth_token": "{apikey}",
      "api_type": "anthropic",
      "models": ["K2.5", "K2.6"]
    },
    "qwen-coding": {
      "base_url": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
      "auth_token": "{apikey}",
      "api_type": "anthropic",
      "models": ["qwen3-coder-plus"]
    }
  },

  "routing": {
    "MODEL": [
      { "source": "kimi", "model": "K2.6", "weight": 60 },
      { "source": "openai", "model": "gpt-5.5", "weight": 40 }
    ],
    "SMALL_FAST_MODEL": [
      { "source": "qwen-coding", "model": "qwen3-coder-plus", "weight": 50 },
      { "source": "kimi", "model": "K2.5", "weight": 50 }
    ]
  }
}
  1. Run the startup command
hcode
  1. Windows
    Hawa Code is fully compatible with Windows. It uses PowerShell by default on Windows. User commands, Skills, and slash commands should all use PowerShell scripts.
    If you want to use Shell on Windows, configure the following environment variable pointing to git bash, and ensure git is installed.
HAWA_CODE_GIT_BASH_PATH={git installation directory}\bin\bash.exe

Environment variable configuration methods:

  • Configure directly in the env field of ~/.hcode/settings.json (recommended)
Next