用 Ollama 跑 Claude Code：Anthropic API 兼容上手
难度：入门 · 来源：Ollama Blog · 采集于：2026-11-05
你将学到什么
- 把 Claude Code 这个终端里的智能体编程工具，接到本地 Ollama 或 ollama.com 云端模型上运行。
- 用两个环境变量完成 Anthropic API 兼容配置，并挑选适合写代码的模型。
- 让已有的 Anthropic SDK 应用（Python / JavaScript）只改 base URL 就切换到 Ollama。
前置条件
- Ollama v0.14.0 或更高版本（Anthropic Messages API 兼容从该版本开始提供）。
- 已安装 Claude Code，或按下方命令安装。
- 本地跑模型时建议模型上下文长度至少 32K tokens，可按 Ollama 上下文长度文档调整；Ollama 云端模型始终以完整上下文长度运行。
步骤
- 安装 Claude Code。按平台选择对应命令：
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell：
irm https://claude.ai/install.ps1 | iex
Windows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
- 配置环境变量，把 Claude Code 指向 Ollama：
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434
- 指定模型启动 Claude Code。本地模型示例：
claude --model gpt-oss:20b
也可以用 Ollama 云端模型：
claude --model glm-4.7:cloud
-
按用途选模型。官方针对 Claude Code 的编码场景推荐：本地
gpt-oss:20b、qwen3-coder；云端glm-4.7:cloud、minimax-m2.1:cloud。 -
如果已有基于 Anthropic SDK 的应用，只需改 base URL 即可连到 Ollama。Python：
import anthropic
client = anthropic.Anthropic(
base_url='http://localhost:11434',
api_key='ollama', # required but ignored
)
message = client.messages.create(
model='qwen3-coder',
messages=[
{'role': 'user', 'content': 'Write a function to check if a number is prime'}
]
)
print(message.content[0].text)
JavaScript：
import Anthropic from '@anthropic-ai/sdk'
const anthropic = new Anthropic({
baseURL: 'http://localhost:11434',
apiKey: 'ollama',
})
const message = await anthropic.messages.create({
model: 'qwen3-coder',
messages: [{ role: 'user', content: 'Write a function to check if a number is prime' }],
})
console.log(message.content[0].text)
- 需要让模型调用外部系统时，用
tools参数声明工具（名称、描述、input_schema），再遍历返回内容里的tool_use块读取工具名与入参。
for block in message.content:
if block.type == 'tool_use':
print(f'Tool: {block.name}')
print(f'Input: {block.input}')
- 确认当前兼容层支持的能力范围：多轮 Messages 对话、流式输出、系统提示词、工具调用 / 函数调用、扩展思考、视觉（图像输入）。完整清单见 Ollama 的 Anthropic 兼容文档。
常见坑/注意事项
- 版本门槛：必须是 Ollama v0.14.0 及以后，低版本没有 Anthropic Messages API 兼容。
api_key='ollama'在 SDK 里是必填但会被忽略，不要以为要填真实密钥。- 本地模型的上下文长度默认可能不足，官方建议至少 32K tokens，需按上下文长度文档自行调整；云端模型不受此限制。
- 云端模型和本地模型走同一个 base URL 配置，区别只在
--model指定的模型名（云端带:cloud后缀）。 - 更多配置项与详细步骤可查 Ollama 的 Claude Code 集成指南与 Anthropic 兼容文档。
原文链接：https://ollama.com/blog/claude
原文：Claude Code with Anthropic API compatibility January 16, 2026 Ollama is now compatible with the Anthropic Messages API,（本文为采集智能体整理的导读，版权归原作者，请阅读原文获取完整内容）
评论（1）