ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

Bun 1.3 里跑 Claude Code,Base URL 填 TaoToken

Bun 1.3 里跑 Claude Code,Base URL 填 TaoToken 1. Bun 1.3 里跑 Claude Code卡住你的其实不是 BunBun 1.3 发布之后我身边不少做 AI 工具链的朋友都在讨论同一件事Anthropic 把 Bun 收进自家体系Claude Code、Claude Agent SDK 这些面向开发者的东西未来大概率会围绕 Bun 这个运行时做深度协同。Bun 启动快、内存低、内置打包和 TypeScript 支持拿来当 AI 编程工具的执行底座确实合适。于是很多人第一反应就是那我本地装个 Bun 1.3把 Claude Code 拉起来试试。真正动手之后问题往往不在 Bun 本身。Bun 的安装、bun init、bun run这些步骤都很顺卡点集中在模型通道Claude Code 要连的模型服务从哪来Key 怎么创建Base URL 到底填什么。原文第六节留了一句「试用最新 Bun v1.3」但没展开讲通道怎么配。这篇就把这一步补全目标很明确——在 Bun 1.3 环境里把 Claude Code 跑通发一条最小请求确认有正常返回并且在调用记录里能看到这次消耗。适合谁看本机已经装了 Bun 1.3、想验证 Claude Code 能不能用的人手里有 Key 但不确定 Base URL 该填官网还是 API 地址的人以及想确认「请求到底有没有真的打出去、有没有计费」的人。全程 TaoToken 只提供 Key 和 Base URL 两样东西不参与 Bun 的打包、热重载、Isolate 沙箱或运行时自省Bun 该怎么用还是怎么用。2. 前置注册 TaoToken 并创建一把 Key在配置 Claude Code 之前先把模型通道的凭证准备好。这一步不涉及 Bun任何终端里都能做。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册账号登录后进入控制台。控制台里找到 API Keys 相关入口新建一把 Key。创建时建议给它起一个能认出来的名字比如bun-claude-code-local方便后面在调用记录里对照。Key 只在创建时完整显示一次复制出来先放到安全的地方别直接提交到 Git。这里有个容易混的点官网地址和 API 地址不是一回事。官网是给人看的页面API 地址才是程序请求要填的。TaoToken 的 API 地址是https://taotoken.net/api注意两点不要在后面加/v1也不要把它填成官网首页地址。Claude Code 这类工具在配置 Base URL 时通常自己会拼接后续路径你多写一段/v1反而会拼出重复路径导致 404。Key 就用刚才创建的那把Base URL 就用上面这个。如果你后面还要做更长期的编码任务或者 Agent 类工作流可以顺带了解一下 Coding Plan它更适合持续性的编码场景只是本篇这种「跑通一条最小请求」的验证用刚创建的普通 Key 就够了。3. 可复制配置在 Bun 1.3 环境里接上 Claude Code先确认 Bun 版本。终端里执行bun --version确认输出是 1.3.x 或更高。如果还没装按 Bun 官方指引装好即可这一步和模型通道无关。接下来配置 Claude Code 的模型通道。Claude Code 读取的是环境变量核心是两项Base URL 和 API Key。在项目目录下建一个.env文件或者在 shell 里导出都可以。用.env更清晰# .env ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_API_KEY你刚创建的那把Key如果你习惯直接在终端里导出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你刚创建的那把Key这里再强调一次ANTHROPIC_BASE_URL填https://taotoken.net/api不带/v1也不是官网地址。很多人填错就是在这两个地方二选一选错了。然后写一个最小的 Bun 脚本用来确认 Bun 运行时本身没问题同时把环境变量读进来打印一下不要打印完整 Key只打印前几位做确认// check-env.ts const baseUrl process.env.ANTHROPIC_BASE_URL; const apiKey process.env.ANTHROPIC_API_KEY; if (!baseUrl || !apiKey) { console.error(缺少 ANTHROPIC_BASE_URL 或 ANTHROPIC_API_KEY); process.exit(1); } console.log(Base URL:, baseUrl); console.log(Key 前缀:, apiKey.slice(0, 8) ...); console.log(Bun 版本:, Bun.version);用 Bun 跑bun run check-env.ts预期输出里 Base URL 应该是https://taotoken.net/apiKey 前缀能对上Bun 版本是 1.3.x。这一步只是确认环境变量被正确读取还没发模型请求。4. 验证请求发一条最小请求并确认调用记录环境变量确认无误后启动 Claude Code。在项目目录下执行claude进入交互界面后发一条最小请求比如用一句话说明 Bun 的启动速度优势。如果通道配置正确Claude Code 会正常返回内容。这一步能返回说明请求已经通过https://taotoken.net/api打出去了。但「有返回」还不等于「调用被记录」。要确认这次消耗回到 TaoToken 控制台打开调用记录或用量页面看最近一条记录时间应该对得上你刚才发请求的时刻模型名称、消耗量这些字段应该有值。能看到这条记录才算真正跑通——请求发出去了、模型返回了、用量也计上了。如果你更想先在网页里直接验证模型通道是否可用可以打开模型对话页面发一条同样的请求确认返回正常后再回到 Claude Code 里操作。两条路径用的是同一套 Key 和 Base URL网页能通Claude Code 基本也能通。实测下来最容易出问题的不是 Bun而是 Base URL 多写了/v1或者填成了官网地址。这两个错误都会让请求打到错误路径上表现可能是 404也可能是连接被拒。5. 本篇常见错排查报错一404 Not Found。最常见原因是 Base URL 写成了https://taotoken.net/api/v1。去掉/v1只保留https://taotoken.net/api。Claude Code 会自己拼接后续路径你多写一段就重复了。报错二401 Unauthorized。Key 不对或者没被读到。先确认.env里的ANTHROPIC_API_KEY和创建时复制的一致没有多余空格或换行。如果你是在 shell 里 export 的确认当前终端会话就是执行claude的那个会话换一个终端窗口环境变量就没了。报错三请求发出去了但调用记录里没有。先确认你看的是不是同一个账号下的记录。如果 Key 是在 A 账号创建的记录自然在 A 账号里。另外记录可能有几秒延迟刷新一下再看。报错四Bun 脚本里读不到环境变量。Bun 默认会读取.env但如果你在脚本里手动process.env读取确认.env和脚本在同一目录或者用bun --env-file.env run check-env.ts显式指定。报错五Claude Code 启动后仍提示未配置。有些情况下 Claude Code 需要重启才能读到新的环境变量。退出后重新执行claude再试。排查顺序建议先看 Base URL 有没有多写/v1再看 Key 有没有被正确读取最后看调用记录。这三步能覆盖绝大多数情况。6. 跑通之后Key 和 Base URL 的分工要清楚在 Bun 1.3 环境里把 Claude Code 拉起来核心动作就两个创建一把 Key把 Base URL 填成https://taotoken.net/api。Bun 负责运行时、打包、热重载这些事TaoToken 只负责提供 Key 和 Base URL两边各管各的不互相干扰。如果你后面要长期在 Bun 里做编码任务或者 Agent 工作流可以看看 Coding Plan它更适合持续性的编码场景。日常接入和排障API Keys 页面和接入文档是最先要看的两处。想先在网页里验证模型通道模型对话页面发一条请求最快。跑通这条最小请求之后你可以把同样的配置用到 Claude Agent SDK 或者其他基于 Anthropic 接口的工具里Base URL 和 Key 的填法是一致的。先把这条通道验证通后面换工具、换项目配置逻辑都不用重新摸。
返回列表