mirror of
https://github.com/ollama/ollama.git
synced 2026-10-20 10:31:39 +00:00
docs: add ChatGPT Desktop integration (#18377)
This commit is contained in:
parent
f093c6e008
commit
2d26fafc42
5 changed files with 53 additions and 84 deletions
|
|
@ -96,6 +96,14 @@
|
|||
"source": "/integrations/clawdbot",
|
||||
"destination": "/integrations/openclaw"
|
||||
},
|
||||
{
|
||||
"source": "/integrations/codex-app",
|
||||
"destination": "/integrations/chatgpt"
|
||||
},
|
||||
{
|
||||
"source": "/integrations/codex-app.mdx",
|
||||
"destination": "/integrations/chatgpt"
|
||||
},
|
||||
{
|
||||
"source": "/integrations/poolside",
|
||||
"destination": "/integrations/pool"
|
||||
|
|
@ -171,8 +179,8 @@
|
|||
"/integrations/opencode",
|
||||
"/integrations/deepseek-harness",
|
||||
"/integrations/cline-cli",
|
||||
"/integrations/codex-app",
|
||||
"/integrations/codex",
|
||||
"/integrations/chatgpt",
|
||||
"/integrations/copilot-cli",
|
||||
"/integrations/droid",
|
||||
"/integrations/goose",
|
||||
|
|
|
|||
39
docs/integrations/chatgpt.mdx
Normal file
39
docs/integrations/chatgpt.mdx
Normal file
|
|
@ -0,0 +1,39 @@
|
|||
---
|
||||
title: ChatGPT Desktop
|
||||
description: Use Ollama models in ChatGPT Desktop.
|
||||
---
|
||||
|
||||
ChatGPT Desktop includes Codex, OpenAI's desktop coding agent. Ollama adds compatible local and cloud models to Codex's model picker alongside ChatGPT's native models.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Ollama v0.34.0 or newer
|
||||
|
||||
If ChatGPT is not installed, Ollama offers to download it during setup.
|
||||
|
||||
## Connect ChatGPT
|
||||
|
||||
1. Open the Ollama desktop app and select **Apps**.
|
||||
2. Toggle **ChatGPT (Desktop)** to On.
|
||||
3. Follow the setup prompts. If ChatGPT is already open, Ollama asks to restart it before the new models appear.
|
||||
4. Open the ChatGPT desktop app and use Codex mode.
|
||||
|
||||
## Choose models
|
||||
|
||||
Open Ollama **Settings**, select **Apps**, then select ChatGPT. Choose up to five compatible local or cloud models and save your changes. Ollama asks to restart ChatGPT when a model change needs one.
|
||||
|
||||
## Disconnect ChatGPT
|
||||
|
||||
Open Ollama **Apps** and turn ChatGPT off. Ollama restores ChatGPT's connection settings and usual profile. If ChatGPT is open, Ollama asks to restart it so the change takes effect.
|
||||
|
||||
## Codex behavior and limits
|
||||
|
||||
- Only requests made with an Ollama model go to Ollama. ChatGPT's native models keep using their usual provider.
|
||||
- Ollama models are for Codex mode. Regular Chat and voice keep using their usual ChatGPT connection.
|
||||
- Codex manages sessions. Ollama routes model requests and compaction when Codex asks for it, but does not store ChatGPT sessions.
|
||||
- Web search uses Ollama's web-search service when you use an Ollama model. It requires Ollama sign-in and is limited to three calls per response.
|
||||
|
||||
## Related integrations
|
||||
|
||||
- Use Codex from a terminal with [Codex CLI](/integrations/codex).
|
||||
- Connect other desktop apps from [Claude Desktop](/integrations/claude-desktop).
|
||||
|
|
@ -1,82 +0,0 @@
|
|||
---
|
||||
title: Codex App
|
||||
---
|
||||
|
||||
Codex App is OpenAI's desktop coding agent for macOS and Windows. Ollama configures the app to use Ollama's OpenAI-compatible endpoint, so Codex can work with local models and Ollama Cloud models in the desktop app.
|
||||
|
||||
<img
|
||||
src="/images/codex-app-home.png"
|
||||
alt="Codex App with Ollama selected"
|
||||
style={{ borderRadius: "12px" }}
|
||||
/>
|
||||
|
||||
## Install
|
||||
|
||||
Install the [Codex App](https://developers.openai.com/codex/quickstart/) for macOS or Windows.
|
||||
|
||||
<Note>Codex App support is available in Ollama v0.24.0 and newer.</Note>
|
||||
|
||||
|
||||
## Quick setup
|
||||
|
||||
```shell
|
||||
ollama launch codex-app
|
||||
```
|
||||
|
||||
Once Codex App opens, start a task or open a repository as usual.
|
||||
|
||||
## Built-in browser
|
||||
|
||||
Codex App can open local servers and sites in its built-in browser. Annotate directly on the page to request changes.
|
||||
|
||||
<img
|
||||
src="/images/codex-app-annotate.png"
|
||||
alt="Codex App browser annotations"
|
||||
style={{ borderRadius: "12px" }}
|
||||
/>
|
||||
|
||||
## Review mode
|
||||
|
||||
Use review mode to inspect code changes, leave comments, and iterate on fixes without leaving the app.
|
||||
|
||||
<img
|
||||
src="/images/codex-app-review.png"
|
||||
alt="Codex App review comments"
|
||||
style={{ borderRadius: "12px" }}
|
||||
/>
|
||||
|
||||
### Run directly with a model
|
||||
|
||||
```shell
|
||||
ollama launch codex-app --model kimi-k2.6:cloud
|
||||
```
|
||||
|
||||
Use a local model by passing its model name:
|
||||
|
||||
```shell
|
||||
ollama launch codex-app --model gemma4:31b
|
||||
```
|
||||
|
||||
Running `ollama launch codex-app` is persistent and will have your model selected next time you open Codex.
|
||||
|
||||
|
||||
### Restore Codex App
|
||||
|
||||
To switch Codex App back to the profile you were using before `ollama launch codex-app`, run:
|
||||
|
||||
```shell
|
||||
ollama launch codex-app --restore
|
||||
```
|
||||
|
||||
Ollama restores Codex App's settings and configs. If Codex App is open, Ollama asks before restarting it.
|
||||
|
||||
|
||||
The Codex CLI profile managed by `ollama launch codex` is left separate from the Codex App profile.
|
||||
|
||||
Before overwriting Codex App config files, Ollama Launch saves backups under `~/.ollama/backup/codex-app/`. On Windows, `~` resolves to your user profile directory.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If Codex App does not open after setup, open Codex manually once and run `ollama launch codex-app` again.
|
||||
|
||||
If Codex App is already running and does not switch models, allow Ollama to restart it when prompted, or quit Codex App and run `ollama launch codex-app` again.
|
||||
|
|
@ -5,7 +5,7 @@ title: Codex CLI
|
|||
|
||||
## Install
|
||||
|
||||
Install the [Codex CLI](https://developers.openai.com/codex/cli/). For the desktop app, see [Codex App](/integrations/codex-app).
|
||||
Install the [Codex CLI](https://developers.openai.com/codex/cli/). For the ChatGPT desktop app, see [ChatGPT Desktop](/integrations/chatgpt).
|
||||
|
||||
```
|
||||
npm install -g @openai/codex
|
||||
|
|
|
|||
|
|
@ -32,6 +32,10 @@ Use open models in assistant apps.
|
|||
Desktop assistant with local and cloud Ollama models.
|
||||
</Card>
|
||||
|
||||
<Card title="ChatGPT" href="/integrations/chatgpt">
|
||||
Use Ollama models in Codex inside ChatGPT Desktop.
|
||||
</Card>
|
||||
|
||||
<Card title="OpenClaw" icon="/images/launch-icons/openclaw.svg" href="/integrations/openclaw">
|
||||
Personal assistant for messaging apps and everyday tasks.
|
||||
</Card>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue