> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesyndicate.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect providers

> Connect Claude, OpenAI (Codex), Google Gemini, and GitHub Copilot, including CLI install and sign-in flows.

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.

<Frame caption="Connected provider cards in Settings">
  <img src="https://mintcdn.com/syndicate-e378bd26/tUHYLKtcaVnFhlNX/assets/screenshots/providers/providers-connected.png?fit=max&auto=format&n=tUHYLKtcaVnFhlNX&q=85&s=d30f22de0d0ef3f1780c253f441c3d99" alt="The Providers settings screen showing connected Claude, OpenAI, and Gemini provider cards with model lists and reconnect controls" width="1920" height="1128" data-path="assets/screenshots/providers/providers-connected.png" />
</Frame>

## Claude

"Claude CLI built in. Connect your account to start."

<Steps>
  <Step title="Click Connect">
    Your browser opens to the Claude sign-in page. The app shows "Complete login in your browser…".
  </Step>

  <Step title="Approve and copy the code">
    Sign in and approve access. The page shows an authentication code.
  </Step>

  <Step title="Paste the code back">
    Return to Syndicate, paste into **Paste authentication code**, and click **Submit**. After "Verifying authentication…" the card flips to **Connected**.
  </Step>
</Steps>

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.

<Warning>
  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."
</Warning>

## 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

<Card title="Choose your default model" icon="microchip" href="/features/providers-and-models">
  Set the model new teams and agents use by default.
</Card>