让 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 | 说明 |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic | 官方指南。claude-opus* 系列名称映射到 V4 Pro,其余都映射到 V4 Flash |
| Ollama(本地) | http://localhost:11434 | Ollama 0.14 起提供官方集成;ollama launch claude 会自动配置 |
| Kimi (Moonshot) | https://api.moonshot.ai/anthropic | 官方指南;kimi-k2.7-code 需要开启思考模式 |
| Z.ai GLM | https://api.z.ai/api/anthropic | 官方指南 |
| Alibaba Coding Plan | https://coding-intl.dashscope.aliyuncs.com/apps/anthropic | 官方指南;按量付费的端点按地域区分 |
| OpenRouter | https://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 oharnessoharness -m deepseek/deepseek-v4-flash然后在会话中途,遇到需要的步骤时用 /model anthropic/claude-sonnet-5 切换,用完再切回来。
来源
- Anthropic:LLM 网关和环境变量
- DeepSeek:Claude Code 和 Anthropic API 兼容性
- Ollama:Claude Code 和 Anthropic 兼容性
- Kimi:Claude Code、Z.ai:Claude Code、阿里云百炼:Claude Code
- OpenRouter:Claude Code、LM Studio:Claude Code
- 核实于 2026-09-25。厂商会更改这些端点,以它们的页面为准。
常见问题
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,就能去掉其中大部分。