Skip to main content

​
Prerequisites

​
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.
Registration keys are single-use. Each machine needs its own key.

​
Step 2: Install the Agent

Download the Turen agent installer (.dmg) from the Downloads section of your Turen dashboard. Open the DMG and follow the installation prompts. You’ll be asked to enter your registration key during installation. The installer will:
  • Install turen-watchdog, turen-proxy, and turen-pkg
  • 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)
Registration happens automatically during installation. After setup, the agent authenticates on its own — no further configuration 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 appear 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.