---
title: "How to Use a Third-Party API in Claude Desktop: Gateway Setup"
description: "How to run Claude Desktop in Gateway mode (third-party inference) with a CodingPass key: what the app does and how to set it up in three steps."
url: https://codingpass.ai/blog/how-to-use-third-party-api-in-claude-desktop-gateway
language: en
updated: 2026-11-19
---
# How to Use a Third-Party API in Claude Desktop: Gateway Setup

Skip the claude.ai login and switch inference to Gateway from the Developer menu. Chat, Cowork and Code then draw on your CodingPass plan in three steps.

[CodingPass team](https://codingpass.ai/about) Published Nov 19, 2026 Updated Nov 19, 2026 10 min read

If you only want the three-step quick reference, see the [Claude Desktop setup guide](https://codingpass.ai/tools/claude-desktop). This post covers what the app does first, then walks through the setup.

## What Claude Desktop does

Claude Desktop is Anthropic's official desktop app for macOS and Windows. The window has three tabs:

- **Chat**: conversations, with generated pages or small tools rendered directly in Artifacts
- **Cowork**: reads a working directory you choose to draft docs, organize files, and run research
- **Code**: Claude Code with a GUI, able to read your codebase, edit files, and run commands

Claude Code also has a terminal CLI and IDE extensions with separate configs—this post covers only the desktop app.

By default, Claude Desktop requires a `claude.ai` login and routes inference and billing through your personal Anthropic subscription. Once Developer Mode is enabled, **Developer → Configure Third-Party Inference** lets you point inference at a Gateway without logging into `claude.ai`.

Anthropic's requirement for a Gateway is the Anthropic Messages API: `POST /v1/messages` must support streaming and tool use, while `GET /v1/models` is optional and auto-populates the model list if implemented. This menu entry started appearing in Chinese tutorials back in April, and Anthropic's docs refer to it as Claude Desktop on 3P.

Once connected to CodingPass, the model picker lists only Claude models:

| Model | Minimum plan |
| --- | --- |
| Claude Sonnet 5.5 | Go |
| Claude Haiku 5.5 | Go |
| Claude Opus 5.5 | Plus |
| Claude Fable 5.1 | Pro |
| Claude Fable 5.2 | Pro |

## Setup walkthrough

### Prerequisites

Download and install Claude Desktop from [claude.com/download](https://claude.com/download). Then open the Keys page in the CodingPass dashboard and create a key with the tool set to Claude Desktop—it starts with `cp-live-`.

On first launch, a sign-in screen appears. Skip signing in and turn on Developer Mode instead.

### Step 1: Enable Developer Mode

- **macOS**: Top menu bar **Help → Troubleshooting → Enable Developer Mode…**.
- **Windows**: Top-left **☰ → Help → Troubleshooting → Enable Developer Mode…**.

![Claude Desktop Help menu expanded to Troubleshooting, highlighting Enable Developer Mode…](https://codingpass.ai/assets/img/tools/claude-desktop/dev-mode-menu.webp)

*The Developer Mode toggle lives under Help → Troubleshooting.*

Click **Enable** in the confirmation dialog. The app does not restart; a **Developer** menu appears directly in the menu bar.

### Step 2: Fill out the Gateway form

Open **Developer → Configure Third-Party Inference…** and select **Connection** in the left sidebar. The top dropdown already defaults to **Gateway**. Fill in the fields in order:

- **Credential kind**: Select `Static API key` first. The API key and auth scheme fields only appear after you choose it.
- **Gateway base URL**: `https://codingpass.ai`, with no `/v1` and no trailing slash
- **Gateway API key**: Paste your full `cp-live-…` key (it renders as dots)
- **Gateway auth scheme**: Leave at the default `bearer`

Leave the remaining fields blank.

![Configure third-party inference window on the Connection tab: dropdown set to Gateway, Credential kind set to Static API key, Gateway base URL set to https://codingpass.ai, API key masked as dots, auth scheme set to bearer, with Test connection at top right and Apply Changes at bottom right](https://codingpass.ai/assets/img/tools/claude-desktop/gateway-form.webp)

*The completed Gateway form.*

You can click **Test connection** in the top-right corner to verify reachability first. Clicking **Apply Changes** at the bottom right saves the settings and prompts you to restart. When you have unsaved edits, **Discard Changes** and **Save Changes** also appear beside it.

### Step 3: Apply Changes and relaunch

Settings are only read at startup. Click **Apply Changes**, then choose **Relaunch now** when **Relaunch Claude?** pops up.

Alternatively, click **Save Changes**, quit the app completely (`Cmd + Q` on macOS, or exit from the system tray on Windows—closing the window alone is not enough), and reopen it.

After relaunching, the sign-in screen is gone and the app opens straight to the main workspace. The bottom-left corner shows "username · Gateway", confirming inference is routed through the Gateway with no `claude.ai` login.

### Send a message to verify

Click the model picker at the bottom right of the input box. If you see Sonnet 5.5 (selected by default), Opus 5.5, Fable 5.2, Haiku 5.5, and Fable 5.1—with **Effort** at the bottom—the setup worked.

![Claude Desktop main workspace with the model picker open showing Sonnet 5.5 (checked), Opus 5.5, Fable 5.2, Haiku 5.5, Fable 5.1, and Effort, above a Say hi in five words prompt and reply, and coco · Gateway in the bottom-left corner](https://codingpass.ai/assets/img/tools/claude-desktop/model-picker.webp)

*The model picker after relaunching, with Gateway shown in the bottom-left corner.*

Send `Say hi in five words` with Sonnet 5.5. If it replies normally, you are all set. Only Claude models appear in the picker; GPT, DeepSeek, and other providers will not show up.

Written by CodingPass team

We run CodingPass and test each guide against the latest stable release of the tool before we publish it. Spotted something out of date? Write to [support@codingpass.ai](mailto:support@codingpass.ai).

## Related reading.

Guide

### [Claude Desktop setup guide](https://codingpass.ai/tools/claude-desktop)

Gateway mode in three steps, and which Claude models each plan includes.

Guide

### [CC Switch setup guide](https://codingpass.ai/tools/cc-switch)

Import from the Keys page in one click and switch between CodingPass and the official login.

Reference

### [How allowances and caps work](https://codingpass.ai/usage-limits)

Allowances and caps for every plan and model, and what a 429 means.
