让 Claude Code 使用 DeepSeek、Ollama 或其他模型

用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 把 Claude Code 指向厂商的 Anthropic 兼容端点,再在 ANTHROPIC_MODEL 和各个 ANTHROPIC_DEFAULT_*_MODEL 变量里填上该厂商的模型名。这样能用,但 Anthropic 不提供支持,一个会话只能对接一家厂商,而且提示词缓存等功能可能会被悄悄忽略。

更新于

原理

Claude Code 会把每个请求以 Anthropic Messages 格式发给 ANTHROPIC_BASE_URL 指定的地址。只要厂商支持这种格式,就能顶替 Anthropic,而 Claude Code 在请求用到厂商没实现的功能之前,察觉不到任何区别。Anthropic 的网关文档明确表示不支持这种用法:它「不支持通过任何网关把 Claude Code 路由到非 Claude 模型」。

可用的端点

厂商ANTHROPIC_BASE_URL说明
DeepSeekhttps://api.deepseek.com/anthropic官方指南。claude-opus* 系列名称映射到 V4 Pro,其余都映射到 V4 Flash
Ollama(本地)http://localhost:11434Ollama 0.14 起提供官方集成;ollama launch claude 会自动配置
Kimi (Moonshot)https://api.moonshot.ai/anthropic官方指南;kimi-k2.7-code 需要开启思考模式
Z.ai GLMhttps://api.z.ai/api/anthropic官方指南
Alibaba Coding Planhttps://coding-intl.dashscope.aliyuncs.com/apps/anthropic官方指南;按量付费的端点按地域区分
OpenRouterhttps://openrouter.ai/api只有上游厂商是 Anthropic 时才有保证;把 ANTHROPIC_API_KEY 设为空字符串
LM Studio(本地)http://localhost:1234官方集成页面

示例:DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-flash[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash
claude

这些值来自 DeepSeek 自己的 Claude Code 页面。每一档都要设置,而不只是 ANTHROPIC_MODEL:没设置的那一档仍会发送 Claude 的模型名,端点不认识它,用到这一档的后台任务和子 agent 就会失败。

示例:用 Ollama 跑本地模型

ollama launch claude

这条命令会帮你配置好 Claude Code。手动配置的话,需要三个变量和一个支持工具调用的模型:

export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
claude --model qwen3.5

对于较大的仓库,Ollama 建议上下文窗口至少 64K tokens;编程 agent 每一轮都会重新发送对话,小窗口很快就会被填满。

哪些会失效

  • 提示词缓存标记。DeepSeek 和 Ollama 会忽略 Anthropic 的 cache_control,Kimi 只认顶层的标记。不会报错;还能不能享受缓存价格,取决于厂商自己的缓存机制。
  • 切换厂商。Claude Code 只读取一个 ANTHROPIC_BASE_URL,所以从 DeepSeek 换到 Claude 要换一套设置重新启动,而不是一条 /model 命令就行。
  • 网页搜索。Claude Code 的 WebSearch 工具运行在 Anthropic 的服务器上。DeepSeek 说它的端点支持;Ollama 说托管的网页搜索未完全支持。
  • 无法识别的请求字段。Claude Code 会把不认识的模型名当成当前的 Claude 模型,发送 thinking 和 effort 字段,有些端点会以 400 拒绝。CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 会去掉 beta 字段,代价是失去 MCP 工具搜索。
  • 账号功能。设置了网关凭据时,Remote Control 和语音听写都不可用。
  • 残留的凭据。遗留的 ANTHROPIC_API_KEY、已保存的登录状态,或 settings.json 里旧的 env 值,都可能覆盖你的配置;/status 会显示实际在用的是哪个。

什么时候模型无关的 agent 更合适

如果你一次只用一家厂商,而且本来就在用 Claude Code,上面的设置就够了。如果你想在同一个任务里用 Claude、DeepSeek 和本地模型,OHarness 原生就能做到:每家厂商都已内置,对话以与厂商无关的格式存储,/model 跨厂商切换无需重启。OHarness vs Claude Code 直接对比了两者。

npm install -g oharness
oharness -m deepseek/deepseek-v4-flash

然后在会话中途,遇到需要的步骤时用 /model anthropic/claude-sonnet-5 切换,用完再切回来。

来源

常见问题

Claude Code 能用 DeepSeek 模型吗?

能,但属于非官方用法。DeepSeek 在 https://api.deepseek.com/anthropic 提供 Anthropic 兼容端点:把 ANTHROPIC_BASE_URL 设为它,ANTHROPIC_AUTH_TOKEN 设为 DeepSeek API key,模型变量设为 DeepSeek 的模型名。Anthropic 不支持在 Claude Code 里使用非 Claude 模型。

Claude Code 能通过 Ollama 跑本地模型吗?

能。Ollama 0.14 及以后版本支持 Anthropic Messages 格式,`ollama launch claude` 会把 Claude Code 配置成使用它。选一个支持工具调用的模型,并给它 64K tokens 或更大的上下文窗口。

Claude Code 能在一个会话里在 Claude 和 DeepSeek 之间切换吗?

不能。Claude Code 只读取一个 ANTHROPIC_BASE_URL,所以一个 Claude Code 会话只能对接一家厂商。OHarness 可以在会话中途用 /model 在 Anthropic、DeepSeek、OpenAI、Gemini 和本地模型之间切换。

为什么 Claude Code 连接其他厂商的端点会返回 400 错误?

Claude Code 会假定不认识的模型是当前的 Claude 模型,并发送 adaptive thinking 和 effort 等字段,有些端点会拒绝这些字段。把每个 ANTHROPIC_DEFAULT_*_MODEL 变量都设为厂商的模型名,再设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1,就能去掉其中大部分。

相关内容