Skip to content

Desktop application

Your agent workspace,
on your machine.

Install Charles on macOS, Windows, or Linux. Sign in with your Charles account to link the device, then choose a managed model route or connect your own provider.
Release channelChecking…
macOS
Windows
Linux
A platform appears here only after its artifact, integrity signature, access policy, and supported distribution path are ready.

Installers

Choose the system you work on.

One account can authorize the number of devices included with your plan. Downloads require sign-in so release access stays tied to entitlement.
.dmg

macOS

macOS 12 or newer

Checking release channel…
.exe

Windows

Windows 10 or newer

Checking release channel…
.deb

Linux

Ubuntu 22.04+ or compatible

Checking release channel…

First run

A deliberate browser-to-desktop handoff.

The website owns account and entitlement state. The desktop app receives a bounded device session—not your web password.
01

Install

Download the artifact published for your operating system and architecture.

02

Authorize

Charles opens a browser sign-in and asks you to approve the named device.

03

Choose a route

Use the catalog available to your account or connect a supported provider key.

Supported distribution

No warning-bypass instructions.

Charles publishes a platform only after its supported release path is ready. Internal test artifacts remain separate from customer downloads.

Read release notes