Skip to content

Document Claude Code integration for Docker Model Runner #24243

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dvdksn merged 8 commits into from
Mar 14, 2026
Merged

Document Claude Code integration for Docker Model Runner #24243

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
aa97292
add Claude Code
tfenster Feb 28, 2026
6e097cb
add language
tfenster Feb 28, 2026
caa8626
fix reviewdog flags
tfenster Feb 28, 2026
a217ea3
implement docker-agent suggestions
tfenster Mar 2, 2026
f74cfdb
add notes on persistent env variable and different API
tfenster Mar 12, 2026
3effbf5
Merge branch 'main' of https://github.com/tfenster/docs
tfenster Mar 12, 2026
b45e088
extend front matter
tfenster Mar 12, 2026
4cf51cc
fix model
tfenster Mar 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 32 additions & 1 deletion content/manuals/ai/model-runner/ide-integrations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: IDE and tool integrations
description: Configure popular AI coding assistants and tools to use Docker Model Runner as their backend.
weight: 40
keywords: Docker, ai, model runner, cline, continue, cursor, vscode, ide, integration, openai, ollama
keywords: Docker, ai, model runner, cline, continue, cursor, vscode, ide, integration, openai, ollama, claude, anthropic, claude-code
---

Docker Model Runner can serve as a local backend for popular AI coding assistants
Expand Down Expand Up @@ -258,6 +258,37 @@ print(response.text)

You can find more details in [this Docker Blog post](https://www.docker.com/blog/opencode-docker-model-runner-private-ai-coding/)

## Claude Code

[Claude Code](https://claude.com/product/claude-code) is [Anthropic's](https://www.anthropic.com/) command-line tool for agentic coding. It lives in your terminal, understands your codebase, and executes routine tasks, explains complex code, and handles Git workflows through natural language commands.

### Configuration

1. Install Claude Code (see [docs](https://code.claude.com/docs/en/quickstart#step-1-install-claude-code))
2. Use the `ANTHROPIC_BASE_URL` environment variable to point Claude Code at DMR. On Mac or Linux, you can do this, for example if you want to use the `gpt-oss:32k` model:
```bash
ANTHROPIC_BASE_URL=http://localhost:12434 claude --model qwen2.5-coder
```
On Windows (PowerShell) you can do it like this:
```powershell
$env:ANTHROPIC_BASE_URL="http://localhost:12434"
claude --model gpt-oss:32k
```

> [!TIP]
>
> To avoid setting the variable each time, add it to your shell profile (`~/.bashrc`, `~/.zshrc`, or equivalent):
>
> ```shell
> export ANTHROPIC_BASE_URL=http://localhost:12434
> ```

You can find more details in [this Docker Blog post](https://www.docker.com/blog/run-claude-code-locally-docker-model-runner/)

> [!NOTE]
>
> While the other integrations on this page use the [OpenAI-compatible API](/ai/model-runner/api-reference/#openai-compatible-api), DMR also exposes a [Anthropic-compatible API](/ai/model-runner/api-reference/#anthropic-compatible-api) used here.

## Common issues

### "Connection refused" errors
Expand Down