对比
Apothem 对比手工接入 GLM 后端
为什么要通过 Apothem 来路由 GLM（Z.ai）后端配置，而不是按项目手工接入环境变量。
GLM（Z.ai）是一个模型后端，兼容的工具通过设置基础 URL 和密钥来指向它。你可以手工导出这些环境变量，每个项目、每台机器，永远如此。Apothem 的 glm 适配器把后端端点和可由操作者配置的占位符记录在一个提供方文件中，并把同一份模板写入每个项目。本页将手工接入该后端与用 Apothem 管理它作对比。
工作量对比
| 任务 | 手工配置 | Apothem 托管 |
|---|---|---|
| 记录后端 URL | 记住并在每个项目中重新导出 | 写入一个提供方文件 |
| 事实来源 | 每个 shell 各自的导出 | 一个规范的提供方文件 |
| 让各项目的后端保持一致 | 逐项目重新接入 | 文件不存在时，同一份模板会被写入每个项目；之后的编辑保留在各项目自己的文件中 |
| 恢复配置 | 在每个项目中重新导出 | apothem update --harness glm --project <path> 仅在文件缺失时才会再次写入该文件 |
| 移除配置 | 手动删除 | apothem uninstall 会先备份该文件，然后仅当它仍是 Apothem 所写入的未经编辑的模板时，才会将其移除 |
Apothem 管理什么
glm 适配器在 <project>/.apothem/providers/glm.toml 处写入单个提供方文件，不写入任何其他内容。它记录 Anthropic 兼容基础 URL（https://api.z.ai/api/anthropic）、OpenAI 兼容基础 URL（https://api.z.ai/api/coding/paas/v4）、一个认证令牌占位符以及模型映射占位符。你的 Z.ai 密钥和模型 ID 选择仍归操作者所有——Apothem 绝不写入真实的机密，也不锁定任何随版本变化的模型 ID。
迁移路径
- 如果你还没有创建共享配置档案，运行
apothem profile init来创建它。 glm 文件不从配置档案中取用任何内容，但每次安装和更新运行都会加载它。 - 运行
apothem install --harness glm --project <path>来写入glm.toml提供方文件。 - 根据当前的 Z.ai 文档填入你的 Z.ai 密钥和所需的模型 ID。
- 运行
apothem verify --harness glm --project <path>来确认配置已落地。 - 之后的每次更改都编辑
.apothem/providers/glm.toml。Apothem 绝不会重写已存在的提供方文件；仅当该文件缺失时，apothem update --harness glm --project <path>才会再次写入它。