Connecting Modal
In Settings > Compute > Cloud providers, click Connect on the Modal card. If you’ve signed in with the Modal CLI (modal token new), the app reads ~/.modal.toml automatically; click Check again after the file exists. Alternatively, paste a Token ID and Token secret in Settings > Credentials, under Modal. Tokens are stored encrypted on your computer and never shown to Claude.
Running cloud jobs
When work needs a GPU or more memory than your machine has, Claude proposes a job and a Start a Modal job? card appears. The card shows the Modal profile, exact machine spec (for example, H100, 8 CPUs, 32 GiB), a note that billing is per-second, and the maximum billable time. It links to Modal’s pricing page. Approve per job, or for the conversation or project. A separate card asks before Claude opens a Modal setup shell (capped at 30 minutes, no GPU). Input files are limited to 1 GiB per submit. For larger inputs, Claude can stage data to a Modal Volume and mount it into the job. Outputs written to./out/ (up to 5 GiB) are returned with logs.
Closing the app doesn’t cancel a running Modal job; it continues billing until it finishes or times out.