> 「手写中文版 claude code」教学系列：codeAgent 是我从零手写的 claude code 复刻——不套壳不翻译，从界面到 Agent 主循环一行行实现，注释全是中文大白话，适合当 Agent 开发教材从头读到尾。
> 上一课治好了工具的"钱袋子"（按套餐发说明书省钱）；这一课钻进工具真正跑起来之后的环节——模型一次点好几道菜，结果怎么端回去才不被 API 拒。
> 仓库：https://github.com/Harvil1/codeAgent
## 翻车现场

模型一口气发起三个工具调用（读文件 A、读文件 B、跑个命令），我执行完按 OpenAI 的习惯逐条回喂：

```
assistant (tool_calls: [A, B, C])
tool (result A)
tool (result B)
tool (result C)
```

切到 Anthropic 格式的端点，直接 400。原因：**Anthropic 协议规定所有 tool_result 必须装在同一条 user 消息里**，而且不允许两条 user 消息相邻。OpenAI 的"一菜一盘"在它家是非法摆盘。

## 修复：翻译层统一合并

`agent/llm_client.py` 里的转换函数，docstring 就是踩坑记录：

```python
def _convert_messages_to_anthropic(self, messages: list) -> list:
    """把 OpenAI 格式的整段对话历史翻译成 Anthropic 格式。

    最关键的一步：把连续多条工具结果合并成一条 user 消息。
    因为 Anthropic 协议规定所有工具结果必须装在同一个 user 消息里，
    不允许两条 user 消息挨着；而 OpenAI 那边每个工具结果各自成条。
    （另外 system 消息在这里被抽走——它要走顶层参数，见上层拼装。）

    参数：
        messages：OpenAI 格式的消息列表

    返回：Anthropic 格式的消息列表。
    """
    conversation = []
    i = 0
    while i < len(messages):
        m = messages[i]
        role = m.get("role")

        if role == "system":
            i += 1
            continue  # system 走顶层参数，不进消息列表
        ...
```

核心手法是**双指针扫描**：遇到连续的 tool 消息块，一口气收进同一个 user 消息再往下走；顺带把 system 抽走（OpenAI 的 system 是消息列表的一员，Anthropic 的 system 是顶层参数——又一个差异点）。

## 并行回喂还有三个坑，一并说了

**1. id 配对不能错。** 三个结果必须各回各的 tool_call_id，张冠李戴模型会拿着 A 的结果回答 C 的问题——不报错但全错，比 400 更难查。

**2. 顺序无所谓，配对才要命。** 协议不要求结果按发起顺序回，但 id 必须一一对应。

**3. 换端点不换代码。** 这层翻译存在的意义：主循环只说 OpenAI 方言，Client 子类负责翻译——加新服务商只写一个翻译器，主循环零改动。

## 小结

1. 并行 tool_calls 的结果回喂，Anthropic 要求合并成单条 user、禁连续 user
2. 转换层双指针扫描：合并 tool 块 + 抽离 system，一次遍历搞定
3. id 严格配对；协议差异全部闷在 Client 层，主循环保持方言纯净

下一篇：**模型点了菜厨房没做——发送前的孤儿 tool_call 对账兜底**（附 _fix_tool_call_pairs 源码）。

---

仓库在这，注释全中文，欢迎 Star ⭐：https://github.com/Harvil1/codeAgent

**标签**：`Agent` `Function Calling` `大模型API` `Python`

「手写中文版 claude code」教学系列：codeAgent 是我从零手写的 claude code 复刻——不套壳不翻译，从界面到 Agent 主循环一行行实现，注释全是中文大白话，适合当 Agent 开发教材从头读到尾。 上一课治好了工具的"钱袋子"（按套餐发说明书省钱）；这一课钻进工具真正跑起来之后的环节——模型一次点好几道菜，结果怎么端回去才不被 API 拒。 仓库：https://github.com/Harvil1/codeAgent

模型点三道菜，回喂被拒 400

模型一次发起多个工具调用（并行 tool_calls），结果怎么喂回去两家规矩不同：OpenAI 每个结果自成一条，Anthropic 要求全部合并进同一条 user 消息、还不许两条 user 相邻——逐条回喂直接 400。本文附 codeAgent 真实源码 _convert_messages_to_anthropic：一次遍历完成格式翻译、连续工具结果合并和 system 抽离。

人工智能

后端

开发工具

手写Claude Code复刻教程：详解并行工具调用结果回喂Anthropic协议的正确格式，避坑400错误。核心修复是合并多条tool_result到单条user消息，双指针扫描处理连续工具块，严格配对tool_call_id。附源码仓库，注释全中文，适合Agent开发学习。

代码解释

Agent

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

模型点三道菜，回喂被拒 400-腾讯云开发者社区-腾讯云

模型点三道菜，回喂被拒 400

模型点三道菜，回喂被拒 400

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐