Tool call governance is currently in limited beta. Contact Opal support to enable it for your organization.
Requirements
Before you begin, you must:- Be an Opal Admin to change rules and settings, and to open Setup. Read-only admins can view Activity and rules.
- Have tool call governance enabled for your organization. Contact Opal support.
How it works
A hook is something an agent runs at set moments, such as just before it runs a tool. Opal’s hooks tell Opal what the agent is doing, and Opal answers. Depending on the agent, a hook is a small program that you install on each computer, or a setting that the agent reads, such as Claude Code’s HTTP hook.
When Opal stops a call, the hook passes the answer to the agent, and the agent doesn’t run the call.
If Opal is slow or can’t be reached, the call runs anyway. The hook fails open: when it can’t reach Opal, or Opal doesn’t answer within a few seconds, the agent runs the call as if there were no hook. The hook isn’t a security boundary. It reaches only the computers that run it, and it relies on the agent to follow Opal’s answer.
Cowork doesn’t run a hook. You point Cowork’s telemetry at Opal in Claude’s admin console, and Opal reads it after each call. Opal records Cowork’s calls, and it can’t stop one through its telemetry. See the Cowork page.
Anthropic’s inference hook is a second route, for Claude.ai, Cowork and the API. Anthropic sends each tool call to Opal before it runs, and Opal’s rules, Tool defaults, blocked servers and pauses decide it. Opal’s answer applies at once. The Log and Enforce switches don’t apply to these calls. They also don’t wait for Opal to turn on enforcement. A rule or Tool default that asks the developer to confirm refuses the call instead, because the hook can’t ask the person. If Opal can’t answer, Anthropic applies your organization’s failure handling for Inference hooks. To set it up, go to Agent Center > Setup > Anthropic, and find Inference hooks. The Cowork page has the details.
Set up an agent
Each agent has its own setup page.
To see the agents themselves, go to Agent Inventory.
Where you work in Opal
Everything is under Agent Center in the left sidebar.
Admins and read-only admins can open Agent Center. Only admins can change rules and settings, and only admins see Setup.
Log, Enforce and conversation content
Go to Agent Center > Setup > Clients. Each agent has these settings.
The settings apply to your whole organization. Computers pick up a change within a few minutes, with no reinstall.
What the two switches do together
To switch an agent off, turn off both Log and Enforce for it. Turn either one back on to start again. Each agent’s setup page says what a switched-off agent can still send.
Opal’s Claude Code hook can also block a prompt that contains a key or token. Enforce must be on for Claude Code. Opal must also have turned on enforcement for your organization. The Claude Code page explains it.
Cowork has Log and no Enforce switch, because Opal can’t stop its calls through its telemetry. Log is on unless you turn it off.
Opal turns on enforcement for each organization. Until it is on for yours, Enforce behaves like Log only. Opal checks every call and records what a rule, a Tool default or a blocked server would have done, but none of them stops a call. Activity shows these calls as Would have blocked or Would have asked. Contact Opal support to turn on enforcement. A pause stops calls whether or not enforcement is on.
Store conversation content
Conversation content is the prompts people send, the model’s replies, and what each tool returned. Opal masks credentials and personal data that it recognizes, such as email addresses and phone numbers, and cuts long text. Two settings decide whether Opal stores it. First, Opal turns on conversation content storage for each organization. Until it is on for yours, Opal stores none, whatever you choose below. Contact Opal support to turn it on. Second, Store conversation content under Setup > Clients sets the choice for each agent:
The second setting matters only when the first is on. With Log off, Opal stores none. Each agent’s setup page says what its computers send, and where a choice doesn’t apply. For example, Claude Code’s HTTP hook always sends conversation content, so Each person decides acts like Always for it. Cowork has no content choice, because each Cowork device decides what it sends. Opal stores what Cowork sends only when the first setting is on.
Rules
A rule says what Opal does with the calls that match it. Each rule has a result: Allow, Allow and flag, Ask the developer to confirm or Block. You write rules under Agent Center > Policies, or describe one in plain English and let Agent Consul draft it. Every organization starts with recommended rules that flag risky calls and stop none. A rule or Tool default that asks the developer to confirm works in Claude Code only. Cursor, Codex and Anthropic’s inference hook can’t ask the person, so they refuse the call. Opal has no approval queue for tool calls. Rules for tool calls covers the results, the conditions, what wins when rules conflict, Tool defaults, the recommended rules, and how to create and test a rule.Pause agents
A pause stops agent tool calls for a set time. It is the quickest way to stop calls while you check a policy.- Pause every agent. Select Pause agents at the top of Agent Center. Choose 15 minutes, 1 hour, 4 hours or 24 hours, and, if you want, enter a reason. Opal sends the reason and the end time to the agent. While agents are paused, a banner shows when the pause ends, with Extend and Resume now.
- Pause one agent or one person. Open a call in Activity and use Pause in its details. Active pauses appear under Paused now on Policies, where you can end them with Resume.
Read the outcome in Activity
What Opal records
For each call, Opal records:- The tool’s name and arguments, such as a shell command, a file path, a URL, or an MCP tool’s input.
- Who the call was for and which agent it came from, when Opal can match them.
- The labels that the computer reports for the person, such as email addresses and the computer’s name, where the hook reports them.
- The time, the working folder, and the permission mode where the agent reports it.
- What Opal decided: the outcome, the rule or default that decided it, and the reason.
- Whether the call ran or failed.
What isn’t covered
- Computers without the hook. A computer that doesn’t run the hook, or whose agent has Log and Enforce both off, runs calls without Opal’s check.
- Calls Opal can’t check in time. If Opal doesn’t answer within a few seconds, the call runs. The hook may send the check again afterward, so Opal still records the call, without a decision.
- Agents in a vendor’s cloud. The hook runs on your organization’s computers. Each agent’s setup page says what it covers.
Next steps
- Set up an agent: Claude Code, Cowork, Cursor, or Codex.
- Write your first rule: see Rules for tool calls.