Skip to main content

​
Prerequisites

  • A machine running macOS 13 (Ventura) or later, or a systemd-based Linux distribution (Ubuntu/Debian, RHEL/CentOS/Fedora) on x86_64 or arm64
  • Claude Code installed
  • A Turen account: sign up at dashboard.turen.io

​
Step 1: Generate a Registration Key

In the Turen dashboard, go to Settings > Registration Keys and create a new key. You’ll get a key that looks like: 
rk_live_abc123...
Copy this key. You’ll need it for the next step.

​
Step 2: Install the Agent

On macOS, download the .dmg installer from the Fleet section of your Turen dashboard, open it, and follow the installation prompts. You’ll be asked to enter your registration key during installation.
Image
On Linux, see the Linux installation guide for .deb, .rpm, and one-line installer options. The installer will:
  • Install turen-watchdog, turen-proxy, turen-pkg, and turen-batou
  • Register the machine with your Turen organization using your registration key
  • Configure Claude Code automatically via managed-settings.json
  • Start the agent as a background service (LaunchDaemon on macOS, systemd on Linux)
Registration happens automatically during installation. After setup, the agent authenticates itself; no further configuration is needed.

​
Step 3: Use Claude Code

Open a new terminal and run Claude Code as normal: 
claude
That’s it. The installer has already configured Claude Code to route through the Turen proxy, set up environment variables, and registered hooks. All security rules are active, and sessions are being recorded.

​
Step 4: Verify in the Dashboard

Head to dashboard.turen.io. Within a minute, you should see:
  • Your agent appears under Agents
  • LLM requests flowing in the LLM Dashboard
  • Sessions available for replay under Monitor > Replay

​
Next Steps

Dashboard Overview

Learn what the dashboard shows you.

Security Rules

Explore the 96 built-in security rules.

Configure Policies

Customize policies for your organization.

Team Setup

Invite your team and manage access.