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

# Get started with Barndoor Bridge

> Sign in to Barndoor Bridge, launch Claude Desktop, Claude Code, Codex, Codex Desktop, and Kilo through your organization, see which models you get, connect your organization's tools, and bring over your history.

This page is for people whose IT team has installed Barndoor Bridge, the **Barndoor** app, on their computer. You use your AI coding tools as before, but you start them from Bridge, so they run on your organization's models, tools, and policies. IT installs and updates Bridge; your Barndoor admin decides which models and tools you get.

> [!WARNING]
>
> Opening Claude, ChatGPT, or Kilo directly starts your **personal** copy, which your organization doesn't govern. For work, always start them from Bridge or with `barndoor run`. On some computers, IT has set this up so that a client opened directly refuses to work and tells you to use Bridge.

## Before you start

* **Barndoor** installed by IT, on **macOS 15 Sequoia or later** or **Windows 11**.
* A Barndoor account in your organization.
* The clients you want to use. Bridge starts them but doesn't install them. [Supported clients](https://docs.barndoor.ai/how-tos/barndoor-bridge/overview.md#supported-clients) lists which work on macOS and Windows.
* For Claude Desktop: version **3.1623.0 or later**. On Windows, the Microsoft Store (MSIX) build.

## Open Bridge and sign in

Bridge starts in the background when you log in to your computer.

* **macOS:** open **Barndoor** from Applications, Spotlight, or the Dock, or choose **Show Window** from its menu-bar icon. Closing the window hides it; to stop Bridge, choose **Quit** or press Cmd-Q. If your menu bar is crowded, macOS may hide the icon, but the Dock icon always works.
* **Windows:** click the Barndoor icon in the system tray (it may be under the **^** overflow) and choose **Open in Browser**. Bridge's panel opens in your browser.

**1. Click Log in**

It's on the Status tab and in the menu. Your browser opens Barndoor sign-in; finish it with your organization's sign-in.

**2. Check that you're signed in**

Back in Bridge, the header reads **Connected**, and the Status tab shows how many servers you have and when Bridge last synced. **No cache** means the first sync hasn't finished; wait a few seconds. If your organization has Bridge govern models only, there are no servers to sync, and the header reads **Signed in** instead.

![The Bridge window's Status tab: the header reads Connected; rows show Product barndoor, Environment prod, Authenticated yes, Servers 36, Last sync 45s ago — Synced 36 servers (16 remote, 18 embedded), and the Bridge version](https://mintcdn.com/barndoor/uSY_8OkOSYsIfW_b/images/barndoor-bridge/bridge-window-status.png?fit=max\&auto=format\&n=uSY_8OkOSYsIfW_b\&q=85\&s=e9f0693731175228053b620fe49560e6)

## The Bridge window and menu

| Tab | What it shows |
| - | - |
| **Status** | Your connection, **Log in / Log out**, a button for each app you can launch, and your Claude plan usage. When a server needs your attention, a link such as **1 needs attention** opens the Servers tab. |
| **Servers** | Every MCP server you can use, with its status and, when one can't be used, what to do. See [Check your servers](https://docs.barndoor.ai/how-tos/barndoor-bridge/whats-blocked.md#check-your-servers). |
| **Policy** | A read-only view of your organization's policy as Bridge last synced it. |
| **Logs** | Bridge's recent diagnostics, with **Copy** for a support request. |

When Bridge needs an answer from you, such as a sign-in that expired, the question appears at the top of the window, whichever tab is open.

**Claude plan usage** shows how much of your 5-hour and weekly Claude limits you've used, once a governed Claude session has run. If your plan runs out and your organization has an API-key fallback, Bridge shows **Org API key in use** until your plan resets.

The menu-bar icon on macOS, and the tray icon on Windows, has the same launch buttons, plus:

* a status line with your environment and how many servers Bridge has synced
* your Claude plan usage
* **Update available**, when IT has a newer Bridge to install for you
* **Show Window** (macOS) and **Open in Browser**, which opens the same panel in your browser
* **Log in** or **Log out**, and **Quit**

![The Bridge menu-bar menu: a status line reading barndoor / prod — 36 servers; Claude plan usage with 5-hour, Weekly all models, and Weekly Fable rows showing percentage used and reset times; then Show Window, Open in Browser, Launch Claude Desktop, Launch Codex Desktop, Log out, Open source licences, and Quit](https://mintcdn.com/barndoor/LbeOZGQ6MiunAFFD/images/barndoor-bridge/bridge-menu.png?fit=max\&auto=format\&n=LbeOZGQ6MiunAFFD\&q=85\&s=c82a1721274635d42338dfc08ee3f377)

## Launch a client

### Claude Desktop

Click **Launch Claude Desktop**. It's greyed out until you sign in.

The governed Claude Desktop runs as a second copy next to your personal one, with its own data, so you may see two Claude icons. The governed one shows **Gateway** next to your name at the bottom of the sidebar.

* **Chat:** ask in plain language, for example "list my open Jira issues". Claude finds the right tool among the servers your organization connected in Barndoor.
* **Cowork:** works as usual. Its commands run through Barndoor's shell, so everyday tools such as `git`, `gh`, and `curl` work unless your admin has blocked a command.
* **Code tab:** works as usual in a project folder.

> [!NOTE]
>
> If your organization has Bridge govern **MCP only**, there's no second copy: **Launch Claude Desktop** opens your own Claude Desktop, on your own Claude sign-in, with a `barndoor` server added. If Claude Desktop is already open, Bridge v0.1.250 and later on a Mac ask **Quit Claude Desktop?** and reopen it for you. On Windows, or with an earlier Bridge, quit Claude Desktop completely before you launch it from Bridge; otherwise `barndoor` may not appear, or may disappear the next time you change a setting. In a chat, `barndoor` is under **+ → Connectors**; if you switch it off or remove it, launch from Bridge again to get it back.
>
> If you also see your own Barndoor connector there, from your claude.ai account, turn it off in chats and Code sessions where you need tools that run on your computer. Otherwise Claude may use it, and those tools are refused with a message that they only run locally through barndoor-cli.

After IT updates Bridge, quit the governed Claude Desktop and launch it again from Bridge.

If your Claude sign-in has expired, Bridge asks you to sign in again in your browser, then reopens Claude Desktop. If Bridge tells you to quit Claude Desktop and open it again, do that: it happens after a restart, when your computer reopened Claude Desktop before Bridge had cleaned up its previous session.

### Claude Code and Codex in a terminal

Start a governed session in the current folder:

```bash theme={null}
barndoor run claude
```

```bash theme={null}
barndoor run codex
```

Anything after `--` goes to the client, for example `barndoor run claude -- -p 'say ok'` or `barndoor run codex -- exec 'say ok'`. Barndoor's own options go before it:

```bash theme={null}
barndoor run claude -C ~/src/my-project   # work in another folder
barndoor run claude --continue            # the most recent session in this folder
barndoor run claude --resume <id>         # a specific session, by ID prefix
```

Each launch prints a short summary first: the models your organization picked for each model choice, the agent name your organization's audit log records, and the settings in force.

![Terminal output of barndoor run claude -- -p 'say ok': a New session line; barndoor: governed claude session using Claude Code settings v1; barndoor: models - Default: claude-opus-5-5 (1M), Opus, Sonnet, Haiku, Fable and Advisor; barndoor: tool calls attributed to agent Claude Code; a Barndoor Agent Runtime line with settings, environment, filesystem, shell, network, skills, subagents and workspace; then ok](https://mintcdn.com/barndoor/8Ls1jiA1Jv07Skll/images/barndoor-bridge/barndoor-run-claude-summary.png?fit=max\&auto=format\&n=8Ls1jiA1Jv07Skll\&q=85\&s=296b31e225177d0fd24eb2d0d92a5500)

Run Codex from a project folder. It won't start in your home folder if you have your own Codex settings there.

### Codex Desktop

**Launch Codex Desktop** appears where IT has set up Codex and Codex Desktop is installed (ChatGPT.app on a Mac, the Microsoft Store Codex app on Windows). If you don't see it, ask IT; there's nothing to turn on in Bridge.

Click it and choose the project folder Codex should work in. Codex can read and change files only in that folder. It opens without the welcome screens, and your conversations are kept between launches.

Where IT has set up Codex, Codex Desktop and the `codex` command work only when started through Barndoor.

Bridge asks you to sign in to ChatGPT again in your browser when your sign-in is no longer valid, about every ten days if you use Codex only through Bridge. On Windows, closing the Codex Desktop window doesn't quit Codex; click **Launch Codex Desktop** again to bring the window back.

### Kilo

* **Kilo Desktop:** **Launch Kilo Desktop** in Bridge opens Kilo working in your home folder.
* **Kilo in VS Code:** **Kilo Code (VS Code)** opens a separate VS Code window set up for Barndoor, with your extensions. Tools installed through Homebrew or a version manager may not be on that window's `PATH`.
* **Kilo CLI:** `barndoor run kilo` in a terminal.

Your Kilo conversations are kept between launches.

## Which models you get

Your organization decides which models you can use, unless it has Bridge govern **MCP only**, where you use the models on your own Claude or ChatGPT sign-in. Each client shows your organization's models in its own way:

| Client | Where you see your models |
| - | - |
| **Claude Desktop** | The model picker lists the Claude models you're allowed, by name, for example **Claude Opus 5.5 (eng)**. GPT and other non-Claude models aren't shown; use Codex or Kilo for those. |
| **Claude Code** | `/model` offers Opus, Sonnet, Haiku, and Fable, each set to a model your organization picked. For any other model you're allowed, type `/model` followed by its full name. |
| **Codex** CLI and Desktop | The model picker lists every model you're allowed, and you can switch among them. |
| **Kilo** | Your models are listed under one provider, **Barndoor**, and you can switch among them. |

A running session keeps the models it started with. If you see fewer models than you expected, ask your admin.

## Use your organization's tools

Your organization's MCP servers (Jira, GitHub, Salesforce, and so on) are available in every client Bridge launches. Your organization's policy decides which tools you can use, and some actions need your approval first: the client shows you exactly what it's about to do and asks. Approve only after you've seen that description; saying "I approve" in advance doesn't count.

![A governed Claude Desktop conversation. Asked to start a Temporal workflow, Claude replies that the organization's Barndoor policy needs approval before the workflow starts and nothing has run yet, lists the workflow type, ID, task queue and arguments, and asks whether to go ahead. After the user answers yes, go ahead, Claude reports that the workflow started and gives its run ID.](https://mintcdn.com/barndoor/8Ls1jiA1Jv07Skll/images/barndoor-bridge/governed-desktop-local-mcp-approval.png?fit=max\&auto=format\&n=8Ls1jiA1Jv07Skll\&q=85\&s=103551bbac3d1f4e56c7fabc49febb8c)

Some servers you turn on yourself, including tools that run on your computer:

1. In Barndoor, open **My Apps** and select **Connect** on the server. Enter credentials if it asks.
2. Bridge picks it up within about five minutes. To sync now, run `barndoor sync`.
3. Start a new session. A session that was already open keeps the servers it started with.

**AWS CLI** is one of these, if your admin has turned it on. It runs AWS commands on your computer with your own AWS profiles, so it reaches every account you already can, and AWS logs the actions as you. Commands that print credentials or open an interactive session are blocked. If your SSO session has expired, run `aws sso login --profile <name>` in your own terminal.

If your admin asks you to run a one-time setup command for a server, run it yourself in your own terminal, for example `barndoor local-mcp exec auth0 init`. It won't run inside a Claude or Codex session.

## Bring over your history

* **Claude Desktop chats, Cowork tasks, and Code sessions, and claude.ai chats and projects:** in the governed Claude Desktop, use **Settings → Import**.
* **Claude Code CLI sessions (`~/.claude`)**: run `barndoor sessions import` once in a terminal.

Custom instructions, scheduled tasks, and organization plugins from your personal Claude aren't imported. Set them up again in the governed Claude Desktop.

## Something blocked or not working?

See [What's blocked and why](https://docs.barndoor.ai/how-tos/barndoor-bridge/whats-blocked.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.