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

# Claude Desktop

> Set up Claude Desktop with TrueFoundry AI Gateway using the setup wizard.

Connect Claude Desktop to your organization's gateway. The wizard configures its gateway connection, model choices, and optional MCP servers, and prepares selected Skills for upload.

## Run setup

With Claude Desktop installed, [install the setup tool](https://www.truefoundry.com/docs/ai-gateway/personal-setup.md#install-the-setup-tool), then run:

```bash theme={"dark"}
tfy-local-ai-setup personal claude-desktop
```

Sign in to your organization, choose models and any MCP servers or Skills you need, then review and approve the changes. You can skip MCP servers and Skills. See the [overview](https://www.truefoundry.com/docs/ai-gateway/personal-setup.md#connect-your-agents) for the shared wizard walkthrough.

## Choose models

In the wizard, map the **Opus**, **Sonnet**, and **Haiku** tiers to the gateway model IDs recommended by your administrator:

* **Opus:** for complex tasks.
* **Sonnet:** for everyday coding and chat.
* **Haiku:** for fast background work and Cowork sub-agents. Include a Haiku model so those tasks can resolve correctly.

Review all three choices before approving. These choices populate Claude Desktop's model list. For more detail, see [Identity & Models](https://www.truefoundry.com/docs/ai-gateway/claude-desktop.md#identity--models).

![Claude Desktop setup review showing Opus, Sonnet, and Haiku mapped to Claude gateway models](https://mintcdn.com/truefoundry/WDjROyMkpUZ8WZAf/images/ai-gateway/personal-setup/claude-desktop-review.png?fit=max\&auto=format\&n=WDjROyMkpUZ8WZAf\&q=85\&s=f811c4a79ddc6308100c32f7379ffec1)

Review the Opus, Sonnet, and Haiku model mappings before approving.

## Finish in Claude Desktop

1. Follow any quit/reopen prompt so setup can apply the TrueFoundry configuration.
2. If setup provides a configuration import file instead, import that file in Claude Desktop using the completion summary's instructions.
3. If you selected Skills, upload the generated ZIP files in **Customize → Skills**. The completion summary lists the files to use.
4. Open a new conversation. Authorize any selected MCP servers that require sign-in.

## Verify the connection

Select your configured model in a new conversation and ask: `Reply exactly TFY-CHAT-OK. Do not use tools.` Confirm that a response arrives without an authentication or model error. Then [verify the request in the gateway](https://www.truefoundry.com/docs/ai-gateway/personal-setup.md#verify-the-connection).

For manual configuration and advanced options, see the [Claude Desktop integration guide](https://www.truefoundry.com/docs/ai-gateway/claude-desktop.md).


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