Skip to main content

​
Overview

Each AI provider in Whim has a different authentication method. CCR + OpenRouter works out of the box, Claude requires an OAuth token from your Anthropic subscription, and Codex uses a ChatGPT device code login.

​
CCR + OpenRouter Setup

No setup required. CCR + OpenRouter is the default provider and is managed entirely by Whim. API usage is tracked and billed as part of your CU allocation. When you create a new workspace, CCR + OpenRouter is automatically selected and ready to use.

​
Claude Subscription Setup

Connecting your Anthropic Claude subscription lets you run the native Claude Code CLI in Whim task containers.

​
Getting Your OAuth Token

1

Open Claude Code on your local machine

If you don’t have Claude Code installed locally, follow Anthropic’s setup guide to install and authenticate.
2

Copy your OAuth token

Run the following command in your local terminal:
claude setup-token
This outputs your OAuth token. Copy it to your clipboard.
3

Paste the token in Whim

Go to Settings > My Defaults > Claude and paste your OAuth token into the token field. Click Save.
Once saved, the connection status indicator will show a green dot with Connected.
Your OAuth token is encrypted before being stored. It is never exposed in logs or to other workspace members.

​
Token Management

  • Status display — The Claude settings panel shows when your token was created and last used
  • Updating — Paste a new token to replace the existing one
  • Removing — Clear the token field and save to disconnect

​
Codex Subscription Setup

Connecting your ChatGPT account lets you run the native Codex CLI in Whim task containers.

​
Device Code Login Flow

1

Open the Codex connection panel

Go to Settings > My Defaults > Codex and click Sign in to ChatGPT.
2

Enter the device code

Whim displays a device code (e.g., AB1D-EF2H) and a link to the OpenAI verification page. Click the link to open it in your browser.
3

Authorize the connection

Enter the device code on the OpenAI verification page and approve the connection. The page will confirm when authorization is complete.
4

Verify the connection

Return to Whim. The connection status will update to show a green dot with Connected once the device code is verified.
Device codes expire after a short time. If the code expires before you complete authorization, click Sign in to ChatGPT again to generate a new one.

​
Setting Workspace Defaults

Workspace defaults determine the provider and model used when members create new tasks. Only workspace admins can change these. Go to Settings > Workspace > Defaults to configure:
  • Default provider — Which provider new tasks use (CCR + OpenRouter, Claude, or Codex)
  • Default model — Which model new tasks use within that provider
  • Permission mode — How the agent handles tool permissions
  • Reasoning effort — Codex reasoning level (see Fast Mode & Reasoning)
  • Fast mode — Whether fast mode is enabled by default
Individual workspace members can override these defaults in Settings > My Defaults without affecting other members.

​
Provider-Specific Settings

Each provider supports its own set of configurable options:
SettingCCR + OpenRouterClaudeCodex
ModelYesYesYes
Permission modeYesYesYes
Fast modeNoYesYes (GPT 5.4 only)
Reasoning effortNoNoYes
These can be configured at both the workspace level and the user level. User-level settings override workspace defaults.

​
Connection Status Indicators

The settings panel shows the connection state for each provider:
IndicatorMeaning
Green dot — ConnectedProvider is authenticated and ready to use
Grey dot — Not connectedProvider needs setup before it can be used
Spinner — CheckingWhim is verifying the connection status
You can only set a provider as your default if its connection status shows Connected. CCR + OpenRouter is always connected since it’s managed by Whim.

​
Troubleshooting

Your OAuth token may have expired. Generate a fresh token by running claude setup-token on your local machine and paste the new token in Whim.
Device codes are time-limited. Click Sign in to ChatGPT again to generate a new code. Make sure to complete the authorization promptly after the code appears.
Make sure the provider is connected (green dot) before setting it as your default. If you’ve just connected, try creating a new task — existing tasks keep the provider they were started with.
User defaults override workspace defaults, but only for new tasks. Check that you’re looking at Settings > My Defaults (not workspace defaults). Also verify that the provider you selected is connected.

​
Next Steps

Supported Providers

Compare providers and available models.

Fast Mode & Reasoning

Configure speed vs quality tradeoffs.