世界从未停止变化。RSS
BIG CHANGE.
BIG CHANGE，一触即达
BIG CHANGE，一触即达

纵览全局。

将 BIG CHANGE 添加到主屏幕或桌面。它会在独立窗口中打开，并在您在线时显示最新报道。

iPhone 和 iPad
在 Safari 中打开 bigchange.ai。轻点“共享”，然后轻点“添加到主屏幕”。如果显示“作为网页 App 打开”，请将其开启，然后轻点“添加”。
Android
在 Chrome 中打开 bigchange.ai。打开浏览器菜单，选择“安装应用”或“添加到主屏幕”。
桌面设备
在 Chrome 或 Edge 中，使用地址栏中的安装图标或浏览器的应用菜单。在 Mac 上的 Safari 中，选择“文件”→“添加到程序坞”。

Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# 用本地 Ollama 模型完成并核实一次 Claude Code 代码修改

> 本指南依据官方文档，说明如何把 Claude Code 连接到本地 Ollama 模型，核对端点和上下文，再用原验收检查审查一次仓库修改。

By BIG CHANGE Editorial

Published: 2026-10-20T11:36:37.990Z
Updated: 2026-10-20T11:36:37.990Z
Canonical: https://bigchange.ai/blog/claude-code-local-ollama-checked-change-guide

![Conceptual charcoal illustration of an open desktop workstation showing its fan, memory modules, graphics card and internal cables.](https://bigchange.ai/api/media/file/local-model-workstation-open-chassis-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code 可以通过本机 Ollama 提供的模型处理获授权的仓库。Ollama 当前的[Claude Code 集成](https://docs.ollama.com/integrations/claude-code)可直接连接其兼容 Anthropic 的 API。本指南将一次限定范围的代码修改，从记录初始状态推进到由人判断 diff。适合有权安装两款工具、批准仓库修改，并能运行合适本地编程模型的开发者。BIG CHANGE 于 2026 年 10 月 20 日核查手册；我们没有运行模型或测试仓库。

## 关键变化

- **发生了什么变化：**Ollama 现已记录 Claude Code 直接连接本地 Anthropic 兼容服务器的方法，可用启动器或明确的本地端点设置。该文档方案不需要独立代理。
- **为何重要：**你可以保留 Claude Code 工作方式，同时选择本地模型、检查实际分配的上下文，并用项目原验收检查审查一次真实仓库修改。
- **需要注意：**选中本地标签、看到模型运行，不代表每个请求都留在本地，也不代表代码正确。接受修改前须核实实际路由、工具权限、完整 diff 和检查结果。

### 1. 记录仓库初始状态

在自己拥有或获准修改的 Git 仓库工作。使用可供审查的分支或可丢弃的工作副本。指定一个要改的小行为或缺陷、可影响的文件和停止条件。找到仓库已有的验收命令，例如文档规定的测试或构建检查，不要改用通用命令。应在代理修改任何内容**之前**运行它，并记录命令、退出状态和相关输出。同时记录分支、`git status`以及已有 diff。原有修改属于初始状态，不是 AI 结果。

确认组织的代码和依赖政策允许所选模型与工具。Claude Code 可按其生效权限读取文件和执行命令。“只改这些文件”的要求可以引导代理，但不会限制其文件系统访问能力。

### 2. 安装适合的本地模型并分配上下文

根据官方说明安装当前的 [Ollama 版本](https://docs.ollama.com/quickstart)和 [Claude Code CLI](https://code.claude.com/docs/en/setup)，并遵守设备及组织规则。记录 `ollama --version`和 `claude --version`。Ollama 于 2026 年 1 月在 0.14.0 版引入 Anthropic Messages 兼容性；该日期**不能**确定当前 `ollama launch`命令的最低版本。

选择当前模型目录条目注明支持工具、许可允许使用，且模型权重**与上下文分配**都适合设备的模型。一个具体的本地例子是 [qwen3-coder:30b](https://ollama.com/library/qwen3-coder:30b)，条目注明工具支持、约 19 GB 的 Q4\_K\_M 文件及 Apache License 2.0。这是下载大小，不是 RAM 或 VRAM 要求。宣传的模型上下文不代表设备能分配那么多。若不适合，请改选有文档依据、支持工具的其他本地标签，并在后续所有命令中一致替换。

Ollama 应用或本地服务器运行后，在终端下载并核对准确标签：

```text
ollama pull qwen3-coder:30b
ollama list
```

Ollama [建议至少 64,000 个 token](https://docs.ollama.com/context-length)用于编程代理，并说明更大的上下文需要更多内存。硬件支持时，在**现有 Ollama 应用的设置**中设为 64k 或更大。如果服务器由你管理，应按`OLLAMA_CONTEXT_LENGTH=64000`及[对应平台的服务器说明](https://docs.ollama.com/context-length)配置现有服务，不要在 11434 端口启动第二个服务器。一次请求加载模型后，`ollama ps`会显示实际的 `CONTEXT`和 `PROCESSOR`。如果无法加载目标分配量，应停止，或缩小任务并选择适合配置。不要把目录最大值报告为实际分配的上下文。

### 3. 将 Claude Code 路由到本地服务器

打开终端，位置设在**所选仓库中**。Ollama 记载了以下启动器方法；使用已通过 `ollama list`确认的同一本地标签：

```text
ollama launch claude --model qwen3-coder:30b
```

Ollama 记载了这种非 Claude 模型路径。[Anthropic 的网关手册](https://code.claude.com/docs/en/llm-gateway)则表示，Anthropic 不支持通过网关将 Claude Code 路由到非 Claude 模型。因此应将其视为由 Ollama 记录、但该路由不获 Anthropic 支持的集成，并在依赖前核对真实会话。

对于手动配置，Ollama 的[集成说明](https://docs.ollama.com/integrations/claude-code#manual-setup)改用 `ANTHROPIC_AUTH_TOKEN=ollama`、明确设为空的 `ANTHROPIC_API_KEY`以及 `ANTHROPIC_BASE_URL=http://localhost:11434`。下面这个可选的 **Bash**命令从获授权仓库目录运行，仅为本次 Claude Code 进程设置这三项，不会修改全局 shell 配置：

```bash
ANTHROPIC_AUTH_TOKEN=ollama ANTHROPIC_API_KEY="" ANTHROPIC_BASE_URL=http://localhost:11434 claude --model qwen3-coder:30b
```

其他 shell 优先使用上面的 Ollama 启动器，或遵循当前官方手册中该 shell 的配置方法。检查是否存在覆盖命令变量的 Claude Code 设置，期间不要打印已有凭据。预期生效值是选定本地标签和 `http://localhost:11434`；这是读者须执行的检查，不是 BIG CHANGE 观察到的结果。本地服务器会忽略占位 token `ollama`；它不是访问控制密钥。文档中的本地路径不需要 Ollama 云端密钥或 Anthropic 推理密钥。Claude Code 软件条款和已连接服务条款仍适用。

按 Ollama 的[服务器配置说明](https://docs.ollama.com/faq)让服务器仅绑定本地。带有 `:cloud`的标签，或 `https://ollama.com`基础 URL，属于云端路径，涉及不同的数据和费用决定。若模型或目的地不明确，请先暂停发送仓库内容。

### 4. 检查路由，再请求一次编辑

允许文件修改前，若可用，请通过 `/status`检查 Claude Code 实际模型和连接。将该结果与启动器或手动端点、`ollama list`，以及请求加载模型后的 `ollama ps`对照。记录已加载的准确标签、已分配的 `CONTEXT`和 `PROCESSOR`；部分使用 CPU 可能改变实际可用性。如果有本地服务器请求记录，也应查看。这些检查证明配置和模型加载情况，不是对所有网络流量的完整审计。如果代码政策重视本地处理，请另查启用的 MCP 工具、网页读取与搜索、遥测和云端设置。

使用 Claude Code 正常的授权提示及[权限控制](https://code.claude.com/docs/en/permissions)。以普通语言提出该获授权仓库的单一任务：必要行为、允许范围、原验收命令以及停止点。要求报告修改文件和检查输出。commit、push 和发布由仓库所有者决定，拒绝意外网络或工具操作。模型声称用了本地端点或通过了检查，不等于已经验证。

### 5. 根据完整 diff 和原检查作决定

检查每个修改文件及**完整 Git diff**，包括超出要求范围的变更。对照原行为和仓库政策检查修改，也要核对新依赖的许可。编辑后亲自运行先前记录的同一验收命令，将退出状态和相关输出与初始状态并列记录。只有 diff 符合要求、独立检查结果可接受，且路由与权限证据满足要求时才接受修改。否则保持分支未被接受，留下具体失败供审查。

若无法连接 Ollama，请先检查正在运行的应用或服务及 `ollama list`，再尝试编程任务。如果模型无法加载，或 `ollama ps`报告上下文不足，检查内存及上下文设置，缩小任务或选合适本地模型。如果 `/status`或实际设置显示托管提供商，发送代码前先停止，修复当前 shell 或 Claude Code 设置。工具调用错误可能来自模型兼容性或权限拒绝，修改前先读具体响应。若某次尝试已改文件，撤销或继续前先看 diff。验收失败后应诊断代码，仅在审查过修正后重新运行检查。

下载模型的本地推理可避免提供商按 token 收取推理费用，但会使用硬件、存储和电力。下载、遥测、网页工具、MCP 集成或云端模型设置仍可能发送数据或产生其他费用。Ollama 支持[Anthropic Messages API 的一部分](https://docs.ollama.com/api/anthropic-compatibility)，包括 token 计数、提示缓存、批处理、引用、PDF 和强制工具选择在内的功能存在限制；不同模型的工具能力也不相同。BIG CHANGE 的文档审查没有产生速度、质量、隐私或节省方面的实测结果。其他本地代理配置可参考我们的[Junie Local 指南](https://bigchange.ai/blog/junie-local-windows-coding-agent-setup)；本流程专门保留 Claude Code 并核查其 Ollama 路由。

## 资料来源与延伸阅读

- [Ollama：《Claude Code》](https://docs.ollama.com/integrations/claude-code)提供当前启动器、手动本地设置和云端替代方案。它记录一种路径，不证明读者仓库中的执行成功。
- [Ollama：《Anthropic 兼容性》](https://docs.ollama.com/api/anthropic-compatibility)说明本地端点、忽略的占位 token、模型下载和 API 限制。兼容性不代表认证每个模型或工具调用。
- [Ollama：《上下文长度》](https://docs.ollama.com/context-length)解释编程 64k 建议、内存取舍以及 `ollama ps`的读回检查。实际机器决定可行分配量。
- [Ollama 的 qwen3-coder:30b 条目](https://ollama.com/library/qwen3-coder:30b)列出示例文件、工具及 Apache 2.0 许可链接。下载或再分发前请重查准确模型条目。
- [Claude Code 安装](https://code.claude.com/docs/en/setup)及[权限设置](https://code.claude.com/docs/en/permissions)说明访问和工具授权。两者都不能证明特定会话的实际端点或仓库修改安全。
- [Anthropic：《其他 LLM 网关》](https://code.claude.com/docs/en/llm-gateway)表示 Anthropic 不支持通过网关把 Claude Code 路由到非 Claude 模型。Ollama 则另行记录了此处的本地集成。

## Sources

- [Claude Code — Ollama](https://docs.ollama.com/integrations/claude-code) — 启动器和手动本地端点的第一手说明，以及独立云端路径。不能证明某次运行用了 localhost。
- [Anthropic 兼容性 — Ollama](https://docs.ollama.com/api/anthropic-compatibility) — 本地 Messages 端点、忽略的 token 占位符、模型下载和不支持的功能。兼容情况因模型和工具而异。
- [上下文长度 — Ollama](https://docs.ollama.com/context-length) — 编程 64k 建议、内存取舍和 ollama ps 的上下文及处理器读回检查；没有认证特定设备的能力。
- [qwen3-coder:30b — Ollama 模型库](https://ollama.com/library/qwen3-coder:30b) — 示例的准确本地标签、工具、约 19 GB 的 Q4_K_M 文件及 Apache 2.0 链接；下载大小不等于运行内存需求。
- [快速开始 — Ollama](https://docs.ollama.com/quickstart) — 官方安装及启动路径；读者应查当前平台说明和已安装版本。
- [常见问题 — Ollama](https://docs.ollama.com/faq) — 本地服务器配置及网络、云端边界；不是对 Claude Code 或其集成的完整隐私审计。
- [Claude Code 支持 — Ollama](https://ollama.com/blog/claude) — 将 Messages 兼容性起始记为 v0.14.0，但不能确定当前启动器的最低版本。
- [高级配置 — Claude Code Docs](https://code.claude.com/docs/en/setup) — 官方安装及平台要求；本次报道没有安装或运行 Claude Code。
- [配置权限 — Claude Code Docs](https://code.claude.com/docs/en/permissions) — 工具授权和实际权限；普通语言中的路径要求不是沙箱。
- [其他 LLM 网关 — Claude Code Docs](https://code.claude.com/docs/en/llm-gateway) — Anthropic 表示不支持通过网关将 Claude Code 路由到非 Claude 模型。这是厂商支持边界，与 Ollama 记录的本地集成并存，不是法律结论。