Muse Code 接入 DeepSeek V4 实操指南
Muse Code 是 Meta 于 2026 年 8 月 6 日发布的首个 AI 编程智能体工具，基于 Muse Spark 1.2 模型驱动。DeepSeek V4 则是性价比极高的国产大模型，代码能力出众且 API 价格低廉。本文介绍如何将 DeepSeek V4 接入 Muse Code，实现国产模型驱动的 AI 编程体验。
一、直接挑战：API 协议不兼容
Muse Code 原生运行在 Meta Model API 之上，默认调用 Muse Spark 1.2 模型。DeepSeek V4 虽然也提供 OpenAI 兼容的 API 接口，但直接将两者对接会失败，原因在于 API 协议不兼容。
不过，这并不意味着无法实现——通过社区方案和协议桥接工具，可以绕过这一限制。
二、方案一：通过 OpenRouter 中转接入
Muse Code 已登陆 OpenRouter 平台。OpenRouter 是一个模型聚合网关，支持统一调用多种模型。你可以通过以下步骤接入：
- 注册 OpenRouter：访问 openrouter.ai 注册账号。
- 获取 API Key：在 OpenRouter 后台生成 API Key。
- 选择 DeepSeek V4：在 OpenRouter 的模型列表中选择 DeepSeek V4 系列模型。
- 配置 Muse Code：将 Muse Code 的 API 端点指向 OpenRouter，并使用 OpenRouter 提供的 Key。
这种方式的核心思路是：用 OpenRouter 作为协议翻译层，让 Muse Code 以为自己在调用 Meta Model API，实际请求被转发到 DeepSeek V4。
三、方案二：通过 Codex 兼容方案移植（适用于 Codex 生态）
Muse Code 与 OpenAI Codex 在功能定位上高度相似。社区已经有成熟的方案将 DeepSeek V4 接入 Codex，这些方案对 Muse Code 同样有参考价值。
3.1 准备 DeepSeek API Key
- 打开 DeepSeek 开放平台
- 注册登录后进入 API Keys 页面
- 新建 API Key（以
sk-开头），创建后立即复制保存，关闭页面后无法再次查看
3.2 方案 A：Custom Subagent 模式（推荐）
社区方案 codex-deepseek-subagent 可以在不替换主模型的前提下，将 DeepSeek V4 Flash 作为原生 custom subagent 使用。
安装步骤如下：
export DEEPSEEK_API_KEY="sk-你的密钥"然后让 Codex（或类似工具）自行安装：
将以下指令交给 Codex：请按照 https://github.com/Utopia-V/codex-deepseek-subagent 中的 prompts/install-with-codex.md，为我安装原生 DeepSeek V4 Flash custom subagent。
安装会在 ~/.codex/agents/ 目录中创建 v4_flash_worker 配置，无需修改顶层配置文件。
3.3 方案 B：本地协议桥接
另一种思路是通过本地桥接服务，将 DeepSeek 的 API 格式转换为 Muse Code / Codex 能识别的格式：
ol>codex-bridge），运行在 127.0.0.1:4000这种方式下，Muse Code 可以调用 DeepSeek，但桥接进程必须保持运行。
四、方案三：使用支持国产模型的同类工具
如果上述方案过于复杂，也可以考虑直接使用原生支持 DeepSeek 等国产模型的同类工具。
例如，开源项目 @qxbyte/muse 是一个围绕 OpenAI 兼容协议构建的 TypeScript Agent CLI，一线支持 DeepSeek、Qwen、Kimi、GLM 等国产大模型。其配置方式为：
- 准备一个 LLM 端点的 API Key
- 创建模型仓库
~/.muse/models.local.json - 启动并配置模型
五、关于实在 Agent
需要说明的是，实在Agent 已经接入了包括 DeepSeek V4 在内的国产大模型。如果你使用实在 Agent，无需自行处理 Muse Code 与 DeepSeek 的对接配置，可以直接在 Agent 工作流中调用 DeepSeek V4 的代码能力，享受开箱即用的国产 AI 编程体验。
六、风险与注意事项
- Muse Code 目前为测试版，仅支持 macOS 和 Linux
- Muse Code 不提供可下载的模型权重，本质上是一个 "安装 Agent + 租用模型" 的模式
- 通过第三方网关接入时，注意 API Key 的安全管理，不要将 Key 提交到代码仓库
- 桥接方案可能影响响应速度和稳定性，生产环境需充分测试
总结
Muse Code 原生不支持 DeepSeek V4，但可通过 OpenRouter 中转、Custom Subagent 移植或本地协议桥接等方式实现接入。推荐优先尝试 OpenRouter 方案（配置最简单）或 custom subagent 方案（不破坏原有配置）。如果追求更稳定的国产模型编程体验，可直接使用实在 Agent——它已内置 DeepSeek V4 等国产大模型，开箱即用。
