Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.
Version: 11.3.0

Onboarding Your Agent

Onboarding connects an agent to HYPR AgentPass™ for the first time. You point the agent at the gateway and approve its connection. From then on, its traffic flows through the gateway under a verifiable identity. This page uses Claude Code as the example.

An agent is a language model paired with a harness: the loop that prompts the model, carries out the actions it chooses, and feeds the results back. When it runs on your machine, it acts under your identity, which makes you its supervisor. You onboard it, approve its connection, and keep visibility into what it does.

Before You Start​

  • Claude Code is installed and signed in. You have run claude at least once.
  • You have the gateway URL from your administrator. It looks like https://<your-gateway-url>.
  • You can sign in to the administration console, or you have the HYPR app with a passkey enrolled. You approve the connection in either one.

Point Your Agent at the Gateway​

Claude Code sends its requests to the address in the ANTHROPIC_BASE_URL environment variable.

  1. Set the variable to the gateway URL.

    On Mac or Linux:

    export ANTHROPIC_BASE_URL="https://<your-gateway-url>"

    On Windows, in PowerShell:

    setx ANTHROPIC_BASE_URL "https://<your-gateway-url>"
  2. Optional: On Mac or Linux, add the export line to your shell profile to make the setting permanent.

  3. Restart Claude Code, so it picks up the new endpoint.

Keep your existing Anthropic API key in place. The gateway forwards approved traffic on your behalf.

Approve the First Connection​

The first request from a new agent is held until its supervisor approves it. What happens next depends on the connector's onboarding mode, which your administrator sets. See Onboarding Mode.

With Require Approval:

  1. Sign in to the administration console.
  2. Open Oversight → Approvals.
  3. Find the request under Needs your attention, and check the agent details.
  4. Click Approve. A dialog opens with the request.
  5. Click Approve in the dialog.
A pending onboarding request in the console with the agent's details and the Approve control

The gateway releases the agent's traffic, and the agent continues, with no restart needed. You approve only the agents you supervise.

If you have enrolled a passkey, the same request also reaches your phone as a notification, and you can approve it there. See Setting Up Your Approval Passkey and Approving and Denying Agent Actions.

Confirm Your Traffic in the Request Log​

Open Oversight → Request Log in the console, and filter to your agent. Recent requests with a success status mean the agent is onboarded and routing through the gateway. See Viewing the Request Log.

Re-Approve When Access Expires​

An onboarding approval is valid for a limited time. When it lapses, the agent's next request is held again, and a re-onboarding request appears. Approve it the same way.

If an agent that was working normally stops receiving responses, look for a pending re-onboarding request.