把 Mistral 当 Claude Code 子代理：省 2-4 倍 token 费用的方法

Claude Opus 做规划，Mistral Vibe 做执行——30 行配置文件，机械性任务费用降低 2-4 倍。本文介绍在 Claude Code 里配置 Mistral 子代理的完整方法。

把 Mistral 当 Claude Code 子代理：省 2-4 倍 token 费用的方法

Claude Opus 4.7 很强，但用它做批量重构、文件扫描和机械性编辑是在用跑车送外卖。Mistral Vibe（Mistral Medium 3.5，每百万 token 输入 $1.50 / 输出 $7.50）的单价约是 Opus 4.7（输入 $5 / 输出 $25）的三分之一。Claude Code 的子代理系统让你可以保留 Opus 做规划和审查，把机械性工作路由给 Vibe——一个 30 行的配置文件就能实现这套混合路由。

成本对比

模型 输入（/百万 token） 输出（/百万 token） 适合场景
Claude Opus 4.7 $5 $25 规划、架构决策、跨文件推理
Mistral Vibe（Medium 3.5） $1.50 $7.50 批量重构、文件扫描、模板式代码生成

对于输出密集的机械任务（生成大量代码行），节省比例最高——$25 vs $7.50，差 3.3 倍。如果你有高频的批量处理需求，这个差距乘以任务量会很显著。

工作原理：子代理描述驱动路由

Claude Code 读取 .claude/agents/ 目录下的每个 Markdown 文件，用其中的 description 字段决定把任务路由给哪个子代理。Opus 看到用户的任务后，根据描述判断这个任务是交给自己还是派给某个子代理。

关键设计：description 里写清楚"什么情况下用"和"什么情况下不用"，和在 .claude/agents/mistral-vibe.md 里写的一样重要。

配置文件：.claude/agents/mistral-vibe.md

---
name: mistral-vibe
description: |
  Mistral Vibe 子代理，用于机械性代码任务。
  使用场景：批量重构、文件扫描、模板式代码生成、大范围命名修改、
  测试桩生成、注释补全。
  
  不要用于：架构决策、跨文件依赖推理、需要理解业务逻辑的功能开发、
  有安全要求的文件（.env、密钥相关代码）。
model: mistral-medium-latest
tools:
  - Bash
---

你是一个专注于执行的代码工程师。你的角色是完成 Claude Code 分配的具体编码任务。
任务范围会在提示词里给出。完成后把结果、修改的文件列表和任何未解决问题汇报给 Claude Code。

注意 tools: Bash——故意限制为只有 Bash，这让子代理的上下文保持窄，不会做超出任务范围的事情。它通过 shell 命令调用 Mistral 的 CLI，而 Mistral CLI 做实际的工作。

Mistral Vibe CLI 安装

pip install mistral-vibe
mistral-vibe login  # 输入 API key

安装后在终端里测试：

mistral-vibe "列出当前目录的所有 .ts 文件并统计行数"

Claude Code 实际使用时的对话

你：帮我把项目里所有的 console.log 替换成 logger.debug，logger 从 ./utils/logger 导入

Claude Code（Opus）：这是个批量重构任务，交给 Mistral Vibe 处理更高效。
[派给 mistral-vibe 子代理]

Mistral Vibe：[扫描所有 .ts 文件，生成替换列表]
已修改 47 个文件，共替换 203 处。2 个文件里有条件式 console.log，建议人工检查：
- src/debug-utils.ts（第 45 行，嵌套在三元运算符里）
- tests/setup.ts（第 12 行，只在 NODE_ENV=test 时运行）

Claude Code（Opus）：[读取 Vibe 的报告]
主要替换完成。标记出的 2 个文件需要你看一下，其他 45 个文件已 ready for review。

Opus 全程保持全局视图，Vibe 做实际的扫描和修改，任务分工清晰。

适合混合路由的任务类型

高价值委托给 Vibe 的任务：

  • 修改 X 个文件里的 Y 模式
  • 根据规范批量生成测试桩
  • 添加/更新注释或 JSDoc
  • 按模板重命名变量或函数
  • 将旧 API 用法批量迁移到新 API

必须保留给 Opus 的任务：

  • 新功能设计
  • 有多个文件依赖关系的重构
  • 代码审查和质量判断
  • 安全相关的修改
  • 结果验证和合并决策

常见问题

问：这和直接用 Mistral API 有什么区别？ 答：直接用 API 需要你自己写调度代码。子代理模式让 Opus 自动决定什么时候派给 Vibe，不需要你在每次任务前手动判断。工作流是连续的，不需要切换工具。

问：子代理会不会看到敏感文件？ 答：tools: Bash 限制它只能用 shell 命令，不能主动读取任意文件。但通过 shell 命令仍然可以访问有权限的文件。建议在描述里明确"不要触碰 .env 和密钥文件"，并检查任务完成后的 git diff 来确认没有意外变更。

问：Mistral Vibe 的质量够用吗？ 答：对于机械性任务（替换、重命名、批量生成）够用。对于需要理解上下文和业务逻辑的任务，Vibe 的能力明显弱于 Opus。混合路由的价值正在于分清边界——不是用 Vibe 替代 Opus，而是让 Opus 做它有优势的事。

参考资料