1. Hacknight Beijing 现场Claude Code 写 ES|QL 时卡住你的往往不是 ElasticHacknight Beijing 这场 4 小时 AgentHack 实战核心目标很明确在阿里云 Elasticsearch、Elastic Cloud Serverless 或自部署集群上用 Elastic Agent Builder、Workflows、ES|QL、MCP 交付一个能跑起来的 Prototype。现场允许带 Claude、Cursor、Codex、Copilot、Kiro 这类 AI 编程助手但订阅账号得自己准备。问题就出在这——很多人把时间花在了「怎么让 Claude Code 稳定发出模型请求」上而不是花在「怎么把 ES|QL 写对、把 MCP 工具描述补全、把 Workflow 配置调通」上。我见过最典型的场景一位参与者本地 Claude Code 已经装好阿里云 ES 9.3 集群也开了Kibana 能登录Agent Builder 里推理端点也建了。结果 Claude Code 一跑就报 401 或连接超时他以为是阿里云 ES 的问题反复去查集群健康、检查 Token、重启 Kibana折腾了快 40 分钟。实际上集群一点问题没有是编程助手的模型通道没配通。Hacknight 只有 4 小时这种消耗非常致命。这条内容占用的是「Agent / Harness长会话、多工具、任务编排」视角。也就是说你现场要做的事情不是单轮问答而是让 Claude Code 连续帮你写 ES|QL 片段、补 MCP 工具描述、调 Workflow 配置中间还要把结果放进 Kibana 或 Agent Builder 验证。这种长会话、多工具切换的节奏对模型通道的稳定性要求比普通聊天高得多。Key 分散在多个地方、Base URL 填错、带了多余的/v1都会让整条链路断掉。TaoToken 在这里的角色要说清楚它只给 Claude Code 这类 AI 编程助手提供 Key 和统一兼容通道不替代阿里云 Elasticsearch、Elastic Agent Builder 或 Workflows。你该建的索引、该写的 ES|QL、该配的 Workflow一样都不能少。它解决的是「模型请求怎么稳定发出去」这一段。下面按现场可跟做的顺序把配置、验证、排错一次讲透。2. 赛前 10 分钟先把 TaoToken 的 Key 和通道准备好原文的赛前准备是让你先搭集群环境这个没错。但在 Hacknight 现场我建议你多花 10 分钟把编程助手的模型通道也提前配好。原因很简单集群搭建有官方指引照着做基本不会错但 Claude Code 的通道配置很多人是第一次碰现场现查文档最费时间。第一步打开 TaoToken 官网创建 Key。地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册后在控制台里生成 API Key。这个 Key 就是你后面填进 Claude Code 的凭证。注意官网地址带 UTM 参数是正常的但填进 Claude Code 的 Base URL 不能带这些参数后面会细说。第二步确认你要用的接入地址。TaoToken 的 API 地址是https://taotoken.net/api。这里有个高频坑不要在后面加/v1。很多人习惯性地写成https://taotoken.net/api/v1结果请求路径拼出来就错了报 404 或 401。记住Base URL 就是https://taotoken.net/api干干净净不带/v1也不带任何 UTM 参数。第三步想清楚你现场要用哪种编程助手。如果你用的是 Claude Code那 Base URL 和 Key 就按上面填。如果你同时还想用 Cursor 或 Codex它们各自的配置入口不同但通道地址是同一套。Hacknight 现场时间紧建议只主攻一个助手别在多个工具之间来回切。这里给一个对照表把容易混的几个地址列清楚用途地址说明官网注册/创建 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_end带 UTM仅用于浏览器访问API Base URLhttps://taotoken.net/api填进 Claude Code不带/v1控制台管理 Key控制台入口查看、轮换、删除 Key接入文档文档入口各助手配置细节注意官网地址和 API 地址是两个东西。官网带 UTM 参数是给浏览器用的API 地址不带任何参数是给程序用的。把官网地址填进 Claude Code 的 Base URL请求会打到网页上必然失败。Key 拿到后先别急着写业务代码。花两分钟做一次最小验证确认通道是通的再进入 ES|QL 和 Agent Builder 的开发。这个顺序能帮你省下大量排错时间。3. Claude Code 可复制配置Base URL 与 Key 怎么填Claude Code 的配置方式取决于你的安装形态。现场最常见的是命令行版本配置一般通过环境变量或配置文件完成。下面给一套可直接复制的配置思路你按自己的实际安装方式对应调整。如果你用的是环境变量方式核心是两个值API Key 和 Base URL。Key 就是你从 TaoToken 控制台生成的那串字符Base URL 固定为https://taotoken.net/api。配置示意如下export ANTHROPIC_API_KEY你的TaoToken Key export ANTHROPIC_BASE_URLhttps://taotoken.net/api这两行写进你的 shell 配置文件或者直接在终端里 export 后启动 Claude Code。注意 Base URL 结尾没有斜杠也没有/v1。我试过在结尾多加一个斜杠某些版本会拼出双斜杠路径虽然不一定报错但没必要给自己埋雷。如果你用的是配置文件方式通常在用户目录下有一个配置目录里面放 settings 或 config 文件。把 Key 和 Base URL 填进对应字段即可。不同版本字段名可能略有差异以你本地claude --help或官方文档为准。核心原则不变Key 用 TaoToken 生成的Base URL 用https://taotoken.net/api。配置完成后不要直接开一个复杂的 Agent 任务。先用一个最小请求验证通道。比如让 Claude Code 解释一段简单的 ES|QL或者让它生成一个查询语句。如果它能正常返回内容说明通道通了。如果报错先看错误码再对照下一节的排错表。这里要强调一个现场高频错误有人把 Key 填对了Base URL 也填对了但启动 Claude Code 时用的是旧的 shell 会话环境变量没生效。表现就是一直报 401但你去检查配置文件明明是对的。解决办法很简单配置改完后新开一个终端窗口或者 source 一下配置文件再启动。还有一个容易忽略的点如果你现场同时开了多个终端每个终端的环境变量是独立的。在 A 终端配好了B 终端没配B 终端里的 Claude Code 就会失败。Hacknight 现场多窗口操作很常见这个坑踩一次就记住了。配置阶段的目标只有一个让 Claude Code 能稳定发出模型请求。至于 ES|QL 写得对不对、MCP 工具描述全不全、Workflow 配置合不合理那是下一步的事。先把通道打通再谈业务逻辑。4. 验证请求从 ES|QL 片段到 Kibana / Agent Builder 闭环通道配好后进入 Hacknight 的正题用 Claude Code 连续写 ES|QL、补 MCP 工具描述、调 Workflow 配置再把结果放进 Kibana 或 Agent Builder 验证。这一步的关键是形成闭环而不是让 Claude Code 一直生成代码却从不验证。先做数据导入。原文提到几种写入方式包括用 Claude Code 写 CSV 数据到 Elasticsearch。你可以让 Claude Code 帮你生成 bulk 请求的 JSON 结构或者生成一段 Python 脚本用 elasticsearch 客户端写入。比如让它生成一个针对 IMDB 电影数据的索引映射和批量写入片段。生成后不要直接信先在小批量数据上跑一次确认索引创建成功、文档数量对得上。接着写 ES|QL。ES|QL 是 Elastic 的管道查询语言语法和传统 DSL 不一样Claude Code 有时候会混用。你可以这样操作先给它一个明确的表结构和查询目标让它生成 ES|QL 片段然后在 Kibana 的 ES|QL 编辑器里粘贴执行。如果报语法错误把错误信息贴回给 Claude Code让它修正。这个来回过程就是长会话的典型场景通道稳定的话几轮就能调对。MCP 工具描述是另一个重点。Agent Builder 创建的工具要通过 MCP 协议供外部客户端调用工具描述写得好不好直接影响调用效果。你可以让 Claude Code 根据你的索引字段和查询意图生成工具描述文本然后填进 Agent Builder 的工具配置里。填完后在 Kibana 里测试调用看返回结果是否符合预期。Workflow 配置同理。Workflow 把多个步骤串起来比如先检索、再推理、再返回。你可以让 Claude Code 生成 Workflow 的配置结构然后导入或手动配置。配置完成后在 Agent Builder 里跑一次完整流程确认每一步的输出都正确。验证成功的标志是什么我建议你盯三个点第一Claude Code 能连续多轮响应不中断、不超时第二生成的 ES|QL 在 Kibana 里能跑出结果第三Agent Builder 里的工具或 Workflow 能被调用并返回合理内容。三个点都过了你的 Prototype 基本就立住了。提示Hacknight 现场时间有限不要追求一次写完美。先用最小可用数据集跑通闭环再逐步加字段、加工具、加 Workflow 步骤。闭环跑通的那一刻你就已经超过很多还在配环境的人了。如果你在验证过程中发现模型请求变慢或偶发失败先别怀疑 Elastic 集群。回到通道层面检查Key 是否还有效、Base URL 是否被改过、当前终端环境变量是否还在。这些检查通常一分钟内能完成。5. 本篇常见错排查401、404、超时分别怎么定位现场排错最怕没有方向。下面按错误类型给一套定位顺序你照着走基本能覆盖大部分情况。401 未授权最常见的原因是 Key 不对或没生效。先确认你填进 Claude Code 的 Key 是从 TaoToken 控制台生成的没有多余空格没有换行。再确认当前终端的环境变量确实加载了。可以echo一下相关变量看值对不对。如果 Key 刚轮换过旧 Key 会失效换新的即可。404 找不到路径几乎都是 Base URL 写错。检查是不是多加了/v1是不是把带 UTM 的官网地址填进去了是不是结尾多了斜杠导致路径拼接异常。正确值就是https://taotoken.net/api。改完后新开终端再试。连接超时先看网络本身是否正常再看 Base URL 是否可达。如果同一台机器上浏览器能打开官网但 Claude Code 请求超时重点查 Base URL 是否被错误地写成了官网地址。官网地址是给浏览器用的程序请求要走 API 地址。还有一种情况是请求能通但返回内容异常比如模型一直重复、或者答非所问。这通常不是通道问题而是你的提示词或上下文太长导致的。Hacknight 现场长会话多上下文容易膨胀。可以适当精简历史消息或者把任务拆成几个短会话分别处理。另外提醒一点不要在 Claude Code 里配置任何与网络访问相关的额外工具或参数。你只需要 Key 和 Base URL 两个值。多配反而容易出错。现场如果遇到不确定的报错先把 Key 和 Base URL 这两项确认一遍再往下查。排错时建议用最小请求验证而不是拿一个复杂的 Agent 任务去试。最小请求能快速区分是通道问题还是业务逻辑问题。通道问题修配置业务问题修提示词或代码。两者分开处理效率高很多。6. 通道配通之后把时间还给 Agent 本身Hacknight Beijing 只有 4 小时交付要求是能演示的 Prototype。这意味着你的时间应该花在 Agent 的逻辑、ES|QL 的准确性、MCP 工具的可用性、Workflow 的完整性上而不是花在反复调试模型通道上。把 TaoToken 的 Key 和 Base URL 提前配好、验证通过你就把这块不确定性消掉了。具体操作路径再捋一遍先在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end创建 Key然后在 Claude Code 里把 Base URL 填成https://taotoken.net/api不带/v1不带 UTM。配完做一次最小验证确认能正常返回。之后按原文思路写数据导入、调 ES|QL 片段把结果放进 Kibana 或 Agent Builder 验证。如果你现场主要用 Claude Code 做长期编码和 Agent 编排可以关注 Coding Plan 相关的入口把长会话场景的通道稳定性再往上提一档。如果只是临时验证某个模型效果模型对话入口更直接。Key 的管理和轮换在控制台完成接入细节看接入文档。这几个入口按你的实际场景选不用全用上。最后说一个现场实用技巧把你的 Key 和 Base URL 配置写成一个可复用的小脚本新开终端时 source 一下。这样即使你同时开多个窗口做不同实验也不会因为环境变量丢失而中断。Hacknight 拼的是交付速度少一次排错就多一次迭代机会。