ProxonProxon
Open Proxon
Documentation

Manual install

Install Proxon on your own Mac or Windows machine and sign in, without IT pushing it out.

For organizations that select the self-service option, each person installs Proxon on their own machine. You'll need to start by getting invited to your company's organization on Proxon. Do not sign up without an invitation unless your admin has indicated that your organization is using autojoin, where you sign up and get placed in the correct organization based on your email domain. Once you join your organization on Proxon you'll be prompted to download and install the observer.

You will need administrator rights on your machine in order to perform the install.

macOS

Step 1: Download and run the installer

You'll be prompted to download the installer during onboarding, immediately after you sign up, so that the client-side observers your organization has chosen to use can be installed. You can also get it later from the Install page under Preferences. Launch the installer after downloading it.

Step 2: Register this Mac

The first step is to connect your Mac to your Proxon account. You'll be redirected to the web, where you'll need to sign into Proxon if you're not already authenticated.

Step 3: Grant the permissions it asks for

The app then walks you through the specific macOS permissions it needs. Which ones you're asked for depends on the observers your organization uses. You may be prompted to:

  • Approve a network system extension. You'll enter your administrator password. This is what lets Proxon capture the AI network calls your tools make.
  • Trust the Proxon certificate. You'll enter your administrator password again. This lets Proxon read the details it needs from those calls, like the model, the token counts, and the cost.
  • Allow Proxon to add a proxy configuration. This routes your traffic through the capture path, so there's something for Proxon to read.
  • Grant Accessibility access. This lets Proxon see the title of the window you're working in, so it can attribute activity to the right app. It also lets the app open the right System Settings panes for you during setup.
  • Allow access to data from other apps. This one is optional. It lets Proxon see the names and timing of Claude Desktop scheduled tasks. Without it, those tasks show up unlabeled.

Step 4: Install a browser extension

Proxon detects which browsers you have installed and offers the ability to install the extension for any supported browser (i.e., Chrome, Firefox, Safari). You only need to install one, but be sure to install it for any browser that you use for work.

Windows

Step 1: Download and run the installer

You'll be prompted to download the installer during onboarding, immediately after you sign up, so that the client-side observers your organization has chosen to use can be installed. You can also get it later from the Install page under Preferences. Launch the installer after downloading it.

Step 2: Register this Computer

After installation completes, Proxon will automatically start and you'll be prompted to connect your computer to your Proxon account. You'll be redirected to the web, where you'll need to sign into Proxon if you're not already authenticated.

Step 3: Install a browser extension

If your organization uses the Browser Observer, the extension is installed automatically for Chrome. Firefox and Edge need to be added manually, which you can do once installation completes by looking for the appropriate button in the Browser Observer section of the Proxon app.

Refresh what is already open

Proxon captures new activity, so anything that was already running when it installed is not seen until it restarts. Refresh any AI sites you have open in your browser, and restart any desktop AI apps and command-line sessions. Anything you open from now on is captured automatically.

Confirm it is working

Once you are signed in, check that your device is reporting. See Confirming data is flowing.

Leave it running

Once you're set up, you can leave Proxon running and forget about it. It keeps capturing in the background and updates itself automatically, so you'll rarely need to open the app again. The main reasons to come back are to add an observer that wasn't part of your original install, or to update the app yourself if you turned off automatic updates.

Uninstall

On macOS, choose Uninstall from Proxon's menu bar menu. After granting permission to the uninstaller, you'll be prompted to restart your Mac to complete the uninstall process.

On Windows, remove Proxon via Add or Remove Programs.