Plandex Cloud 托管服务与计费管理完全指南计费模式、usage 命令与数据隐私【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex本文围绕 Plandex 官方托管云服务Plandex Cloud展开系统讲解其两种计费模式Integrated Models 与 BYO API Key、试用与升级流程、billing与usage命令的完整用法以及云服务的数据保留与第三方共享策略。读完本文你将掌握 Plandex Cloud 账号从开通、计费、用量查询到隐私管理的完整实战链路并能结合 usage 命令源码 理解每个参数背后的实现逻辑。Plandex Cloud 是什么Plandex Cloud 是 Plandex开源 AI 编程 Agent官方提供的托管服务目标是让开发者以最简单、最可靠的方式使用 Plandex——无需自行搭建服务器、配置模型提供商或管理 API Key开箱即用。在首次启动 Plandex 交互式终端REPL或创建第一个计划时CLI 会引导你开启试用。具体触发点有两个在终端直接运行plandex启动 REPL运行plandex new创建第一个计划。:::caution 服务状态提示 根据官方文档Plandex Cloud 已于 2025 年 10 月 3 日起逐步停止运营不再接受新用户注册。本文内容适用于已经开通或正在评估存量云服务的用户同时其计费设计信用额度、订阅、用量审计对自托管方案与 CLI 理解仍具有完整参考价值。相关停运说明详见官方公告。 :::从源码看云账号与本地账号在 CLI 中被明确区分auth.Current.IsCloud字段决定了billing、models等命令是否可用见 billing.go而账号信息的持久化存储则落在本地的accounts.json与 auth 文件中见 state.go。两种计费模式对比Plandex Cloud 提供两种互斥的计费模式你可以随时在账单设置页切换。下表汇总了两者的核心差异维度Integrated Models集成模型模式BYO API Key自带 Key 模式模型支付方式使用 Plandex 信用额度credits支付 AI 模型费用使用你自己的模型提供商账号与 API Key额外账号/Key无需任何独立账号或 API Key需自行准备各模型提供商的账号与 Key计费方式按模型提供方价格扣减信用额度另加少量手续费覆盖信用卡处理成本模型费用由你的提供商直接收取试用方案10 美元试用内含 10 美元信用额度免费试用最多 10 个计划每个计划 20 次模型响应付费方案45 美元/月每月包含 20 美元信用额度且额度永不失效30 美元/月适用场景建议Integrated Models适合不想折腾 API Key、希望一个账号一站式使用的用户信用额度的自动充值、月度预算等功能也主要围绕该模式设计。BYO API Key适合已有模型提供商账号、希望复用现有额度与合同、或对成本归属有明确要求的团队。两种模式的试用入口不同集成模式与自带 Key 模式分别有独立的注册流程切换模式时也会在信用账本中产生一笔类型为switch的入账记录见下文usage --log部分。试用与升级的底层流程当你首次启动 REPL 或创建计划时CLI 会自动拉起云服务的试用流程。从 trial.go 的源码可以看到完整机制创建试用会话CLI 调用CreateCliTrialSession()向后端申请一个cliTrialToken打开浏览器用该 token 拼接出/start?cliTrialTokenxxx的地址在默认浏览器中打开试用注册页见 trial.go轮询等待CLI 以 1.5 秒为间隔轮询GetCliTrialSession(cliTrialToken)最长等待 1 小时一旦后端确认试用会话有效立即自动完成登录handleSignInResponse并输出 Trial started见 trial.go超时处理若 1 小时内未完成命令报错退出提示重试或联系 supportplandex.ai。类似地试用转付费升级时CLI 打开/settings/billing?upgrade1cliUpgrade1页面并轮询组织org会话直到IsTrial变为 false见 trial.go。升级流程的触发入口之一是tell命令执行到付费墙时的自动调用见 tell.go 与 main.go。账单设置billing 命令与网页端打开账单设置在终端运行plandex billing即可在默认浏览器中打开账单设置页也可以直接访问 Plandex 应用的 Billing Settings 页面如需登录请先登录。从源码看billing命令的实现非常直接先校验登录态再通过ui.OpenAuthenticatedURL打开/settings/billing路径见 billing.go。需要注意该命令仅对 Plandex Cloud 账号可用自托管self-hosted场景下执行会直接报错退出。在账单设置页中你可以完成以下操作切换计费模式Integrated Models ⇄ BYO API Key查看当前订阅计划管理账单信息支付方式等暂停或取消订阅。Integrated Models 模式的专属设置如果你使用的是Integrated Models 模式账单设置页还额外提供查看信用额度credits余额购买信用额度配置自动充值auto-recharge当余额低于阈值时自动补充信用额度设置月度预算monthly budget设置邮件通知阈值余额达到阈值时收到提醒邮件。usage 命令查看余额与用量明细usage命令是 Plandex Cloud 用量审计的核心工具既能看汇总余额也能逐笔查看每一次模型调用的扣费记录。命令源码位于 usage.go。基本用法# 显示当前余额与近期用量报告 plandex usage # 显示每一笔交易的完整日志含每次模型调用 plandex usage --log在 Plandex REPL 中可以直接使用\usage斜杠命令形式效果等价。时间范围控制usage的默认统计范围取决于运行环境这一行为在源码中有明确实现见 usage.go在 REPL 中默认显示当前 REPL 会话的用量通过环境变量PLANDEX_REPL_SESSION_ID判断在普通终端中默认显示**今天从本地时区 0 点起**的用量。如需显式指定时间范围使用以下三个标志plandex usage --today # 显示今天从零点起的用量 plandex usage --month # 显示当前计费月的用量 plandex usage --plan # 显示当前计划plan的用量其中--month的报表会附带计费月起始日MonthStart--plan则需要先解析当前工作目录所属的项目与计划见 usage.go。过滤交易类型配合--log使用可以只查看入账或出账# 仅查看当前计费月的扣费debits记录 plandex usage --log --debits --month # 仅查看今天的充值/购买purchases/credits记录 plandex usage --log --purchases --today底层的数据模型将每一笔交易分为两类见 data_models.godebit扣费每次模型调用产生的消费credit入账充值、赠予、试用等带来的余额增加。其中credit类型又细分为trial开始试用、grant订阅月度发放、admin_grant管理员赠予、purchase购买信用额度、switch切换到集成模型模式五种子类型见 data_models.go日志会为它们标注对应的中文语义描述。日志分页与翻页交互--log默认按页展示交易记录相关参数如下# 每页显示 100 条默认值跳到第 1 页默认值 plandex usage --log # 自定义每页条数与页码 plandex usage --log --page-size 200 --page 3 # 等价短选项 plandex usage --log -s 200 -p 3从源码看分页相关的标志定义在 usage.go--page-size/-s默认 100--page/-p默认 1且单页上限为 500 条常量MaxCreditsLogPageSize。当存在多页时CLI 会进入交互式翻页模式支持按n查看下一页按p查看上一页直接输入数字跳转到指定页按q退出。交互逻辑见 usage.go。报表内容解读汇总视图plandex usage由 usage.go 渲染包含当前余额 Current Balance与统计区间内的花费 Spent缓存节省 Cache Savings当存在缓存折扣时单独展示按计划分组 Plan列出各计划的消费金额按用途分组⚡️ Purpose如 build、tell 等不同模型调用场景按模型分组 Model列出各模型的花费。明细视图plandex usage --log中的每条 debit 记录会详细列出见 usage.go交易时间精确到毫秒归属计划Plan → 名称用途⚡️ Purpose模型 Model非 OpenAI 模型会带提供商前缀见 data_models.go每百万 token 的输入/输出价格 Price含手续费加成输入/输出 token 用量 Used缓存折扣金额与占比 Cache discount。这些字段与 CreditsTransaction 数据模型一一对应请求与响应结构定义见 req_res.go。隐私与数据保留数据保留策略使用 Plandex Cloud 时发送到云服务的数据会被保留用途包括调试与改进 Plandex未来可能用于训练和微调模型以提升性能并降低成本。如果你删除 Plandex Cloud 账号所有关联数据将在14 天内移除这一延迟是为了保障调试与备份流程。数据共享的第三方Plandex Cloud 可能会与以下第三方共享数据列表会在引入新服务时更新除列表外不与其他任何第三方共享数据第三方共享内容与用途OpenAI集成模型模式下用于 OpenAI 系列模型OpenRouter.ai集成模型模式下用于 Anthropic、Google 及其他非 OpenAI 模型Google Vertex AI集成模型模式下用于 Google 与 Anthropic 模型AWS托管与数据库服务数据在传输与存储时均加密Loops邮件营销服务你的姓名与邮箱用于发送 Plandex 更新可一键退订Stripe支付处理器订阅付费方案或购买 10 美元试用时共享姓名与邮箱Google Analytics基础使用数据用于追踪与改进Relace用于instant applyAI 模型当 Plandex 无法确定性应用编辑时作为回退输入为原始文件与 Plandex 响应中的编辑片段用于加速并降低文件编辑成本Rollbar错误跟踪与告警正常情况下不太可能包含用户数据即便包含也只是与错误上报相关的极小部分此外需要注意发送给 OpenAI、OpenRouter.ai 等模型提供方的数据将受模型提供方自身的隐私与数据保留政策约束。完整条款请参阅 Plandex 的官方 Privacy Policy。与自托管方案的边界理解 Plandex Cloud 有助于你对照 自托管部署 方案做出选择。二者在 CLI 层的核心差异在于账号体系与计费Cloud 账号auth.Current.IsCloud truebilling、云信用额度、usage等云专属命令可用本地/自托管账号无云端计费模型调用走你自行配置的模型提供方可参考 模型提供商配置 与 模型设置。对于希望完全掌控数据、或已停运后仍需要继续使用 Plandex 的团队自托管是 Cloud 的自然迁移路径而本文所讲的usage命令的报表结构、交易数据模型debit/credit 分类、缓存折扣、按计划/模型/用途分组在设计上同样适用于理解整体成本结构可作为搭建自托管成本监控时的参考蓝本。【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Plandex Cloud 托管服务与计费管理完全指南：计费模式、usage 命令与数据隐私
Plandex Cloud 托管服务与计费管理完全指南计费模式、usage 命令与数据隐私【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex本文围绕 Plandex 官方托管云服务Plandex Cloud展开系统讲解其两种计费模式Integrated Models 与 BYO API Key、试用与升级流程、billing与usage命令的完整用法以及云服务的数据保留与第三方共享策略。读完本文你将掌握 Plandex Cloud 账号从开通、计费、用量查询到隐私管理的完整实战链路并能结合 usage 命令源码 理解每个参数背后的实现逻辑。Plandex Cloud 是什么Plandex Cloud 是 Plandex开源 AI 编程 Agent官方提供的托管服务目标是让开发者以最简单、最可靠的方式使用 Plandex——无需自行搭建服务器、配置模型提供商或管理 API Key开箱即用。在首次启动 Plandex 交互式终端REPL或创建第一个计划时CLI 会引导你开启试用。具体触发点有两个在终端直接运行plandex启动 REPL运行plandex new创建第一个计划。:::caution 服务状态提示 根据官方文档Plandex Cloud 已于 2025 年 10 月 3 日起逐步停止运营不再接受新用户注册。本文内容适用于已经开通或正在评估存量云服务的用户同时其计费设计信用额度、订阅、用量审计对自托管方案与 CLI 理解仍具有完整参考价值。相关停运说明详见官方公告。 :::从源码看云账号与本地账号在 CLI 中被明确区分auth.Current.IsCloud字段决定了billing、models等命令是否可用见 billing.go而账号信息的持久化存储则落在本地的accounts.json与 auth 文件中见 state.go。两种计费模式对比Plandex Cloud 提供两种互斥的计费模式你可以随时在账单设置页切换。下表汇总了两者的核心差异维度Integrated Models集成模型模式BYO API Key自带 Key 模式模型支付方式使用 Plandex 信用额度credits支付 AI 模型费用使用你自己的模型提供商账号与 API Key额外账号/Key无需任何独立账号或 API Key需自行准备各模型提供商的账号与 Key计费方式按模型提供方价格扣减信用额度另加少量手续费覆盖信用卡处理成本模型费用由你的提供商直接收取试用方案10 美元试用内含 10 美元信用额度免费试用最多 10 个计划每个计划 20 次模型响应付费方案45 美元/月每月包含 20 美元信用额度且额度永不失效30 美元/月适用场景建议Integrated Models适合不想折腾 API Key、希望一个账号一站式使用的用户信用额度的自动充值、月度预算等功能也主要围绕该模式设计。BYO API Key适合已有模型提供商账号、希望复用现有额度与合同、或对成本归属有明确要求的团队。两种模式的试用入口不同集成模式与自带 Key 模式分别有独立的注册流程切换模式时也会在信用账本中产生一笔类型为switch的入账记录见下文usage --log部分。试用与升级的底层流程当你首次启动 REPL 或创建计划时CLI 会自动拉起云服务的试用流程。从 trial.go 的源码可以看到完整机制创建试用会话CLI 调用CreateCliTrialSession()向后端申请一个cliTrialToken打开浏览器用该 token 拼接出/start?cliTrialTokenxxx的地址在默认浏览器中打开试用注册页见 trial.go轮询等待CLI 以 1.5 秒为间隔轮询GetCliTrialSession(cliTrialToken)最长等待 1 小时一旦后端确认试用会话有效立即自动完成登录handleSignInResponse并输出 Trial started见 trial.go超时处理若 1 小时内未完成命令报错退出提示重试或联系 supportplandex.ai。类似地试用转付费升级时CLI 打开/settings/billing?upgrade1cliUpgrade1页面并轮询组织org会话直到IsTrial变为 false见 trial.go。升级流程的触发入口之一是tell命令执行到付费墙时的自动调用见 tell.go 与 main.go。账单设置billing 命令与网页端打开账单设置在终端运行plandex billing即可在默认浏览器中打开账单设置页也可以直接访问 Plandex 应用的 Billing Settings 页面如需登录请先登录。从源码看billing命令的实现非常直接先校验登录态再通过ui.OpenAuthenticatedURL打开/settings/billing路径见 billing.go。需要注意该命令仅对 Plandex Cloud 账号可用自托管self-hosted场景下执行会直接报错退出。在账单设置页中你可以完成以下操作切换计费模式Integrated Models ⇄ BYO API Key查看当前订阅计划管理账单信息支付方式等暂停或取消订阅。Integrated Models 模式的专属设置如果你使用的是Integrated Models 模式账单设置页还额外提供查看信用额度credits余额购买信用额度配置自动充值auto-recharge当余额低于阈值时自动补充信用额度设置月度预算monthly budget设置邮件通知阈值余额达到阈值时收到提醒邮件。usage 命令查看余额与用量明细usage命令是 Plandex Cloud 用量审计的核心工具既能看汇总余额也能逐笔查看每一次模型调用的扣费记录。命令源码位于 usage.go。基本用法# 显示当前余额与近期用量报告 plandex usage # 显示每一笔交易的完整日志含每次模型调用 plandex usage --log在 Plandex REPL 中可以直接使用\usage斜杠命令形式效果等价。时间范围控制usage的默认统计范围取决于运行环境这一行为在源码中有明确实现见 usage.go在 REPL 中默认显示当前 REPL 会话的用量通过环境变量PLANDEX_REPL_SESSION_ID判断在普通终端中默认显示**今天从本地时区 0 点起**的用量。如需显式指定时间范围使用以下三个标志plandex usage --today # 显示今天从零点起的用量 plandex usage --month # 显示当前计费月的用量 plandex usage --plan # 显示当前计划plan的用量其中--month的报表会附带计费月起始日MonthStart--plan则需要先解析当前工作目录所属的项目与计划见 usage.go。过滤交易类型配合--log使用可以只查看入账或出账# 仅查看当前计费月的扣费debits记录 plandex usage --log --debits --month # 仅查看今天的充值/购买purchases/credits记录 plandex usage --log --purchases --today底层的数据模型将每一笔交易分为两类见 data_models.godebit扣费每次模型调用产生的消费credit入账充值、赠予、试用等带来的余额增加。其中credit类型又细分为trial开始试用、grant订阅月度发放、admin_grant管理员赠予、purchase购买信用额度、switch切换到集成模型模式五种子类型见 data_models.go日志会为它们标注对应的中文语义描述。日志分页与翻页交互--log默认按页展示交易记录相关参数如下# 每页显示 100 条默认值跳到第 1 页默认值 plandex usage --log # 自定义每页条数与页码 plandex usage --log --page-size 200 --page 3 # 等价短选项 plandex usage --log -s 200 -p 3从源码看分页相关的标志定义在 usage.go--page-size/-s默认 100--page/-p默认 1且单页上限为 500 条常量MaxCreditsLogPageSize。当存在多页时CLI 会进入交互式翻页模式支持按n查看下一页按p查看上一页直接输入数字跳转到指定页按q退出。交互逻辑见 usage.go。报表内容解读汇总视图plandex usage由 usage.go 渲染包含当前余额 Current Balance与统计区间内的花费 Spent缓存节省 Cache Savings当存在缓存折扣时单独展示按计划分组 Plan列出各计划的消费金额按用途分组⚡️ Purpose如 build、tell 等不同模型调用场景按模型分组 Model列出各模型的花费。明细视图plandex usage --log中的每条 debit 记录会详细列出见 usage.go交易时间精确到毫秒归属计划Plan → 名称用途⚡️ Purpose模型 Model非 OpenAI 模型会带提供商前缀见 data_models.go每百万 token 的输入/输出价格 Price含手续费加成输入/输出 token 用量 Used缓存折扣金额与占比 Cache discount。这些字段与 CreditsTransaction 数据模型一一对应请求与响应结构定义见 req_res.go。隐私与数据保留数据保留策略使用 Plandex Cloud 时发送到云服务的数据会被保留用途包括调试与改进 Plandex未来可能用于训练和微调模型以提升性能并降低成本。如果你删除 Plandex Cloud 账号所有关联数据将在14 天内移除这一延迟是为了保障调试与备份流程。数据共享的第三方Plandex Cloud 可能会与以下第三方共享数据列表会在引入新服务时更新除列表外不与其他任何第三方共享数据第三方共享内容与用途OpenAI集成模型模式下用于 OpenAI 系列模型OpenRouter.ai集成模型模式下用于 Anthropic、Google 及其他非 OpenAI 模型Google Vertex AI集成模型模式下用于 Google 与 Anthropic 模型AWS托管与数据库服务数据在传输与存储时均加密Loops邮件营销服务你的姓名与邮箱用于发送 Plandex 更新可一键退订Stripe支付处理器订阅付费方案或购买 10 美元试用时共享姓名与邮箱Google Analytics基础使用数据用于追踪与改进Relace用于instant applyAI 模型当 Plandex 无法确定性应用编辑时作为回退输入为原始文件与 Plandex 响应中的编辑片段用于加速并降低文件编辑成本Rollbar错误跟踪与告警正常情况下不太可能包含用户数据即便包含也只是与错误上报相关的极小部分此外需要注意发送给 OpenAI、OpenRouter.ai 等模型提供方的数据将受模型提供方自身的隐私与数据保留政策约束。完整条款请参阅 Plandex 的官方 Privacy Policy。与自托管方案的边界理解 Plandex Cloud 有助于你对照 自托管部署 方案做出选择。二者在 CLI 层的核心差异在于账号体系与计费Cloud 账号auth.Current.IsCloud truebilling、云信用额度、usage等云专属命令可用本地/自托管账号无云端计费模型调用走你自行配置的模型提供方可参考 模型提供商配置 与 模型设置。对于希望完全掌控数据、或已停运后仍需要继续使用 Plandex 的团队自托管是 Cloud 的自然迁移路径而本文所讲的usage命令的报表结构、交易数据模型debit/credit 分类、缓存折扣、按计划/模型/用途分组在设计上同样适用于理解整体成本结构可作为搭建自托管成本监控时的参考蓝本。【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
