Skip to main content

Requirements

  • Windows 11 (amd64 or arm64)
  • Claude Code installed
  • Administrator access (for installation)

Install

Download the Turen agent installer (.msi) from the Downloads section of your Turen dashboard. Pick Turen-Agent-v<version>-amd64.msi on Intel/AMD machines or -arm64.msi on arm64 devices. You’ll need a registration key: generate one from Agent Settings > Registration Keys before starting. Double-click the MSI and follow the prompts. You’ll be asked to enter your registration key during installation. The installer will:
  • Install turen-watchdog, turen-proxy, turen-pkg, and turen-batou to %ProgramFiles%\Turen
  • Register the machine with your Turen organization
  • Configure Claude Code automatically (environment variables and hooks for both Bash and PowerShell)
  • Register turen-watchdog as a Windows Service that starts on boot
Once complete, open a new terminal (Windows Terminal, PowerShell, or cmd.exe) and use Claude Code as normal:
claude
No manual configuration is needed.

Managing the Agent

Run from an elevated PowerShell (Run as administrator):
# Check agent status
turen-watchdog status

# Stop the agent
Stop-Service turen-watchdog

# Start the agent
Start-Service turen-watchdog

# View agent logs
Get-Content "$env:ProgramData\Turen\logs\watchdog.log" -Tail 200

Uninstall

Uninstall via Settings > Apps > Installed apps > Turen Agent, or from an elevated PowerShell:
turen-watchdog uninstall --purge
--purge removes binaries, state, the Windows Service registration, and the Start Menu shortcut.

Other Platforms

Running Turen on macOS or Linux? See the macOS or Linux installation guides.