

作为 Anthropic 官方推出的命令行编码助手（coding assistant），Claude Code 本质上是一个通过大模型（LLM）执行复杂任务的工具。通常情况下，它需要连接云端 API。但随着 Ollama 宣布兼容 Anthropic Messages API，我们现在可以轻松地将 Claude Code 与本地模型集成。

从工程角度看，使用本地的模型既可以作为断网情况下的一种保障方案，也可以在不改变工作流程的情况下，把本地模型作为一个测试开发环境，极大节省 Token 开销。

## 操作步骤

1.安装 Claude Code 和 Ollama

```
npm install -g @anthropic-ai/claude-code@latest
```

Ollama 可以通过官网https://ollama.com/下载安装包安装。

> 注意：Ollama 版本v0.14.0+，Claude Code版本v2.1.12+，可以通过下面命令验证

```bash
claude --version
ollama --version
```

Ollama 安装后会自动作为后台服务运行。应该可以在 http://localhost:11434 上看到它运行。

2.下载大模型

可以通过 Ollama 的 WebUI 页面直接下载，如下图。

![下载模型到本地](https://developer.qcloudimg.com/http-save/yehe-2615134/39fa24803d3726736bbc2a4c04e7d663.png)

也可以通过命令行快速拉取适合编码的模型。

```bash
#查看本地模型
ollama list

#下载新模型
ollama pull qwen2.5-coder:7b

#删除模型
ollama rm qwen2.5-coder:7b

#查看模型基本参数
ollama show qwen2.5-coder:7b
```

3.配置 Claude Code 连接本地 Ollama

```bash
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434
# 启动 Claude Code 并指定本地模型
claude --model qwen2.5-coder:7b

# 如果想使用云端模型，命令类似
claude --model glm-4.6:cloud
```

![使用本地模型](https://developer.qcloudimg.com/http-save/yehe-2615134/3d081610f81ffbd82e03f0b1235226e6.png)

> 注意：如果你开启了系统代理，可能会遇到 `API Error: Connection error`。这是因为流量被转发到了代理服务器而找不到 localhost。请先在终端执行：

```bash
unset https_proxy
unset http_proxy
```

4.使用Anthropic SDK

如果我们想更精准的把控程序的执行流程，可以使用官方的 SDK。

```python
import anthropic
import httpx
http_client = httpx.Client(
    proxy=None,
    trust_env=False,
)

client = anthropic.Anthropic(
    base_url='http://localhost:11434',
    api_key='ollama',
    http_client=http_client,

)

with client.messages.stream(
    model='qwen2.5-coder:7b',
    max_tokens=1024,
    messages=[{'role': 'user', 'content': 'Count from 1 to 10'}]
) as stream:
    for text in stream.text_stream:
        print(text, end='', flush=True)
```

## 调试秘籍：如何与 AI 高效沟通报错？

这里再说一个调试的技巧：在配置过程中，不要死磕枯燥的错误堆栈信息。一个高效的调试技巧是：**向 AI 描述你的完整环境和所做的工作，而不仅仅是报错代码。**

此前我按照文档编写代码时，一直遇到 `InternalServerError (503)` 错误。我直接把错误代码粘贴给 chatgpt ，它尝试了很多方法但始终没有解决。

```bash
Traceback (most recent call last):
  File "/Users/shaoyang/Project/stock_demo/day09/anthropic-demo.py", line 12, in <module>
    message = client.messages.create(
  File "/Users/shaoyang/Project/stock_demo/.venv/lib/python3.10/site-packages/anthropic/_utils/_utils.py", line 282, in wrapper
    return func(*args, **kwargs)
  File "/Users/shaoyang/Project/stock_demo/.venv/lib/python3.10/site-packages/anthropic/resources/messages/messages.py", line 932, in create
    return self._post(
  File "/Users/shaoyang/Project/stock_demo/.venv/lib/python3.10/site-packages/anthropic/_base_client.py", line 1361, in post
    return cast(ResponseT, self.request(cast_to, opts, stream=stream, stream_cls=stream_cls))
  File "/Users/shaoyang/Project/stock_demo/.venv/lib/python3.10/site-packages/anthropic/_base_client.py", line 1134, in request
    raise self._make_status_error_from_response(err.response) from None
anthropic.InternalServerError: Error code: 503
```

于是，我换了一种思路，不是直接粘贴错误代码，而是前置一步，客观地描述了一下当前的环境。

``` bash
import anthropic

client = anthropic.Anthropic(
    base_url='http://localhost:11434',
    api_key='ollama',  # required but ignored
)

message = client.messages.create(
    model='qwen3-coder',
    max_tokens=1024,
    messages=[
        {'role': 'user', 'content': 'Hello, how are you?'}
    ]
)
print(message.content[0].text)

我是用的是mac电脑，本地配置了代理，我应该如何修改上面的代码保证可以运行。

js版本是可以执行的
import Anthropic from "@anthropic-ai/sdk";

const anthropic = new Anthropic({
  baseURL: "http://localhost:11434",
  apiKey: "ollama", // required but ignored
});

const message = await anthropic.messages.create({
  model: "minimax-m2:cloud",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "写一个求和的 python 函数" }
  ],
});

console.log(message.content[1].text);
```

chatgpt立刻就发现了问题，并给到我正确的执行代码。

![ChatGPT 的回复](https://developer.qcloudimg.com/http-save/yehe-2615134/7fab179f1af5758da4a9972435aea0ec.png)

根据这次调试过程，大模型也帮我总结一个更有效的提问模板：

```bash
1.贴出当前代码。

2.描述环境（如：Mac 系统、本地有代理）。

3.提供一个对比参照（如：JS 版本可以运行，Python 不行）。
```



作为 Anthropic 官方推出的命令行编码助手（coding assistant），Claude Code 本质上是一个通过大模型（LLM）执行复杂任务的工具。通常情况下，它需要连接云端 API。但随着 Ollama 宣布兼容 Anthropic Messages API，我们现在可以轻松地将 Claude Code 与本地模型集成。

Claude Code 完美接入 Ollama 指南

人工智能

开发工具

后端

ClaudeCode是Anthropic推出的命令行编码助手，结合Ollama可连接本地大模型，实现离线开发环境。本文详细讲解安装配置步骤：安装ClaudeCode和Ollama、下载模型、配置本地连接、使用SDK控制流程，并分享高效调试技巧。本地模型方案可节省Token成本，保障断网开发。

服务器

Python

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 完美接入 Ollama 指南-腾讯云开发者社区-腾讯云

Claude Code 完美接入 Ollama 指南

Claude Code 完美接入 Ollama 指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐