在 Free Claude Code 中接入 OpenRouter 或 DeepSeek，只需在项目根目录的 .env 文件中配置对应的 API Key 和 MODEL 变量。OpenRouter 提供丰富的免费模型池，而 DeepSeek 在中文场景和价格上更具优势，两者均使用 Anthropic 原生协议。本文将分别指导你完成两个服务的独立配置，并演示如何将它们混合用于不同的 Claude 模型层级。
Free Claude Code 接入 OpenRouter 和 DeepSeek：云端 API 代理配置
Free Claude Code 作为一个开源的 Anthropic API 代理，其核心能力在于将 Claude Code 的请求转发至不同的后端。本文聚焦于两个主流的云端后端：OpenRouter 和 DeepSeek。配置过程的核心是在 .env 环境变量文件中设置正确的 API Key 和模型名称。
服务对比与选择建议
在开始配置前，了解两者的差异有助于你做出选择。
OpenRouter 是一个模型聚合平台，其优势在于：
- 免费模型池：它提供了一批完全免费的模型（通常附带速率限制），非常适合零成本体验。
- 模型丰富：通过一个 API Key，你可以访问来自不同厂商的上百个模型。
DeepSeek 是国产大模型服务商，优势体现在：
- 中文能力强：在中文代码注释、文档理解和对话交互上，表现通常优于海外模型。
- 价格低廉：其 API 定价比 Claude 官方 API 低很多。
两者在 Free Claude Code 中的共同点是：都使用 Anthropic Messages 格式。这意味着代理无需进行协议转换，直接透传请求，配置简单直接。
OpenRouter 配置指南
申请 API Key
- 访问 OpenRouter 密钥管理页面：openrouter.ai/keys。
- 登录或注册账户。
- 创建新的 API Key，其格式通常以
sk-or-开头。
环境变量配置
在你的项目根目录的 .env 文件中，添加以下两行：
OPENROUTER_API_KEY="sk-or-你的密钥"
MODEL="open_router/stepfun/step-3.5-flash:free"关键说明：
MODEL变量的格式为open_router/模型发布者/模型名。- 示例中的
stepfun/step-3.5-flash:free是一个免费模型。你可以从 OpenRouter 的模型列表中选择其他模型。
模型发现与网络代理
- 浏览模型：所有模型列表在 openrouter.ai/models。查看免费模型集合，请访问 openrouter.ai/collections/free-models。
- 配置代理：如果你的网络环境需要，可以通过
OPENROUTER_PROXY变量设置 HTTP 代理。OPENROUTER_PROXY="http://username:password@host:port"
验证配置
配置完成后，重启 Free Claude Code 服务。尝试用 Claude Code 执行一个简单的代码生成或问答任务，观察日志或输出是否正常。如果遇到 429 错误，说明触及了免费模型的速率限制，稍等重试或更换为其他免费/付费模型。
DeepSeek 配置指南
申请 API Key
- 访问 DeepSeek 开放平台：platform.deepseek.com/api_keys。
- 登录或注册账户。
- 创建你的 API Key。
环境变量配置
同样在 .env 文件中添加：
DEEPSEEK_API_KEY="你的 DeepSeek 密钥"
MODEL="deepseek/deepseek-chat"关键说明：
- DeepSeek 使用的是
api.deepseek.com/anthropic这个特定端点，它原生兼容 Anthropic Messages 协议。Free Claude Code 会直接转发请求，无需额外配置 URL。 MODEL变量的格式为deepseek/模型名称。
可用模型选择
| 模型 | 说明 | 推荐场景 |
|---|---|---|
deepseek/deepseek-chat |
通用对话模型 | 日常开发、代码问答、文档编写 |
deepseek/deepseek-coder |
代码专用模型 | 纯代码生成、重构、调试 |
注意：DeepSeek 不支持通过 DEEPSEEK_PROXY 变量配置网络代理。如果需要代理，请在操作系统或网络层面进行设置。
验证配置
重启服务后进行测试。你可以尝试让 Claude Code 用中文编写代码注释或解释一段中文技术文档，以体验 DeepSeek 在中文处理上的优势。
混合使用：为不同模型层级指定不同 Provider
Free Claude Code 的高级功能之一是 多模型路由，允许你为 Claude 的 Opus、Sonnet 和 Haiku 三个能力层级分别指定不同的后端。这可以让你灵活组合，例如用免费的 OpenRouter 模型处理耗资源的 Opus 请求，用响应快的 DeepSeek 处理日常 Sonnet 请求。
以下是一个混合配置示例，在 .env 文件中同时定义两个服务的 Key 和分层模型：
# 同时配置两个服务的 Key
OPENROUTER_API_KEY="sk-or-..."
DEEPSEEK_API_KEY="..."
# 为不同层级指定不同模型
MODEL_OPUS="open_router/deepseek/deepseek-r1-0528:free"
MODEL_SONNET="deepseek/deepseek-chat"
MODEL_HAIKU="lmstudio/unsloth/GLM-4.7-Flash-GGUF"
# 设置默认模型（当层级未明确指定时使用）
MODEL="open_router/deepseek/deepseek-r1-0528:free"在这个配置下：
- 当 Claude Code 调用需要深度推理的 Opus 层级时，请求会被路由至 OpenRouter 的免费 DeepSeek R1 模型。
- 调用主力的 Sonnet 层级时，请求会直接发往 DeepSeek 官方 API。
- 调用轻量级的 Haiku 层级时，请求则会发往你本地运行的 LM Studio 服务。
FAQ
Q: OpenRouter 免费模型有调用限制吗？
A: 有。免费模型通常有严格的速率限制（如每分钟几次调用）。如果遇到 429 Too Many Requests 错误，等待几秒后重试，或切换到一个付费模型。
Q: DeepSeek 的工具调用（Tool Use）稳定性如何？
A: DeepSeek 的工具调用功能仍在持续优化中。对于复杂的工具链（例如多工具并行调用、嵌套调用），其稳定性可能不及 Claude 官方模型。如果遇到工具调用频繁失败，可以尝试切换到 OpenRouter 的模型，或在 settings.json 中为该任务启用 thinking 模式。
Q: OpenRouter 和 DeepSeek 可以同时用吗？
A: 可以。通过为 MODEL_OPUS、MODEL_SONNET、MODEL_HAIKU 分别设置不同的 模型提供者/模型名，即可实现混合使用。更详细的路由策略，请参考 多模型路由配置。
Q: DeepSeek 的 deepseek-chat 和 deepseek-coder 该怎么选？
A: deepseek-coder 是针对代码场景优化的版本，在代码生成和理解方面通常更强。deepseek-chat 是通用模型。对于日常的软件开发工作，chat 版本已经足够；如果你的活动几乎全是纯代码编写和调试，可以尝试 coder 版本。