Claude Code 可以通过本机 Ollama 提供的模型处理获授权的仓库。Ollama 当前的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 版本和 Claude Code CLI，并遵守设备及组织规则。记录 ollama --version和 claude --version。Ollama 于 2026 年 1 月在 0.14.0 版引入 Anthropic Messages 兼容性；该日期不能确定当前 ollama launch命令的最低版本。

选择当前模型目录条目注明支持工具、许可允许使用，且模型权重与上下文分配都适合设备的模型。一个具体的本地例子是 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用于编程代理，并说明更大的上下文需要更多内存。硬件支持时，在现有 Ollama 应用的设置中设为 64k 或更大。如果服务器由你管理，应按OLLAMA_CONTEXT_LENGTH=64000及对应平台的服务器说明配置现有服务，不要在 11434 端口启动第二个服务器。一次请求加载模型后，ollama ps会显示实际的 CONTEXT和 PROCESSOR。如果无法加载目标分配量，应停止，或缩小任务并选择适合配置。不要把目录最大值报告为实际分配的上下文。

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

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

Text
ollama launch claude --model qwen3-coder:30b

Ollama 记载了这种非 Claude 模型路径。Anthropic 的网关手册则表示，Anthropic 不支持通过网关将 Claude Code 路由到非 Claude 模型。因此应将其视为由 Ollama 记录、但该路由不获 Anthropic 支持的集成，并在依赖前核对真实会话。

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

Terminal
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 的服务器配置说明让服务器仅绑定本地。带有 :cloud的标签，或 https://ollama.com基础 URL，属于云端路径，涉及不同的数据和费用决定。若模型或目的地不明确，请先暂停发送仓库内容。

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

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

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

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

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

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

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

资料来源与延伸阅读