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 turen.io/download or the Downloads section of your Turen dashboard. Both offer a build for each architecture: pick Turen-Agent-v<version>-amd64.msi on Intel/AMD (x86_64) devices or -arm64.msi on ARM64 devices. The dashboard also detects your CPU architecture (including Windows on ARM) and highlights the matching installer. No registration key is required for the interactive install. Double-click the MSI and follow the prompts. The installer will:
  • Install turen-watchdog, turen-pkg, turen-batou, and turen-updater to %ProgramFiles%\Turen
  • Install the Turen desktop app (Turen.exe) with a Start Menu shortcut
  • Configure Claude Code automatically (environment variables and hooks for both Bash and PowerShell)
  • Register turen-watchdog as a Windows Service that starts on boot
The desktop app and the agent auto-update together, so you do not update the desktop app separately.

​
Register This Machine

Open the Turen desktop app from the Start Menu and sign in or create an account. Signing in registers this machine with your organization over local IPC. No key or configuration is needed.
If your account has multi-factor authentication (an authenticator app / TOTP) enrolled, the desktop app prompts for the 6-digit code when you sign in. Both email/password and Google sign-in support MFA. You enroll and manage MFA factors in the dashboard under User Settings.

​
Silent and Fleet Installs

For unattended, scripted, or fleet rollouts where no one signs in interactively, register with a registration key. Generate one from Devices > Settings in the dashboard and pass it to msiexec:
The agent registers automatically on first check-in, no desktop sign-in needed.

​
Using Claude Code

Once complete, open a new terminal (Windows Terminal, PowerShell, or cmd.exe) and use Claude Code as normal:
No manual configuration is needed.

​
Managing the Agent

Run from an elevated PowerShell (Run as administrator):

​
Uninstall

Uninstall via Settings > Apps > Installed apps > Turen Agent, or from an elevated PowerShell:
--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.