Skip to main content
Get started with Oso by routing agent traffic through the edge proxy at agents.osohq.cloud. This is one of several integration paths. You can also discover agents via EDR, browser extension, or Tailscale Aperture. You will:
  1. Get your Environment ID.
  2. Configure your agent to route through Oso.
  3. See agent activity in your Oso for Agents dashboard.

​
Step 1: Get your Environment ID

  1. Go to ui.osohq.com and log in.
If you are a new user, create an Oso for Agents tenant when prompted.
  1. Hover over your organization name in the bottom-left corner and click Organization settings.
Organization settings in the Oso UI
  1. In the settings panel, click the Environments tab.
The settings panel
  1. Copy the Environment ID for your environment.
The Environments page showing the Environment ID

​
Step 2: Configure your coding agent

Choose your coding agent below and follow the configuration steps.
Add the following to ~/.claude/settings.json:
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://agents.osohq.cloud",
    "ANTHROPIC_CUSTOM_HEADERS": "OSO_ENVIRONMENT: <your-environment-id>"
  }
}
Replace <your-environment-id> with the Environment ID from Step 1.

​
Step 3: Send prompts and see them in the dashboard

Use your coding agent as normal. Prompts will be routed through Oso and appear in your Oso for Agents dashboard.

​
Next steps

  • Shadow AI: Discover what AI agents are in use across your organization.
  • Session Monitoring: See what agents are doing inside their sessions.
  • Alerts: Set up monitoring for unsanctioned usage and sensitive content.
  • Integrations: Explore other integration methods (EDR, browser extension, Tailscale Aperture).