Skip to main content
Agents run on provider CLIs using your own accounts. After signing in to Syndicate you land on “Connect a provider to get started”. Connect at least one; you can add the rest any time in Settings, Providers. Each provider card shows its status (Connected in green, Not connected in amber) and one button:
  • Install CLI: the CLI is missing. Syndicate installs it for you using its bundled runtime (no Node.js setup required). When done: “CLI installed. Click Connect to sign in.”
  • Connect: the CLI is installed but not signed in.
  • Reconnect: already connected; use this to switch accounts.
A Check button re-probes all providers, and live progress bubbles show each detection step.
The Providers settings screen showing connected Claude, OpenAI, and Gemini provider cards with model lists and reconnect controls

Connected provider cards in Settings

​
Claude

“Claude CLI built in. Connect your account to start.”
1

Click Connect

Your browser opens to the Claude sign-in page. The app shows “Complete login in your browser…”.
2

Approve and copy the code

Sign in and approve access. The page shows an authentication code.
3

Paste the code back

Return to Syndicate, paste into Paste authentication code, and click Submit. After “Verifying authentication…” the card flips to Connected.
If the sign-in service is busy, Syndicate falls back automatically: “Claude OAuth endpoint is busy — switching to terminal login.” Complete the sign-in in the terminal window that opens; Syndicate detects the credentials automatically.

​
OpenAI (Codex)

“Use your ChatGPT account to authenticate Codex.” Click Connect. A sign-in flow opens (an in-app terminal on Windows, Terminal.app on macOS). Sign in with your ChatGPT account; Syndicate detects the credentials within a few seconds of completion.
Codex requires a ChatGPT plan that includes Codex access. If yours does not, you will see: “This ChatGPT account cannot run Codex. Upgrade ChatGPT to access Codex, or use Claude/Gemini.”

​
Google Gemini

“Authenticate Gemini to enable Google models.” Click Connect and complete the Google sign-in in the terminal flow (including any two-factor prompts). Syndicate watches for the credentials and refreshes the card automatically: “Detected new Gemini credentials — refreshing provider state.”

​
GitHub Copilot

“Sign in with a paid or free Copilot plan to run Claude/GPT models.” Click Connect and complete the GitHub sign-in in the terminal flow (copilot login). Any active Copilot plan works, including the free tier. Once connected, Copilot’s models appear in selectors with a “(via Copilot)” suffix, so you can tell them apart from the direct Claude and OpenAI providers.

​
The in-app sign-in terminal

When a provider signs in through the in-app terminal, the window is titled “[Provider] sign-in” and closes automatically when sign-in finishes. If the CLI asks for input, type it in the field at the bottom and press Enter. If it exits early you will see “Auth terminal exited with code X before completion.”; close it and click Connect again.

​
Managing providers later

In Settings, Providers, each card shows the CLI version, model list, and Connect / Reconnect / Disconnect actions. If credentials expire while you work, an amber banner appears at the top of the app with a one-click Reconnect [Provider] button. If an install fails, a diagnostic modal lists each step with its result and a Copy diagnostic button for support.

​
Next step

Choose your default model

Set the model new teams and agents use by default.