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

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

Connect Claude Code to your organization's gateway. The wizard configures its models and optional MCP servers and Skills.

## Run setup

With Claude Code 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-code
```

Sign in to your organization, choose the models recommended by your administrator 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

Map the **Opus**, **Sonnet**, and **Haiku** tiers to the gateway model IDs recommended by your administrator. Sonnet is the default for everyday coding; Opus handles complex tasks, and Haiku handles fast background work.

![Claude Code model tier settings](https://mintcdn.com/truefoundry/6Os5PQcPcHaNsbQT/images/ai-gateway/personal-setup/claude-models.png?fit=max\&auto=format\&n=6Os5PQcPcHaNsbQT\&q=85\&s=cdab3e6e1e19e990d70701a72a55d8e5)

Example model mappings; use your organization's model IDs.

## Open Claude Code

Open a **new terminal** and launch Claude Code normally. Complete model sign-in if prompted.

## Optional: authorize MCP servers

Open `/mcp` inside Claude Code and authorize any selected 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 Code integration guide](https://www.truefoundry.com/docs/ai-gateway/claude-code.md).


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