Claude and Codex Channels
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 macOS workstations.
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.
| Tool | What the channel provides | Conversation behavior |
|---|---|---|
| Claude Code | Live messages, replies, conversation list and history | A supervisor can continue an existing conversation or start a new one |
| Codex | Live messages, replies, thread list and history | A 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.
Endpoint Guard manages Claude and Codex channels on macOS only. See Endpoint Platform Support.
Before You Begin
You need:
- An enrolled Mac running Endpoint Guard for macOS
- Managed Desktop Tools enabled, with Claude Code, Codex, or both selected
- 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
Enable the Channels
- Open Oversight → Desktop Tools.
- Turn Managed mode on.
- Under Managed tools, select Claude Code, Codex or both.
- Choose the corresponding provider connector under Inference routing.
- 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. Removing the tool from managed mode 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
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
- Open the managed agent in AgentPass, and check that its channel shows as connected.
- 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.
Related
- Managed Desktop Tools — manage routing, MCP tools, channels and egress controls
- Having Conversations with Your Agent — send and receive supervisor messages
- Endpoint Guard for macOS — install and enroll the endpoint component