字节豆包搜索（Doubao Search）是火山引擎对外、人民币计费的 Agent 联网搜索 API，本教程用一个开源 MCP 一行命令接入 Claude Code，解决换国产模型后失网幻觉的问题。
字节豆包搜索（Doubao Search）是火山引擎对外、人民币计费的 Agent 联网搜索 API，本教程用一个开源 MCP 一行命令接入 Claude Code，解决换国产模型后失网幻觉的问题。
深入解析 Coding Agent 的六大核心模块：代码仓库上下文、提示词缓存、工具调用、上下文瘦身、会话记忆和任务委派，附开源 Mini Coding Agent 实践参考。
把 Claude Code 的模型 endpoint 换成国产大模型（豆包、Kimi、GLM、DeepSeek），是很多人在做的省钱操作。但你大概率会撞上同一个坑：子 Agent 突然不联网了，开始一本正经地编造。
原因很简单——Claude Code 自带的 WebSearch 工具绑定 Anthropic 的模型服务。一旦你切走，这个工具就跟着失效。Agent 没了眼睛，就只能靠参数里的旧知识硬编。
本篇解决这件事。主角是豆包搜索（Doubao Search）：字节火山引擎对外、人民币计费的 Agent 搜索 API。再叠加一个社区作者写的开源 MCP，你能在 1 分钟内把联网能力装回 Claude Code。
先做一个区分：这与本批次的 SearchOS（人大+蚂蚁的开源研究框架）完全不是一回事。SearchOS 是研究型多智能体框架；本篇讲的是字节商业搜索 API + 一个接入 Claude Code 的开源 MCP。也不要和字节的 TRAE Work 工作台混淆。
一句话：把豆包 App 里的搜索引擎抽出来，做成给 Agent 调用的接口。它在火山引擎（Volcano Engine）上以"搜索即服务"对外开，定位是 Tavily 的人民币计费替代品，专门为 Agent 调优，不是给人看的搜索引擎。
普通的搜索 API 给你的是"十条蓝链接"，Agent 拿到还得自己去抓页面、清洗正文。豆包搜索把这几步直接做了：
| 版本 | 定位 | 正文长度 | 特性 |
|---|---|---|---|
| Global | 开箱即用 | 约 1100 字/条 | 带 token 计数 |
| Custom | 企业级、规则化 | 约 3700 字/条 | 更快，带 4 级权威度分级 |
两版共享每月 500 次免费配额（微信文章 + 火山引擎官方帖均确认）。超出后按量付费，也提供月卡（月卡绑定火山引擎 Agent Plan）。具体单价和月卡价格以控制台实时为准——本文不编数字。
npx（Node 18+ 推荐）claude 命令DOUBAO_SEARCH_API_KEYARK_API_KEY：火山引擎方舟 key，启用后会开启 AI 增强（结果压缩、跨源交叉校验）主角是社区作者**花叔（alchaincyf）**开源的 MCP：github.com/alchaincyf/huashu-doubao-search（MIT 协议）。他做这个 MCP 的动机很直接：他自己写的"女娲（Nuwa）"技能（一个用 6 个子 Agent 研究人物思维风格的开源技能），在用户把模型换成国产模型后，子 Agent 不联网了，开始编造研究内容。他就把豆包搜索包成 MCP 给自己的技能用。
在终端执行这一条：
claude mcp add huashu-doubao-search \
-e DOUBAO_SEARCH_API_KEY=你的key \
-- npx -y github:alchaincyf/huashu-doubao-search参数说明：
-e DOUBAO_SEARCH_API_KEY=...：必填，火山引擎控制台开通后获取-e ARK_API_KEY=...：启用 AI 增强（结果压缩、跨源交叉校验）npx -y github:alchaincyf/huashu-doubao-search：每次启动从 GitHub 拉最新版这个 MCP 做的事只有一件：接收 Claude Code 的搜索请求 → 调豆包搜索 API → 格式化成 Agent 友好的结构（正文 + 时间戳 + token 计数）返回。
💡 提示：如果你已经有别的 MCP 配置，这条命令会增量添加，不冲突。装完在 Claude Code 里直接说"搜一下 xxx"，它会自动调起这个 MCP。
cross_check 做多源交叉核查花叔额外加了一个 cross_check 模式：并行从多角度发起搜索，再把结果做共识/分歧比对（他用 Doubao-Seed-Evolving 做对比模型）。适合写研究报告、做尽调时验证一个说法的可靠性。
调用方式是让 Claude Code 在 MCP 调用时带上 cross_check 参数（具体参数名以仓库最新 README 为准）。它会产出一份"哪些源达成共识 / 哪些源存在分歧"的报告，省掉你手动开 5 个 tab 自己比。
如果你不用 Claude Code，或者想直接写代码调，有两条备选路径。
A. 直接调 API：在控制台开通后拿 key，按官方文档发 HTTP 请求即可。适合想自己写 Agent、不依赖第三方 MCP 的开发者。返回字段包含前面说的正文、时间戳、ContentTokenCount、结构化卡片。
B. 官方 Skill 接入（火山引擎官方提供）：
npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search适合已经在用火山引擎 Agent 生态、想要"官方维护"接入方式的场景。本篇的主角是社区 MCP（更轻、专为 Claude Code 设计），Skill 是并列选项。
适合谁：
和 Tavily 的对比（花叔实测，单条结果信息量）：
| 维度 | 豆包搜索（Global） | Tavily basic |
|---|---|---|
| 每条正文长度 | 约 1100 字 | 约 700 字 |
| 发布时间戳 | 有，精确到秒 | 无 |
| token 计数 | 有 | 无 |
| 国内可用性 | 稳定 | 不稳定 |
| 计费 | 人民币 | 海外信用卡 |
| 免费额度 | 每月 500 次 | 有，但额度请以官网为准 |
结论很简单：人在国内、Agent 要稳定联网，选豆包；纯海外项目、用 Tavily 已经顺手，没必要换。
火山引擎/量子位公布的评测口径（以 Seed 模型为基座、官方评分器）：SimpleQA 较基线 +70%，在 FreshQA / BrowseComp-ZH / Xbench-2505 上排名领先。
这是厂商/媒体公布的评测，不是独立复测，请按这个性质参考。
火山引擎官方还宣传"国内 9 成 TOP 手机厂商智能助手背后的信息引擎"——这是厂商自述，未经独立核实，不作为本篇推荐依据。
Q：装了 MCP，Claude Code 还是不联网？
A：先确认 claude mcp list 里能看到 huashu-doubao-search；再确认环境变量 DOUBAO_SEARCH_API_KEY 没填错；最后查一下控制台是不是真的开通了"搜索 Infinity"服务，光有火山账号不算。
Q：免费额度用完会自动扣费吗？ A：以控制台实际计费策略为准，开通时务必自己确认一遍是否需要主动升级到付费档位，别默认开。
Q：cross_check 模式会更费配额吗？ A：会。它并行多角度查询，每次都算调用。500 次免费额度下建议先用单次搜索跑通，再考虑交叉核查。
Q：Global 和 Custom 怎么选？ A：个人开发、原型验证用 Global 足够；需要长正文、规则化检索、企业级 SLA 再考虑 Custom。
npx skills add https://skills.volces.com/skills/bytedance/agentkit-samples -s byted-web-search