一、ARM 机器上 kkFileView 起不来问题到底卡在哪客户要求把文件预览服务部署到 ARM 架构的机器上所有 Docker 镜像都得重新打包。原本用的是 kkFileView但开源版本已经停止更新官方 Dockerfile 里下载 LibreOffice 的链接早就失效了而且那个版本本身也不支持 ARM。于是第一反应是升级 LibreOffice照着原来的 Dockerfile 替换源、替换版本号重新构建镜像——结果容器还是起不来。继续排查发现是缺依赖。离线安装包在 ARM 上装不全折腾了很久才意识到制作 Docker 镜像时根本不需要用离线安装包直接用apt-get在线安装反而更干净。这一步走通之后kkFileView 总算能在 ARM 上跑起来了。但这件事暴露了一个更根本的问题kkFileView 开源版停更后续维护成本只会越来越高。既然团队已经在用 Solon 框架不如自己写一个轻量的文件预览服务重点解决 Office 文档转 PDF 的需求就够了。于是用 Solon 模板项目生成器搭了初始化工程准备让 Claude Code 来帮忙完成后续的开发。这里要说明的是TaoToken 在整条链路里只负责给 Claude Code 提供 Key 和兼容通道镜像层怎么构建、LibreOffice 用哪个版本仍然需要你在本地实际验证。它的作用是把 Claude Code 的请求接进来让你能对着 Dockerfile 片段和报错信息逐层排查依赖问题。如果你也遇到类似的情况——ARM 环境、依赖缺失、官方镜像不可用——可以先去 TaoToken 官网 注册一个账号创建一个 API Key然后把 Claude Code 的 Base URL 指向兼容通道让它帮你梳理依赖清单和排查思路。二、TaoToken 前置注册、创建 Key、配置 Claude Code在让 Claude Code 介入排查之前需要先把它接到 TaoToken 的兼容通道上。步骤不复杂但有几个容易填错的地方需要留意。第一步注册并创建 Key打开 TaoToken 官网完成注册后进入控制台在 API Keys 页面创建一个新的 Key。这个 Key 就是后面 Claude Code 用来发请求的凭证格式类似YOUR_API_KEY。第二步配置 Claude Code 的 Base URLClaude Code 需要知道请求发往哪里。Base URL 填https://taotoken.net/api注意几点不要填官网首页地址不要在后面加/v1不要带 UTM 参数配置方式是在 Claude Code 的settings.json里设置ANTHROPIC_BASE_URL环境变量或者直接在终端里导出。具体来说ANTHROPIC_BASE_URL的值就是https://taotoken.net/apiANTHROPIC_API_KEY的值就是你刚创建的 Key。第三步确认通道可用配置完成后可以先发一个简单的请求验证通道是否打通。如果返回正常说明 Claude Code 已经能通过 TaoToken 的兼容通道发请求了。这时候再回到官网控制台看调用记录里是否有对应的请求确认计费和调用都正常。第四步用同一把 Key 继续后续工作通道验证通过后不需要换 Key。后面让 Claude Code 补 JODConverter 转换逻辑、生成预览页面都用同一把 Key 就行。TaoToken 在这里的角色是稳定的请求入口不参与你本地的镜像构建和依赖安装。三、可复制配置让 Claude Code 对着 Dockerfile 排查依赖配置好通道之后就可以让 Claude Code 介入排查了。核心思路是把 Dockerfile 片段和报错信息一起丢给它让它逐层分析缺了哪些依赖、LibreOffice 版本是否匹配 ARM 架构。Claude Code 的 settings.json 配置示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: YOUR_API_KEY } }如果你用的是 CLI 方式也可以直接通过命令行启动npm i -g taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m MODEL_ID给 Claude Code 的排查提示词把下面这段提示词连同 Dockerfile 片段一起发给 Claude Code这是一个在 ARM 架构上构建 kkFileView 的 Dockerfile 片段。 官方下载 LibreOffice 的链接已失效且原版本不支持 ARM。 我替换了源和版本号但容器仍然启动失败报错信息如下 [粘贴报错日志] 请帮我 1. 分析当前 Dockerfile 中 LibreOffice 的安装方式有什么问题 2. 列出在 ARM 上运行 LibreOffice 所需的完整依赖清单 3. 给出改用 apt-get 在线安装的 Dockerfile 修改建议 4. 指出哪些步骤需要在本地实际构建验证哪些可以先用文档确认关键点Claude Code 会根据你提供的 Dockerfile 片段和报错信息逐层分析依赖关系。它可能会指出离线安装包在 ARM 上缺少某些.so库或者apt-get源里需要额外启用contrib和non-free仓库。这些分析结果需要你在本地实际构建时验证不能直接照搬。另外如果你在提示词里明确告诉它“先不要生成代码把方案写到 doc 目录”它会先输出一份依赖清单和修改方案而不是直接改 Dockerfile。这样你可以先审核方案再决定是否让它动手。四、验证请求与成功结果配置完成后需要验证两件事一是 TaoToken 通道是否正常二是 Claude Code 给出的排查方案是否有效。验证通道在 Claude Code 里发一条简单的请求比如让它解释一段 Dockerfile 指令。如果它能正常返回内容说明ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY都配置正确。然后回到 TaoToken 控制台在调用记录里确认这次请求已经成功计费。验证排查结果把 Claude Code 给出的依赖清单和 Dockerfile 修改建议拿到本地实际构建。重点看几个地方apt-get install是否包含了 LibreOffice 的核心包和 ARM 架构对应的依赖容器启动后libreoffice --version是否能正常输出JODConverter 调用 LibreOffice 时是否报UnsatisfiedLinkError或类似的本地库缺失错误如果本地构建通过容器能正常启动并且 Office 文档转 PDF 的功能可用说明整条链路已经打通。继续用同一把 Key 补功能Dockerfile 排查完之后可以让 Claude Code 继续补 JODConverter 的转换逻辑和预览页面。提示词可以这样写现在 Dockerfile 已经能在 ARM 上正常构建LibreOffice 也能用了。 请帮我补全 JODConverter 的配置实现 Office 文档转 PDF 的功能。 转换后的 PDF 需要能通过 Web 界面预览。 先给出方案写到 doc 目录不要直接生成代码。这样它会先输出一份方案文档你审核后再让它生成代码。整个过程用的还是同一把 Key不需要重新配置。五、本篇常见错排查Base URL 填错最常见的问题是 Base URL 填成了官网首页或者加了/v1或者带了 UTM 参数。正确的值就是https://taotoken.net/api不要加任何后缀。如果填错Claude Code 会报 404 或连接超时。Key 无效或过期如果控制台里能看到 Key但请求一直返回 401检查一下 Key 是否复制完整有没有多余的空格。另外确认 Key 没有过期或被禁用。ARM 上 LibreOffice 仍然缺依赖Claude Code 给出的依赖清单是基于你提供的报错信息分析的但实际环境可能有差异。如果apt-get install之后仍然报缺库用ldd检查 LibreOffice 的二进制文件依赖了哪些.so然后逐个确认是否已安装。JODConverter 找不到 LibreOffice如果转换时报office.home相关的错误检查 JODConverter 的配置里office.home是否指向了正确的 LibreOffice 安装路径。在 Docker 容器里这个路径通常是/usr/lib/libreoffice。Claude Code 生成的代码包含 Spring 注解即使CLAUDE.md里已经声明了 Solon 框架Claude Code 仍然可能引入 Spring 的依赖和注解。这是因为 Spring 的公开资料比 Solon 多模型在生成代码时会倾向于使用更常见的方案。遇到这种情况需要手动把 Spring 注解替换成 Solon 对应的写法或者直接在提示词里明确要求“只使用 Solon 框架不要引入 Spring 依赖”。包路径错误Solon 的包路径和 Spring 不同Claude Code 生成的代码里可能会出现org.springframework.*的导入。这些都需要手动改成org.noear.solon.*或对应的 Solon 包路径。建议在生成代码后先编译一遍根据编译错误逐个修正。六、语义一致的 CTA整条链路走下来TaoToken 的作用是给 Claude Code 提供一个稳定的请求入口。你用它来对着 Dockerfile 排查依赖、补 JODConverter 转换逻辑、生成预览页面但镜像构建和本地验证仍然由你自己完成。如果你正在处理类似的 ARM 部署问题或者想让 Claude Code 帮你排查 Dockerfile 里的依赖缺失可以先去 TaoToken 官网 注册并创建 Key然后把 Claude Code 的 Base URL 配成https://taotoken.net/api。配通之后回控制台确认调用成功再用同一把 Key 继续后续的开发工作。需要查接入文档的话可以看 API 接入文档如果后面要长期用 Claude Code 做编码和 Agent 任务可以了解 Coding Plan。