curl 不止是下载工具：AI 与 Agent 开发中的十二类实战场景

多数人学 curl 的第一课是"下载文件"，此后便把它归类为 wget 的同类。但在 AI 与 Agent 工程中，curl 的角色完全不同：它是唯一一个在协议层完全透明、零依赖、可在任何环境逐字复现的 HTTP 客户端。当需要回答"这个模型接口到底返回了什么"“延迟究竟卡在哪一段"“Agent 的工具调用为什么静默失败"时，curl 往往比任何 SDK 都更快给出答案——因为它不隐藏任何东西。

本文以 curl 8.22.0（2026-09-02 发布，第 276 个版本，命令行选项累计 278 个）为基线，梳理十二类高频场景。所有命令均可直接粘贴执行，只需替换端点与凭据。

一、LLM 接口调试的四个基本动作

1.1 最小可复现调用

--json（7.82.0 引入）是单次调用最省事的写法，它等价于同时做三件事：把数据作为 --data-binary 发送、设置 Content-Type: application/json、设置 Accept: application/json。

curl -sS https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  --json '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "只回复 OK"}],
    "temperature": 0
  }' \
  -w '\n[%{http_code} | %{time_total}s | %{size_download}B]\n'

三点值得强调：