# 0.2.4 The desktop apps (/how-ai-works/your-first-hour/desktop-apps)

---
type: Document
title: "0.2.4 The desktop apps"
description: "A walkthrough of the Claude and ChatGPT desktop apps: choose how freely the AI works, give it a folder, let it use a browser and build a page, with which plan has what, as checked on 29 October 2026, with Anthropic's plan details checked again on 31 October 2026."
status: stable
order: 12.4
ksor:
  owner: team:panaversity
  audience: [ public ]
  approval:
    by: process:panaversity
    at: 2026-11-04T06:52:57Z
chapter: "0.2"
part: "0"
expert_status: null # as the Part 0 overview: Part 0 is optional on every route, after the skip quiz
concepts: [ "0.2.4" ]
last_verified: 2026-10-29
steps_run:
  # checks before approval (T-49): still to come, the free-account rows on both apps and each tab of the optional steps
  - { what: "Screens of the Claude app's Chat and Code tabs, no task run: the message box's Project or folder and Auto controls, and the Code tab's terminal, browser and files buttons. Two figures come from them.", by: "human:mjunaidca", date: 2026-10-29, app_version: "Claude 4.29.0, Max plan" }
  - { what: "Step 2's message run in Claude's Code tab, on Lab 4's folder and in Auto, so with no Allow prompt. Claude showed its plan as three steps and saved the list. The New environment window for choosing a folder in Code gives a figure.", by: "human:mjunaidca", date: 2026-10-29, app_version: "Claude 4.29.0, Max plan" }
  - { what: "The ChatGPT app explored with computer use on Junaid's Mac, at his request, no task run: the Chat and Work switch, the permissions menu, Choose project and its Create project window, the run-location menu, the Codex folder menu, and View's Open Terminal and Browser. Two figures come from it.", by: "Claude Code, on human:mjunaidca's computer", date: 2026-10-29, app_version: "ChatGPT 26.1016.51333" }
sources:
  - id: openai-moving-desktop
    title: "Moving to the new ChatGPT desktop app (OpenAI Help Center, verified 2026-11-04)"
    resource: https://help.openai.com/en/articles/20001276-moving-to-the-new-chatgpt-desktop-app
  - id: anthropic-install-desktop
    title: "Install Claude Desktop (Claude Help Center, verified 2026-10-28)"
    resource: https://support.claude.com/en/articles/10065433-installing-claude-for-desktop
  - id: anthropic-download
    title: "Download Claude (Claude, verified 2026-10-28)"
    resource: https://claude.com/download
  - id: anthropic-one-claude
    title: "Claude Cowork and chat are one Claude (Claude Help Center, verified 2026-10-28)"
    resource: https://support.claude.com/en/articles/16761823-claude-cowork-and-chat-are-one-claude
  - id: anthropic-get-started-tasks
    title: "Get started with Claude Cowork (Claude Help Center, verified 2026-10-28)"
    resource: https://support.claude.com/en/articles/13345190-get-started-with-claude-cowork
  - id: anthropic-get-started-tasks-plans
    title: "Get started with Claude Cowork, the plans it reaches first (Claude Help Center, updated 30 October 2026, verified 2026-10-31)"
    resource: https://support.claude.com/en/articles/13345190-get-started-with-claude-cowork
  - id: anthropic-surfaces
    title: "Use Claude Cowork on web, desktop, and mobile (Claude Help Center, verified 2026-10-28)"
    resource: https://support.claude.com/en/articles/15520349-use-claude-cowork-on-web-desktop-and-mobile
  - id: anthropic-safely
    title: "Use Claude Cowork safely (Claude Help Center, verified 2026-10-28)"
    resource: https://support.claude.com/en/articles/13364135-use-claude-cowork-safely
  - id: anthropic-builtin-browser
    title: "Use the built-in browser in Claude Cowork (Claude Help Center, verified 2026-10-28)"
    resource: https://support.claude.com/en/articles/16607400-use-the-built-in-browser-in-claude-cowork
  - id: anthropic-builtin-browser-plans
    title: "Use the built-in browser in Claude Cowork, the plans that have it (Claude Help Center, updated 30 October 2026, verified 2026-10-31)"
    resource: https://support.claude.com/en/articles/16607400-use-the-built-in-browser-in-claude-cowork
  - id: anthropic-code-desktop
    title: "Claude Code Desktop (Claude Code documentation, verified 2026-10-28)"
    resource: https://code.claude.com/docs/en/desktop
  - id: anthropic-desktop-tour
    title: "Navigating the Claude desktop app (Anthropic Academy, verified 2026-10-28)"
    resource: https://academy.claude.com/tutorials/navigating-the-claude-desktop-app
  - id: anthropic-privacy
    title: "How do I change my model improvement privacy settings? (Anthropic Privacy Center, verified 2026-10-28)"
    resource: https://privacy.claude.com/en/articles/12109829-how-do-i-change-my-model-improvement-privacy-settings
  - id: openai-macos-app
    title: "Downloading the ChatGPT macOS app (OpenAI Help Center, updated 2026-10-28, verified 2026-10-28)"
    resource: https://help.openai.com/en/articles/9275200-downloading-the-chatgpt-macos-app
  - id: openai-windows-app
    title: "Using the ChatGPT Windows app (OpenAI Help Center, updated 2026-10-19, verified 2026-10-28)"
    resource: https://help.openai.com/en/articles/9982051-using-the-chatgpt-windows-app
  - id: openai-work-codex
    title: "ChatGPT Work and Codex (OpenAI Help Center, updated 2026-10-29, verified 2026-10-29)"
    resource: https://help.openai.com/en/articles/20001275-chatgpt-work-and-codex
  - id: openai-usage-limits
    title: "Understanding ChatGPT and Codex usage limits (OpenAI Help Center, verified 2026-11-04)"
    resource: https://help.openai.com/en/articles/20001625-understanding-chatgpt-and-codex-usage-limits
  - id: openai-work-start
    title: "Get started with ChatGPT Work (ChatGPT Learn, verified 2026-10-29)"
    resource: https://learn.chatgpt.com/docs/get-started-with-work
  - id: openai-desktop-app
    title: "ChatGPT desktop app (ChatGPT Learn, verified 2026-10-29)"
    resource: https://learn.chatgpt.com/docs/app
  - id: openai-permissions
    title: "Permissions (ChatGPT Learn, verified 2026-10-29)"
    resource: https://learn.chatgpt.com/docs/permission-modes
  - id: openai-browser
    title: "Using the built-in browser in the ChatGPT desktop app (OpenAI Help Center, updated 2026-10-23, verified 2026-10-28)"
    resource: https://help.openai.com/en/articles/20001277-using-the-built-in-browser-in-the-chatgpt-desktop-app
  - id: openai-pricing
    title: "Plans and Pricing (ChatGPT, verified 2026-10-28)"
    resource: https://chatgpt.com/pricing/
  - id: openai-data-controls
    title: "Data controls in ChatGPT (OpenAI Help Center, updated 2026-10-27, verified 2026-10-28)"
    resource: https://help.openai.com/en/articles/7730893-data-controls-in-chatgpt
  - id: anthropic-3p-overview
    title: "Overview, Claude Desktop on third-party platforms (Claude documentation, verified 2026-10-28)"
    resource: https://claude.com/docs/third-party/claude-desktop/overview
  - id: anthropic-3p-features
    title: "Features, Claude Desktop on third-party platforms (Claude documentation, verified 2026-10-28)"
    resource: https://claude.com/docs/third-party/claude-desktop/feature-matrix
  - id: anthropic-3p-install
    title: "Installation and setup, Claude Desktop on third-party platforms (Claude documentation, verified 2026-10-28)"
    resource: https://claude.com/docs/third-party/claude-desktop/installation
  - id: anthropic-3p-gateway
    title: "Deploy Claude Desktop on 3P with an LLM gateway (Claude documentation, verified 2026-10-28)"
    resource: https://claude.com/docs/third-party/claude-desktop/gateway
  - id: anthropic-3p-in-app
    title: "In-app configuration, Claude Desktop on third-party platforms (Claude documentation, verified 2026-10-29)"
    resource: https://claude.com/docs/third-party/claude-desktop/in-app-configuration
  - id: openrouter-claude-desktop
    title: "Claude Desktop integration (OpenRouter documentation, verified 2026-10-29)"
    resource: https://openrouter.ai/docs/cookbook/coding-agents/claude-desktop-integration
  - id: openrouter-providers
    title: "Provider selection (OpenRouter documentation, verified 2026-10-29)"
    resource: https://openrouter.ai/docs/guides/routing/provider-selection
  - id: deepseek-api-docs
    title: "Your first API call (DeepSeek API documentation, verified 2026-10-29)"
    resource: https://api-docs.deepseek.com/
  - id: deepseek-pricing
    title: "Models & Pricing (DeepSeek API documentation, verified 2026-10-29)"
    resource: https://api-docs.deepseek.com/quick_start/pricing
  - id: deepseek-anthropic-api
    title: "Anthropic API (DeepSeek API documentation, verified 2026-10-28)"
    resource: https://api-docs.deepseek.com/guides/anthropic_api/
  - id: ollama-claude-desktop
    title: "Use Ollama models in Claude on macOS (Ollama documentation, verified 2026-10-28)"
    resource: https://docs.ollama.com/integrations/claude-desktop
  - id: ollama-pricing
    title: "Pricing (Ollama, verified 2026-10-28)"
    resource: https://ollama.com/pricing
generated:
  at: 2026-11-04T06:52:57Z
  by: process:panaversity
trust_tier: unverified
build_id: sha256:e1fbcb7d9a8f8b9b7cb96875022325c02c9ba4be94cef13b301cbd39a9edad85
dirty: true
ksor_version: 0.0.60
---

**In everyday life.** A carpenter builds in their own workshop, from what you send them. Give them a key to your garage, and they can also work with the wood and tools already there, in the rooms you allow. They do the work either way. The key only adds your place.

**What you will learn.** What the desktop app adds to the AI you already use: a way into your own computer's folders, browser and apps. How to give it a folder and get finished work back there, and how it uses a browser, in the Claude app or the ChatGPT app. The walkthrough takes about 20 minutes. An optional step, for later, shows how its coding tool builds something and checks it.

**Why it matters.** On the website or in the app, the AI does its work on a computer of its own, in the AI vendor's cloud. Chapter 1 shows that computer. The desktop app adds yours: the AI reaches the files and apps you already have, but only while the app is open, and only where you allow it.

## Before you start

- **Pick your app.** Each step below has a tab for each app. Pick one, and the whole page follows it. On a free account, pick ChatGPT for Steps 2 and 3. Claude's free plan gives the conversation only, while ChatGPT's free plan includes some longer tasks, which OpenAI calls Work, and some of Codex, its coding tool. "Which plan has what", near the end, shows each one.
- **Lab 0.2's practice files.** Download [`brightline-lab-ch0-2.zip`](https://github.com/panaversity/agentfactory-v2-resources/releases/latest/download/brightline-lab-ch0-2.zip), and unzip it. Its `files` folder holds Brightline's AP policy, this week's twelve invoices and an email from a vendor. Brightline is the book's invented company, so nothing in the files is real.

## Step 1. Install the app, and choose how freely it works

Download the [Claude app](https://claude.com/download) or the [ChatGPT app](https://chatgpt.com/download/), open it, and sign in with the account you already have. Then choose how freely the AI works on your computer. For a first time, choose the setting that asks you first.

```text tab="Claude" tab-group="desktop-app"
The app runs on macOS 13 or later, Windows 10 or later,
and Linux in beta (Ubuntu 22.04 or later, Debian 12 or
later).

Under the message box, next to the model menu, a setting
says Auto. Change it to Manual. Claude then asks before
each action, and you allow or deny it. On the free plan,
if you see no Auto setting, go on without it.
```

```text tab="ChatGPT" tab-group="desktop-app"
The app runs on macOS 14 or later, and on Windows 10 or
later.

1. At the top left, choose ChatGPT. At the top, switch
   from Chat to Work, if you see that switch.
2. Under the message box, open the permissions control,
   and choose Ask for approval. ChatGPT then works inside
   the folder you give it, and asks before it edits other
   files or uses the internet.
3. The computer icon at the right of that row sets where
   the chat runs. Keep On your computer.
```

Claude's steps follow Anthropic's install page[^anthropic-install-desktop] and its page on Auto and Manual.[^anthropic-one-claude] ChatGPT's follow OpenAI's pages on the Mac app,[^openai-macos-app] the Windows app,[^openai-windows-app] Work and Codex,[^openai-work-codex] permissions[^openai-permissions] and where Work runs.[^openai-work-start]

![Claude's message box in the desktop app, as it looked on 29 October 2026. Under the box, two controls are boxed. On the left, Project or folder, where you choose a folder for Claude. On the right, Auto, the setting you change to Manual. Between them is the model menu.](img/desktop-message-box.png)

![ChatGPT's Work message box in the desktop app, as it looked on 29 October 2026, with its permissions menu open. The menu asks how ChatGPT's actions should be approved. It offers Ask for approval, which is boxed, Approve for me and Full access. The control that opens the menu, set here to Full access, is boxed too.](img/desktop-chatgpt-permissions.png)

## Step 2. Give it a folder, and get finished work back

```text tab="Claude" tab-group="desktop-app"
This step needs a paid Claude plan. On the free plan,
use the ChatGPT tab.

Under the message box, open "Project or folder", and
choose the files folder. Claude can then read, organize
and create files in it.
```

```text tab="ChatGPT" tab-group="desktop-app"
1. Under the message box, open Choose project, and
   choose New project.
2. Give the project a name. Under Source folders, click
   Add, and choose the files folder.
3. Click Create project.
```

Claude reads and writes in the folder you connect.[^anthropic-one-claude] ChatGPT uses the files in the place you choose: a chat, a project or a folder.[^openai-desktop-app]

![ChatGPT's Create project window, as it looked on 29 October 2026. It has a box for the project's name, and under Source folders, the line "Add a folder on this computer" with an Add button, which is boxed. At the bottom is Create project.](img/desktop-chatgpt-create-project.png)

Then send this message.

```text
Read the files in this folder. List this week's invoices
that need the controller's approval under the AP policy,
and save the list in this folder.
```

**What you will see.** The AI shows what it is doing at each step. Claude, in Manual, pauses before it acts, and you choose Allow or Deny.[^anthropic-get-started-tasks] ChatGPT, in Ask for approval, works inside the folder and pauses before it reaches beyond it.[^openai-permissions] When it finishes, a new file is in your folder.

**Check.** Open the new file. It should list three invoices: County Freight 5208 for $6,420.00, County Freight 5214 for $8,400.00, and Maple Paper MPL-1201 for $5,612.90. Each one is over the $5,000.00 limit in line 4.1 of the policy. If the list is different, ask the AI which line of the policy it used.

## Step 3. Let it use a browser

```text tab="Claude" tab-group="desktop-app"
This step needs a paid Claude plan. On the free plan,
use the ChatGPT tab.

In the same conversation, send:

Open claude.com/pricing in the built-in browser,
and tell me what the Pro plan costs.
```

```text tab="ChatGPT" tab-group="desktop-app"
In the same chat, send:

Open chatgpt.com/pricing in the built-in browser,
and tell me what the Plus plan costs.

To open the browser yourself, choose View > Browser,
or press Command, Shift and B (Ctrl, Shift and B on
Windows).

OpenAI does not say if the free plan has this browser.
If the app asks you to upgrade, skip this step.
```

**What you will see.** A browser opens inside the app, next to the chat, and the AI reads the page while you watch. Claude asks for your permission the first time it acts on a site.[^anthropic-builtin-browser] ChatGPT asks before it uses a new website, unless you have already allowed it.[^openai-browser]

**Check.** Compare the AI's answer with the price on the page.

## What stays true

### Is it the same account?

Yes. Each app signs in to the account you already have, so the two choices you made in 0.2.1 still apply. On Claude, the training setting is where it is on the website: Settings, then Privacy.[^anthropic-privacy] OpenAI says its training setting applies to your account when you are signed in.[^openai-data-controls]

### What happens when you close the app?

Claude reaches your folder and the built-in browser only while the app is open.[^anthropic-one-claude] A task that runs in the cloud keeps going, but it cannot reach your files until you open the app again.[^anthropic-surfaces] ChatGPT's steps that use your computer's files also need that computer on and connected.[^openai-work-start]

### Can it delete your files?

Claude always asks before it permanently deletes a file, in any mode.[^anthropic-safely] ChatGPT, in Ask for approval, can change files inside the folder you gave it, so give it only the folder the task needs.[^openai-permissions]

## Which plan has what

> **Anthropic, as verified 28 October 2026, with plan names as of 31 October 2026.**
>
> | In the Claude app | Free plan | Paid plans |
> | --- | --- | --- |
> | The conversation | Yes | Yes |
> | Your folders (Step 2) | No | Yes[^anthropic-desktop-tour] |
> | The built-in browser (Step 3) | No | Pro, Max and Ultra. On Team and Enterprise, unless an owner turns it off[^anthropic-builtin-browser-plans] |
> | Claude Code (Step 4) | No | Yes[^anthropic-install-desktop] |
>
> Every plan can use the app.[^anthropic-download] The single conversation, with no mode to pick, is reaching Pro, Max and Ultra accounts first. If your message box still shows Chat and Cowork options, your account has not moved over yet: choose Cowork for Steps 2 and 3.[^anthropic-get-started-tasks-plans]

> **OpenAI, as verified 29 October 2026.**
>
> | In the ChatGPT app | Free plan | Paid plans |
> | --- | --- | --- |
> | Chat | Yes | Yes |
> | Longer tasks with your folders, which OpenAI calls Work (Step 2) | Some, on the desktop app[^openai-pricing] | Where your plan includes it[^openai-work-codex] |
> | The built-in browser (Step 3) | Not stated. Features may depend on your plan[^openai-browser] | In longer tasks and Codex chats |
> | Codex (Step 4) | Some[^openai-pricing] | Yes |
>
> OpenAI's Windows page still calls that app an early version for paid plans.[^openai-windows-app] If the Windows app asks you to upgrade, use chatgpt.com in your browser.
>
> OpenAI says it is bringing what Work can do into the main ChatGPT experience.[^openai-usage-limits] As of 4 November 2026, its page on the desktop app still describes a switch between Chat and Work,[^openai-moving-desktop] so Step 1 covers both: choose Work if you see the switch, and carry on if you do not.

**The differences that change a setup step.** On the free plan, ChatGPT's app gives some longer tasks and Codex, and Claude's app gives the conversation only. Claude's Manual asks before each action, while ChatGPT's Ask for approval asks only before it goes beyond the folder. Claude's app also runs on Linux, and only Claude's app can use another company's model.

**The invariant.** The names and the plans will change. The desktop app stays the AI's way into your own computer, in the folders you give it, and it asks before the steps you want to see.

## Optional Step 4. Build a page with the coding tool

You can skip this step, and come back to it later. It shows what a coding tool adds: the AI makes something that runs, and opens it for you to check. This week's invoices, as a web page, are a small job to try that on.

```text tab="Claude" tab-group="desktop-app"
This step needs a paid Claude plan.

1. Switch to Code with the </> button at the top left,
   and click New.
2. By the message box, open Choose environment, and add
   a new environment. An environment sets where Claude
   runs and which folder it uses. Keep Local, which
   means your own computer, give it a name, click Add
   under Folders, and choose the same files folder.
   Then click Create environment.
```

```text tab="ChatGPT" tab-group="desktop-app"
1. At the top left, switch from ChatGPT to Codex.
2. Above the message box, open the folder menu, choose
   New project, and add the same files folder.
3. A terminal is a window for typed commands. To see
   it, choose View > Open Terminal. You can skip this.
```

Claude Code is the Code tab, where an environment sets where Claude runs,[^anthropic-code-desktop] and Codex works with folders on your computer, terminals and developer tools.[^openai-work-codex]

![The New environment window in Claude's Code tab, as it looked on 29 October 2026. Local is selected. Under Name is a box for the environment's name. Under Folders, the Add button is boxed: it chooses the folder the session starts in. At the bottom are Cancel and Create environment.](img/desktop-new-environment.png)

Then send this message.

```text
Make a simple web page that shows invoices-this-week.csv
as a table, with the invoices over $5,000 highlighted.
Show it to me in the browser pane.
```

**What you will see.** Claude, in Manual, asks before it edits a file or runs a command, and shows you each change to accept or reject.[^anthropic-code-desktop] Codex, in Ask for approval, works inside the folder and asks before it reaches beyond it.[^openai-permissions] Then the page opens in the app's browser. In Claude Code, three buttons at the top right open its terminal (a window for typed commands), the browser and your files. Its Context card shows how full the context window from 0.1 is, and what fills it.

![The Code tab of the Claude desktop app, as it looked on 29 October 2026. At the top, three buttons are boxed: the terminal, the browser and the files. The browser is open in a pane on the right, with a box to type a web address.](img/desktop-code-tab.png)

**Check.** The three highlighted rows are the same three invoices as in Step 2.

## Optional: the Claude app without a Claude plan

You can skip this section, and come back to it later. It is about the Claude app only. The Claude app can also run on a model from another company. In this mode you need no Claude plan, and you pay that company for what you use.[^anthropic-3p-install] Anthropic's list for this mode includes the folders, Claude Code and the built-in browser that Steps 2 to 4 use.[^anthropic-3p-features] Ollama, with a model on your own Mac, costs nothing.[^ollama-pricing]

### What do you give up?

- **What you type goes to that company,** under its terms.[^anthropic-3p-overview] So the two choices you made in 0.2.1 no longer cover it.
- **The app works on this computer only.** There is no claude.ai and no phone app with it, no sharing and no voice. Your chats are saved on this computer only.[^anthropic-3p-features]
- **Some features may fail.** Anthropic built the mode for organizations, and describes it with Claude models.[^anthropic-3p-overview] DeepSeek does not support attached documents.[^deepseek-anthropic-api] So do the labs in this book's Part 0 on your free account.

### What do you need?

- The Claude desktop app, from [claude.com/download](https://claude.com/download). You do not sign in to Claude for this mode.[^anthropic-3p-install]
- An account with the company you choose, and for OpenRouter and DeepSeek, an API key with credit on it. The key is a secret code that lets the Claude app use your account at that company.
  - OpenRouter: add credit at [openrouter.ai/credits](https://openrouter.ai/credits), then create a key at [openrouter.ai/keys](https://openrouter.ai/keys).[^openrouter-claude-desktop] OpenRouter promises this setup only when Anthropic itself runs the model. So in OpenRouter's [privacy settings](https://openrouter.ai/settings/privacy), allow only Anthropic as a provider.[^openrouter-providers]
  - DeepSeek: sign up on the [DeepSeek Platform](https://platform.deepseek.com/), then create a key on its [API keys page](https://platform.deepseek.com/api_keys).[^deepseek-api-docs] Top up your balance there. DeepSeek takes what you use from it, at the prices on its [pricing page](https://api-docs.deepseek.com/quick_start/pricing).[^deepseek-pricing]
  - Ollama: install [Ollama](https://ollama.com/download/) on your Mac. A model on your own Mac needs no key and no credit.[^ollama-claude-desktop]

> [!WARNING]
> Keep your API key private. Never paste it into a chat, a screenshot or a group message. Anyone who has it can spend your credit.

### How do you set it up with DeepSeek or OpenRouter?

The steps are the same for both, on Windows and macOS. Where a value differs, the step gives both. Have your API key ready before you start.

1. Open the Claude app. Do not sign in.
2. Turn on Developer Mode. On a Mac, in the menu bar at the top of the screen, open Help, then Troubleshooting, and click Enable Developer Mode. On Windows, open the ☰ menu at the top left of the sign-in screen first, then do the same.[^anthropic-3p-in-app] A new menu called Developer appears.
3. Open the Developer menu, and click Configure Third-Party Inference, which means using another company's model. A settings window opens on its Connection page.

   ![The Developer menu of the Claude app, as it looked on 29 October 2026. The menu's name, Developer, is boxed in the menu bar. In the open menu, the item Configure Third-Party Inference is boxed.](img/desktop-developer-menu.png)

4. In the first box on the Connection page, choose Gateway, a service that passes your messages on to a model. Below it is a section called Gateway credentials.
5. Fill in the four boxes in Gateway credentials. Find each box by its name:
   - Credential kind: open it, and choose Static API key.[^anthropic-3p-gateway]
   - Gateway base URL: paste your company's address. For DeepSeek, paste `https://api.deepseek.com/anthropic`.[^deepseek-anthropic-api] For OpenRouter, paste `https://openrouter.ai/api`.[^openrouter-claude-desktop]
   - Gateway API key: paste your API key. An OpenRouter key starts with `sk-or-v1-`.
   - Gateway auth scheme: this sets how the app sends your key. For DeepSeek, choose x-api-key.[^deepseek-anthropic-api] For OpenRouter, choose Bearer.[^openrouter-claude-desktop]

   Leave every other box as it is, including any sign-in (OIDC) boxes. You do not need the other pages on the left.

   ![The Connection page of the Claude app's settings window, as it looked on 29 October 2026, part of the way through a DeepSeek setup. Above, three parts are boxed. The first box is set to Gateway. Credential kind is still empty. Gateway base URL holds https://api.deepseek.com/anthropic. Below is the bar at the bottom of the same window, where two parts are boxed, the message "Connection needs Credential kind" and the Apply Changes button.](img/desktop-gateway-settings.png)

6. Look at the bar at the bottom of the window. If it names a box, as in "Connection needs Credential kind", that box is still empty, so fill it in. Then click Apply Changes. The app restarts.[^anthropic-3p-in-app]
7. On the start screen, choose Continue with Gateway. If you do not see it, quit the app fully, not just its window, and open it again.[^openrouter-claude-desktop]
8. Pick a model from the model menu, and send a short message, such as "Hello".

With DeepSeek, the model menu may show Claude's names. Then Opus means DeepSeek V4 Pro, and Sonnet and Haiku mean DeepSeek Flash.[^deepseek-anthropic-api]

**To change a setting later,** such as a wrong key, turn on Developer Mode again, as in step 2. The Developer menu goes away when the app restarts into this mode, and after you turn it on a second time, it stays.[^anthropic-3p-in-app]

### How do you set it up with Ollama?

Ollama connects the Claude app for you, on a Mac only. Ollama says Windows support is coming.[^ollama-claude-desktop]

1. In Ollama, download a model to your Mac. For a cloud model instead, sign in to Ollama and turn on cloud models. Some cloud models need a paid Ollama plan.
2. In Ollama, open Apps, and choose Connect Claude.
3. Follow the prompts. They install Claude if you need it, and ask you to restart it.
4. To change the model later, open Ollama's Settings, then Apps, choose your models, and click Restart Claude.

**To check it worked,** send one short message, then find its charge on the company's usage page. **To go back,** choose the Anthropic sign-in on the start screen.[^anthropic-3p-install] With Ollama, disconnect Claude in Ollama's Apps, or quit Ollama.[^ollama-claude-desktop]

[^anthropic-install-desktop]: Install Claude Desktop, Claude Help Center.
[^anthropic-download]: Download Claude, Claude.
[^anthropic-one-claude]: Claude Cowork and chat are one Claude, Claude Help Center.
[^anthropic-get-started-tasks]: Get started with Claude Cowork, Claude Help Center.
[^anthropic-get-started-tasks-plans]: Get started with Claude Cowork, Claude Help Center, accessed 31 October 2026.
[^anthropic-surfaces]: Use Claude Cowork on web, desktop, and mobile, Claude Help Center.
[^anthropic-safely]: Use Claude Cowork safely, Claude Help Center.
[^anthropic-builtin-browser]: Use the built-in browser in Claude Cowork, Claude Help Center.
[^anthropic-builtin-browser-plans]: Use the built-in browser in Claude Cowork, Claude Help Center, accessed 31 October 2026.
[^anthropic-code-desktop]: Claude Code Desktop, Claude Code documentation.
[^anthropic-desktop-tour]: Navigating the Claude desktop app, Anthropic Academy.
[^anthropic-privacy]: How do I change my model improvement privacy settings?, Anthropic Privacy Center.
[^openai-macos-app]: Downloading the ChatGPT macOS app, OpenAI Help Center.
[^openai-windows-app]: Using the ChatGPT Windows app, OpenAI Help Center.
[^openai-work-codex]: ChatGPT Work and Codex, OpenAI Help Center.
[^openai-usage-limits]: Understanding ChatGPT and Codex usage limits, OpenAI Help Center.
[^openai-work-start]: Get started with ChatGPT Work, ChatGPT Learn.
[^openai-desktop-app]: ChatGPT desktop app, ChatGPT Learn.
[^openai-permissions]: Permissions, ChatGPT Learn.
[^openai-browser]: Using the built-in browser in the ChatGPT desktop app, OpenAI Help Center.
[^openai-pricing]: Plans and Pricing, ChatGPT.
[^openai-data-controls]: Data controls in ChatGPT, OpenAI Help Center.
[^anthropic-3p-overview]: Overview, Claude Desktop on third-party platforms, Claude documentation.
[^anthropic-3p-features]: Features, Claude Desktop on third-party platforms, Claude documentation.
[^anthropic-3p-install]: Installation and setup, Claude Desktop on third-party platforms, Claude documentation.
[^anthropic-3p-gateway]: Deploy Claude Desktop on 3P with an LLM gateway, Claude documentation.
[^anthropic-3p-in-app]: In-app configuration, Claude Desktop on third-party platforms, Claude documentation.
[^openrouter-claude-desktop]: Claude Desktop integration, OpenRouter documentation.
[^openrouter-providers]: Provider selection, OpenRouter documentation.
[^deepseek-api-docs]: Your first API call, DeepSeek API documentation.
[^deepseek-pricing]: Models & Pricing, DeepSeek API documentation.
[^deepseek-anthropic-api]: Anthropic API, DeepSeek API documentation.
[^ollama-claude-desktop]: Use Ollama models in Claude on macOS, Ollama documentation.
[^ollama-pricing]: Pricing, Ollama.
[^openai-moving-desktop]: Moving to the new ChatGPT desktop app, OpenAI Help Center.
