Before you begin
You’ll need:- Access to the Switch Trust organization your team uses. If you don’t have it, ask an Org Admin to invite you. Signing up without an invitation creates a separate, empty organization.
- The Editor role or higher in Switch Trust. With a lower role, the Claude Code plugin card can’t be selected.
- Claude Code, on each computer where you want to report usage.
- Python 3 on that computer, available as the
python3command.
Roll the plugin out to a team
Each person installs the plugin on their own computer. You can share one Ingest only key across the team. Teammates don’t need a Switch Trust account to send data, only to see it. Each person still appears as their own agent, named from their Git email or the address they set in User Email Override. Revoking a shared key stops reporting for everyone who uses it. To stop one person at a time, give each person their own key.Connect Claude Code
1
Create an API key
In the setup steps, under Get an API key, select Create one now. The
Ingest only role is selected for you, which lets the key send data to Switch Trust without reading
any. Copy the key. To use an existing key instead, see API keys.
2
Install the plugin
In Claude Code, run:
3
Enter your API key
When Claude Code asks for the plugin’s settings, enter the key under
Switch Trust API Key. To change the settings later, open
/config in Claude Code.4
Use Claude Code
Ask Claude Code for something as you normally would. The plugin uploads your first reply in
a session right away.
Where the email comes from
Where the email comes from
The plugin uses User Email Override if you set it, then your Git email
(
git config user.email), then the login name on your computer.Choose what the plugin sends
By default, the plugin sends whole conversations, including tool calls and their output. It removes personal data it recognizes on your computer before sending, but it can miss some. Everyone in your Switch Trust organization can read what it sends, whatever their role. To send less, set Report Mode in/config:
- text: Prompts and responses, without tool calls or tool output.
- condensed: Token counts for each model and a one-line title for the session, with no conversation text. The plugin uploads once, when the session ends.
- none: Stops reporting.
Switch ROI bases most of its recommendations on conversation content. With text, it doesn’t
see tool calls, which some recommendations depend on. With condensed, you still see cost, but most
recommendations have nothing to analyze. With none, the plugin sends nothing.
Check the plugin
If no agent appears, run/switch-trust-status in Claude Code. It shows the plugin’s settings
and the end of its log. If the log says no switch_trust_api_key configured; skipping, enter
your key under Switch Trust API Key in /config.
Remove the plugin
In a terminal, run:Next steps
Spending and caps
See what each person’s Claude Code use costs
Connect your data sources
Add another data source

