library/docs-ollama
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync ollama docs from eab97e9f on 2026-10-12

Browse Source
This commit is contained in:
The Librarian
2026-10-12 04:00:05 +00:00
parent f10d4bfbcc
commit a8b97b807a
26 changed files with 1820 additions and 782 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/integrations/chatgpt.mdx
+39
View 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).
docs/integrations/claude-code.mdx
+18 -1
View File
@@ -2,7 +2,7 @@
title: Claude Code
---
[Claude Code](https://code.claude.com/docs/en/overview) is an agentic coding tool that reads your codebase, edits files, and runs commands.
[Claude Code](https://code.claude.com/docs/en/overview) reads your codebase, edits files, and runs commands.
Ollama connects Claude Code to local and cloud models through its Anthropic-compatible API.
@@ -155,6 +155,23 @@ Claude Code prompts for permission on most actions. To allow the bot to work aut
See the [plugin README](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) for setup instructions.
## Connect directly to Ollama Cloud
Install Claude Code, then set your [API key](/quickstart#build-an-application) in `OLLAMA_API_KEY`. No Ollama installation required.
In Bash or Zsh, run:
```shell
ANTHROPIC_BASE_URL=https://ollama.com \
ANTHROPIC_AUTH_TOKEN="$OLLAMA_API_KEY" \
ANTHROPIC_API_KEY="" \
claude --model glm-5.3-flash
```
Use `ANTHROPIC_AUTH_TOKEN` for bearer authentication. Claude settings can override shell variables. Update any base URL or credentials in those settings, then run `/status` to check the connection.
Choose a [cloud model](https://ollama.com/search?c=cloud) that supports tools. Basic chat and file edits work with compatible models. Hosted WebSearch and advanced tool controls are not fully supported. See [Anthropic compatibility](/api/anthropic-compatibility).
## Manual setup
<p className="manual-step-title">1. Install Claude Code</p>
docs/integrations/claude-desktop.mdx
+5 -5
View File
@@ -7,7 +7,7 @@ description: Use Ollama models in Claude on macOS.
## Prerequisites
- [Ollama](https://ollama.com/download/). Windows support coming soon.
- To use a local model, [download it](/quickstart#3-start-a-chat) before setup.
- To use a local model, [download it](/quickstart#run-a-model-locally) before setup.
- To use a cloud model, sign in to Ollama and enable cloud models. Some models require a [paid plan](https://ollama.com/pricing).
If Claude is not installed, Ollama offers to download it during setup.
@@ -15,12 +15,12 @@ If Claude is not installed, Ollama offers to download it during setup.
## Set up Claude
1. Open Ollama and select **Apps**.
2. Toggle Claude to On.
3. If Claude is not installed, Ollama will download and finish the installation.
2. Connect **Claude**.
3. Follow the setup prompts to install Claude if needed and restart it when prompted.
## Switch models
Open Ollama **Settings**. Under **Apps**, choose a model you want to use, then select **Restart Claude**. You can assign the same Ollama model to more than one option.
Open Ollama **Settings → Apps**. Choose your models, then select **Restart Claude**. You can use the same model for more than one option.
## Supported features
@@ -31,7 +31,7 @@ Open Ollama **Settings**. Under **Apps**, choose a model you want to use, then s
## Disconnect Claude
Open Ollama **Apps** and turn Claude off. Ollama restores Claude's previous configuration. If Claude is open, Ollama asks to restart it so the change takes effect.
Open Ollama **Apps** and disconnect Claude. Ollama restores Claude's previous settings. Restart Claude when prompted.
You can also restore Claude from the terminal:
docs/integrations/cline.mdx
+3 -4
View File
@@ -13,7 +13,7 @@ Install [Cline](https://docs.cline.bot/getting-started/installing-cline) in your
2. Select a model under `Model` or type one (e.g. `qwen3`)
3. Update the context window to at least 32K tokens under `Context Window`
<Note>Coding tools require a larger context window. It is recommended to use a context window of at least 32K tokens. See [Context length](/context-length) for more information.</Note>
<Note>Use a [context window](/context-length) of at least 32K tokens for coding.</Note>
<div style={{ display: 'flex', justifyContent: 'center' }}>
<img
@@ -32,7 +32,6 @@ Install [Cline](https://docs.cline.bot/getting-started/installing-cline) in your
4. Select a model from the list
### Recommended Models
### Models
- `qwen3-coder:480b`
- `deepseek-v3.1:671b`
Choose a [cloud model](https://ollama.com/search?c=cloud) that supports tool calling.
docs/integrations/codex-app.mdx
-82
View File
@@ -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.
docs/integrations/codex.mdx
+3 -3
View File
@@ -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
@@ -13,7 +13,7 @@ npm install -g @openai/codex
## Usage with Ollama
<Note>Codex requires a larger context window. It is recommended to use a context window of at least 64k tokens.</Note>
<Note>Use a context window of at least 64k tokens for Codex.</Note>
### Quick setup
@@ -77,7 +77,7 @@ Then run:
codex --profile ollama-launch
```
## Web search
## Web search through local Ollama
Codex web-search requests sent through the Ollama profile are executed by
Ollama for both local and cloud models. Sign in with `ollama signin` to use the
docs/integrations/index.mdx
+23 -16
View File
@@ -2,51 +2,58 @@
title: Overview
---
Use Ollama from coding agents, personal assistants, and editors.
Use Ollama models in your apps and tools.
Run `ollama launch` to see the latest integrations you can run from the terminal.
## Code in the terminal
## Launch a coding agent
Run `ollama launch` in a terminal to choose a coding agent.
<CardGroup cols={2}>
<Card title="Claude Code" icon="/images/launch-icons/claude-code.svg" href="/integrations/claude-code">
Terminal coding agent with tools, vision, web search, and long context.
Read code, edit files, and run commands.
</Card>
<Card title="OpenCode" icon="/images/launch-icons/opencode.svg" href="/integrations/opencode">
Open-source coding agent that edits, runs, and iterates on code.
Edit and run code from your terminal.
</Card>
<Card title="DeepSeek Harness" icon="/images/launch-icons/deepseek-harness.svg" href="/integrations/deepseek-harness">
DeepSeek's open-source agent harness with subagents and web search.
Use DeepSeek's open-source coding agent in your browser.
</Card>
</CardGroup>
## Connect an assistant
## Connect a desktop app
Use open models in assistant apps.
On macOS, open the [Ollama app](https://ollama.com/download) and select **Apps** in the sidebar. Connect Claude or ChatGPT.
<CardGroup cols={2}>
<Card title="Claude" href="/integrations/claude-desktop">
Desktop assistant with local and cloud Ollama models.
<Card title="Claude Desktop" icon="/images/launch-icons/claude.svg" href="/integrations/claude-desktop">
Use local and cloud Ollama models.
</Card>
<Card title="ChatGPT Desktop" icon="/images/launch-icons/chatgpt.svg" href="/integrations/chatgpt">
Use Ollama models in Codex mode.
</Card>
</CardGroup>
## Run a personal assistant
Run `ollama launch` in a terminal and choose OpenClaw or Hermes Agent.
<CardGroup cols={2}>
<Card title="OpenClaw" icon="/images/launch-icons/openclaw.svg" href="/integrations/openclaw">
Personal assistant for messaging apps and everyday tasks.
Chat with an assistant through your messaging apps.
</Card>
<Card title="Hermes Agent" icon="/images/launch-icons/hermes-agent.svg" href="/integrations/hermes">
Open-source agent with self-improving skills, memory, and messaging.
Personal assistant with memory, reusable skills, and messaging.
</Card>
</CardGroup>
## Work in your editor
Use Ollama models inside your editor.
<CardGroup cols={2}>
<Card title="VS Code" icon="/images/launch-icons/vscode.svg" href="/integrations/vscode">
Use Ollama models in VS Code Chat.
Install the Ollama extension to use models in VS Code Chat.
</Card>
</CardGroup>