Kilo Code 团队计费与订阅管理完全指南Seats、Credits 与 Kilo Pass 实战【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode导读本指南围绕 Kilo Code 团队版Teams / Enterprise的计费体系展开系统讲解其每月按席位订阅 按用量扣减 Kilo Credits的两段式计费模型、组织信用额度的购买与使用流程、席位Seat的增减与按比例计费规则、面向组织的 Kilo Pass 池化订阅、自动充值Automatic Top-Up以及发票与欠费停服机制。读完本文你将能独立完成组织信用额度的购买与分配、席位容量管理、Kilo Pass 分配以及自动充值的配置与故障排查并理解这些操作在 Kilo Code 客户端与网关侧的实际实现路径。一、Kilo 的透明两段式计费模型Kilo 团队计费采用一套透明、可预测的两部分计费体系见 billing.md每月按席位per-seat订阅为组织内的每位成员Seat支付固定月费购买的是团队的成员资格容量。按用量付费的 Kilo CreditsPAYG模型推理按用量从信用额度中扣减用多少扣多少。这套模型有三个关键约定模型推理零加价通过 Kilo Gateway 进行的模型推理按各模型提供商Provider的 API 价格计费Kilo 不加任何 markup。1 美元信用 1 美元用量购买的 1 美元 Credits 对应 1 美元的推理/计量服务用量如云算力。5% 支付处理费单独收取购买 Credits 时产生 5% 的支付处理费该费用单独计收不会进入组织的信用余额即不会增加可用额度。重要区分Teams / Enterprise 的席位购买与 Kilo Credits 是两条相互独立的资金通道。购买 Teams / Enterprise 席位不包含任何 Kilo Credits两者的余额互不通用。这一订阅 用量分离的设计与仓库中的实现一一对应packages/kilo-gateway/src/api/profile.ts中的fetchBalance负责读取信用余额而 Kilo Pass 的订阅状态则由packages/kilo-gateway/src/api/kilo-pass.ts单独获取两者在客户端 profile 接口中被并行聚合见 kilo-gateway.ts从而在 UI 上同时呈现信用余额与订阅周期两个独立维度。二、组织信用额度Organization Credits2.1 什么是组织信用额度组织信用额度Organization Credits是由组织所有者Organization Owner在 Organization dashboard 上购买的信用额度代表整个组织的共享资金池信用额度以组织名义为组织内所有用户统一购买组织的每一位成员都可以使用组织余额中的信用额度配合Kilo Code 模型提供商Kilo Code model provider进行推理组织额度的使用方式与个人额度完全一致只是扣款来源从个人账户变为组织的共享余额。从源码结构看这一共享余额正是通过fetchBalance携带的x-kilocode-organizationid请求头实现的packages/kilo-gateway/src/api/profile.ts#L77-L79在传入组织 ID 时附加该请求头向/api/profile/balance拉取对应组织的余额——这从实现层面印证了余额按组织隔离、按组织共享的设计。2.2 购买组织信用额度的步骤在 dashboard 中进入Organization组织选项卡点击Buy More Credits购买更多额度选择额度档位提供$50、$100、$250、$500、$1000等档位使用已保存的支付方式完成支付额度立即可用供团队成员使用。2.3 使用组织信用额度组织成员使用组织额度的方式如下打开 Kilo Code 扩展的Profiles配置文件选项卡在下拉菜单中选择正确的组织 Profile而非个人 Profile后续使用 Kilo Code 模型提供商的推理消耗将从该组织的信用余额中扣除。提示若下拉菜单中看不到目标组织需确认你已被邀请进该组织且邀请已被接受并确认当前账号为 OAuth 登录方式Kilo 云账号因为组织相关能力依赖 Kilo 云账户体系。三、席位订阅管理Managing Seats Subscriptions3.1 席位容量规则要向 Kilo Code 组织添加成员Member必须先有可用的席位Seat。席位管理遵循以下规则操作规则购买席位账单周期内的任意时刻都可购买按剩余天数计算按比例pro-rated费用移除空席位任意时刻都可移除空席位下一期账单将按更少的席位数计费账单日增加/移除席位不会改变下一次账单日期移除成员必须先移除成员、释放席位才能移除该席位关于成员管理邀请、移除、角色变更详见团队管理文档。3.2 添加席位Adding Seats进入Organization组织选项卡点击Add Seats添加席位输入需要增加的席位数查看当前账单周期内的按比例费用确认变更。3.3 移除席位Removing Seats进入Organization组织选项卡点击Remove Seats移除席位选择要移除的席位必须先移除对应的团队成员腾出空席位确认缩减。若席位缩减后仍有成员待处理可先参考团队管理文档将成员移除或填充空席位再进行席位删除以避免成员失去访问权限。四、面向组织的 Kilo PassKilo Pass for Organizations4.1 组织级订阅与额度池化组织可以在组织层面订阅 Kilo Pass将订阅的信用容量池化到整个团队取代每位成员各自持有个人 Kilo Pass 的方式。个人 Kilo Pass 订阅保持独立不受组织级订阅影响。组织级 Kilo Pass 的核心规则每个席位一张 Pass购买容量始终与付费席位数匹配并随席位的增加/移除自动调整池化额度每个服务周期service window的 Kilo Pass 信用额度发放到组织的额度池而非个人名下子组织分配若组织存在直接子组织child organizations可以将池化容量的一部分分配给每个子组织未分配的容量保留在父组织。4.2 管理入口与权限组织所有者Owners和计费管理员Billing Managers可以在组织 dashboard 的Subscriptions订阅页面上购买组织级 Kilo Pass管理含调整子组织的容量分配取消订阅——取消在当前付费周期结束时生效。普通成员看不到这些控制项即订阅管理对常规成员完全不可见。4.3 过度分配Overallocation处理若席位缩减导致已分配容量超过剩余容量订阅将进入**过度分配overallocated**状态。此时 Subscriptions 页面会引导你逐步完成对账reconciling将分配恢复到容量以内。4.4 源码中的 Kilo Pass 状态模型Kilo Pass 的订阅状态在客户端侧有明确的 Schema 定义见 kilo-gateway.tsexport const KiloPassState Schema.Struct({ currentPeriodBaseCreditsUsd: Schema.Finite, // 当前周期基础信用额度美元 currentPeriodUsageUsd: Schema.Finite, // 当前周期已用量美元 currentPeriodBonusCreditsUsd: Schema.Finite, // 当前周期奖励信用额度美元 nextBillingAt: Schema.optional(Schema.NullOr(Schema.String)), // 下次账单时间 })对应地packages/kilo-gateway/src/api/kilo-pass.ts中的fetchKiloPassState通过/api/trpc/kiloPass.getState接口拉取订阅状态并做了一层关键过滤云端返回的订阅记录即使已取消也仍会返回但只有active、past_due、trialing三种状态会被视为可消费的 Pass见packages/kilo-gateway/src/api/kilo-pass.ts#L15-L23其余状态一律返回null。这保证了客户端 UI 不会展示已失效的订阅数据。五、自动充值Automatic Top-Up5.1 功能概述自动充值为团队提供不间断的 Kilo Code 访问保障开启后组织的信用余额会自动保持有资金无需手动反复充值。该功能同样适用于个人账户详见添加额度文档。5.2 工作原理初始验证开启功能时会立即按你选择的充值金额处理一次性扣款用于验证支付方式有效性自动阈值开启后每当余额低于$50.00系统自动触发充值灵活性可随时关闭自动充值无过期购买的任何信用额度永不过期会一直保留在账户中直至用完。支付失败警告若支付失败系统会通过邮件通知你并自动暂停自动充值以避免重复扣款尝试。你可以在设置中随时恢复该功能。5.3 配置步骤进入Organization Settings组织设置选择Billing Credits计费与额度找到Automatic Top-Up区块将开关切换为ON设置Top-Up Amount充值金额——即每次触发充值时要添加到余额的金额注意充值金额最低为 $100.00。点击Save Changes保存更改确认。保存后系统会立即处理首次充值以验证支付方式。六、发票与服务暂停机制Invoices Service Suspension6.1 发票InvoicesKilo Code 平台上任何付款——无论席位订阅还是信用额度购买——的发票都会出现在Invoices发票选项卡中可在 dashboard 统一查看与下载。6.2 服务暂停Service Suspension若支付持续失败将进入如下处置流程阶段说明3 天宽限期用于解决支付问题服务暂停宽限期结束后服务被暂停数据保留 30 天暂停期间数据保留 30 天立即恢复支付问题解决后服务立即恢复该机制确保了先宽限、再暂停、留数据、快恢复的阶梯式保护策略既给用户补救时间也避免数据因欠费立即丢失。七、客户端侧的实现印证为了让上述计费概念在 Kilo Code 扩展/CLI 中真正生效客户端与 Kilo 云服务之间存在一条完整的 HTTP 通道相关定义见 kilo-gateway.ts/kilo/profile聚合返回用户资料、组织列表、信用余额与 Kilo Pass 状态ProfileWithBalance结构是扩展侧展示余额与订阅的单一数据源/kilo/organizationPOST切换当前生效的 Kilo Gateway 组织——packages/opencode/src/kilocode/server/httpapi/handlers/kilo-gateway.ts#L346-L364的实现会在切换时更新本地 OAuth 凭据中的accountId、清空该组织的模型缓存与 modes 缓存并释放相关实例确保后续请求都归属新组织组织隔离fetchBalance通过x-kilocode-organizationid请求头读取组织余额FIM / Edit / 转写等推理代理请求同样携带组织 ID 请求头见kilo-gateway.ts#L145-L148从工程上保证个人余额与组织余额互不串用。这些实现细节说明你在 dashboard 上完成的额度购买、席位增减与 Kilo Pass 分配最终会通过这套网关接口实时反映到每位成员的扩展侧 UI 中——余额、订阅与组织切换全部可以在 Profiles 下拉菜单与设置页直接看到。八、操作速查表目标入口关键要点购买组织信用额度Organization 选项卡 → Buy More Credits档位 $50 / $100 / $250 / $500 / $1000即时到账使用组织额度扩展 Profiles 选项卡 → 选择组织 Profile消耗走组织余额而非个人余额添加席位Organization 选项卡 → Add Seats按剩余天数 pro-rated 计费移除席位Organization 选项卡 → Remove Seats先移除成员腾出空席位组织级 Kilo Passdashboard → Subscriptions 页面每席位一张 Pass容量池化可分配子组织自动充值Organization Settings → Billing Credits阈值 $50.00单次最低 $100.00查看发票dashboard → Invoices 选项卡席位与额度付款均出票欠费处理邮件通知 暂停自动充值3 天宽限 → 暂停 → 数据保留 30 天 → 恢复延伸阅读团队管理成员角色与邀请/移除个人额度与 Kilo Pass、BYOK 说明团队用量分析【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考