Skip to main content
Version: 11.5.0

Claude and Codex Channels

Preview

Channels are a preview feature.

A channel connects a developer's local Claude Code or Codex session to HYPR AgentPass™. It carries supervisor messages to the session, and returns the agent's replies, conversation list and history. The Endpoint Guard manages the channel on enrolled Macs.

Supervisor app or console
↕
HYPR AgentPass gateway
↕ secure channel
Endpoint Guard
↕
Claude Code or Codex session

A channel complements inference routing. Routing sends model requests through the gateway for policy and audit. The channel carries the live supervisor conversation. Enable both through Managed Desktop Tools.

Claude and Codex channels use the Anthropic and OpenAI connectors, which carry a channel session route for this purpose. A Slack workspace is connected differently, through a Slack Agent connector.

Supported Tools​

Channels support two tools.

ToolWhat the channel providesConversation behavior
Claude CodeLive messages, replies, conversation list and historyA supervisor can continue an existing conversation or start a new one
CodexLive messages, replies, thread list and historyA supervisor can continue a thread that already exists on the workstation

Both channels use the developer's existing provider sign-in to establish a short-lived gateway session. The developer never enters a gateway API key, or puts one on the command line.

Platform support

Endpoint Guard manages Claude and Codex channels on macOS only. See Supported Platforms and Components.

Before You Begin​

You need:

  • An enrolled Mac running Endpoint Guard for macOS
  • Configure agents from AgentPass turned on, with Claude Code, Codex, or both configured
  • The selected tool installed and signed in by the developer
  • Outbound HTTPS and secure WebSocket access from the Mac to your gateway
  • An enabled Anthropic connector for routed Claude Code traffic, and an enabled OpenAI connector for routed Codex traffic
  • Allow Channel connections turned on in the provider connector's Overview tab. It is on by default. While it is off, the gateway refuses new channel sessions. Sessions already open keep working until they expire

Channel Downloads​

Endpoint Guard installs and updates the channels on the Macs it manages. To install a channel yourself, download it from the provider connector.

  1. Open Connectors, and choose the Anthropic or OpenAI connector.
  2. On the Overview tab, under Allow Channel connections, find Channel downloads. The section appears while Allow Channel connections is on. It shows the version and how many installers there are.
  3. Click Show. Each channel has a row, with a button for each platform.
  4. Click the button for your platform.

The links work for 10 minutes. To get new ones, click Hide, then Show. If no installers are available, the section says so, with no Show button. Contact HYPR Support.

Channel downloads open on the connector's Overview tab, under Allow Channel connections, with a row of platform buttons for the Claude Code channel and for the Codex channel

Enable the Channels​

  1. Open Desktops → Desktop configuration, and choose Configuration.
  2. Turn on Configure agents from AgentPass, if it is off, and click Turn on to confirm.
  3. Turn on Configure Claude Code, Configure Codex or both.
  4. Keep Route model traffic through AgentPass ticked, and choose the provider connector beside it.
  5. Click Save.

Endpoint Guard receives the configuration on its next check-in. It configures the selected tool and starts its channel, and reconnects the channel when the user signs in again. Turning the tool off in Configuration stops the managed channel, and returns the tool to its previous configuration.

The developer uses Claude Code or Codex as usual. Before the first managed connection, they complete the provider's sign-in:

Claude Code
claude
Codex
codex login

If a tool is not signed in, Endpoint Guard waits, and tries again after a later check-in. This keeps the tool's normal provider sign-in flow intact.

Use a Channel​

A supervisor opens Conversations, selects the agent, and chooses a conversation. Messages sent there arrive in the local session with the supervisor's identity attached. Agent replies return to the same conversation.

Claude Code can start a new conversation from the supervisor surface. For Codex, start the thread on the workstation first, then select it from the conversation list.

The channel does not move the tool's local permission prompts to the supervisor. Those prompts stay on the workstation. AgentPass policies and approvals still govern the inference and MCP calls that pass through the gateway.

Confirm the Connection​

  1. Open the managed agent in AgentPass, and check that its channel shows as connected. A channel you run yourself prints Connected. Open the HYPR AgentPass mobile app to get connected to a session.
  2. Send a short message from Conversations.

Confirm that:

  • The message appears in the selected local session.
  • The agent's reply returns to AgentPass.
  • The conversation history remains available after the page is refreshed.

If the channel is offline, check that:

  • Endpoint Guard is running.
  • The tool is installed and signed in.
  • The Mac can reach the gateway over HTTPS and secure WebSockets.
  • For Codex, a local thread exists for the supervisor to continue.
  • The agent's first connection is not waiting for approval.

When the connector's onboarding mode holds new agents for approval, the channel waits until a supervisor approves the agent. A channel you run yourself says so, names the request to approve under Approvals in the console, and waits: it connects as soon as the request is approved. Press Ctrl+C to stop waiting. If the request is declined or expires, the channel stops; run it again to ask again. With --no-wait, it stops at once with exit status 3. Meanwhile, ap-cli status and the AgentPass menu show Waiting for a supervisor's approval, with the request ID. The channel connects once the request is approved. See Approvals in the Console.