Kilo Code 账户与集成管理指南:试用期到期处理与解除 GitHub 连接

原创2026-09-12 15:22:561,954 阅读
文章标签:人工智能AI 应用AI Agent代码智能体开发工具IDECLIMCP Clients

Kilo Code 账户与集成管理指南:试用期到期处理与解除 GitHub 连接

本篇指南围绕 Kilo Code(Kilo 一体化 Agent 工程平台)的账户与集成两大核心问题展开:一是组织试用期结束后会发生什么、剩余积分如何处理;二是如何通过 GitHub 账户设置彻底解除 Kilo Connect 集成,以及解除后如何重新连接。读完本文,你将掌握 Kilo 账户生命周期管理、GitHub(及 GitLab、DoltHub)集成的连接/断开/排查全流程,并了解背后由 Kilo Connect 驱动的 GitHub 集成是如何工作的。


一、账户篇:试用期结束后会发生什么

Kilo Code 为组织(Organization)环境提供试用机制。根据官方 FAQ(见 account-and-integration.md),当试用期到期(trial expires)后,会发生三件事:

  1. 组织将变得不可访问(Your organization will become inaccessible)——试用结束后,组织环境会停止服务,无法继续使用。
  2. 不会产生任何扣费(No charges will be applied)——试用到期不会自动转为付费或产生账单。
  3. 剩余积分可申请转移——如果组织账户中还留有积分,可以联系 Kilo 官方 Support,申请将这些积分转移到你的个人账户(personal account)。

理解 Personal 与 Organization 环境的积分隔离

要理解"积分转移"的必要性,需要先知道 Kilo 的计费模型。官方 FAQ(见 credits-and-billing.md)明确指出:

Kilo credits are not shared between Personal and Organization environments.

即 Kilo 积分在个人环境与组织环境之间不互通,每个环境各自维护独立的余额与用量统计,以保证计费清晰和访问控制。这也解释了为什么文档建议把组织剩余积分转移到个人账户——因为组织一旦不可访问,其积分池无法直接在个人环境中使用。

积分与环境切换的实操

由于积分按环境隔离,如果你在某个环境有积分、却在另一个环境使用,就可能看到余额偏低或用量警告。FAQ 给出的修复方式如下:

  • 在 IDE 中:使用环境选择器(environment selector)下拉框,切换到持有积分的账户(Personal 或具体 Organization)。
  • 在 CLI 中:运行斜杠命令切换环境:
/teams

然后选择你想要使用的环境。该命令的实现位于 kilo-commands.tsx,源码注释说明 /profile 与 /teams 命令仅在连接 Kilo Gateway 时可见,且 kilo.teams 命令会调用 sdk.client.kilo.profile() 获取当前用户资料,再通过 sdk.client.kilo.organization.set(...) 完成组织切换(kilo-commands.tsx)。

账户与积分相关的其他注意点

  • 试用结束后组织不可访问,属于预期行为而非故障;在决定是否续费前,可先按上文把积分转移至个人账户,避免资源浪费。
  • 个人账户与组织账户的积分池相互独立,切换环境后请确认当前使用的是正确的积分池。

二、集成篇:解除 GitHub 账号连接

Kilo Connect 是什么

在介绍解除连接之前,有必要明确"Kilo Connect"在整个集成体系中的定位。根据官方文档(见 kilo-connect.md):

Kilo Connect 将 Kilo Code 带入你的团队已在使用的工具中。无需切换到独立界面,你可以从聊天、问题跟踪器或代码评审工作流中直接触发实现、提问并获得拉取请求。

Kilo Connect 支持的集成入口如下表:

集成 入口 能做什么
Slack 任意频道或 DM 中 @Kilo 提问、实现修复、调试问题
GitHub Issue 与 PR 上 @kilocode-bot 修复 Issue、审查代码、跨仓库变更
Linear 任意 Issue 上 @kilo 实现修复、调查 Bug、跨仓库变更
DoltHub 从 Integrations 连接 DoltHub 查询 Dolt 版本化数据、为 Gas Town Wasteland 授权

所有集成都通过 app.kilo.ai 的 Integrations 标签页统一配置。连接任何集成都需要:一个带可用积分的 Kilo Code 账户、已安装并授权到工作区的集成、以及一个已连接的 Git 提供商(GitHub 或 GitLab)用于 Cloud Agents、Code Reviews 和 Kilo Deploy 等仓库工作流。

解除 GitHub 连接,本质就是移除 Kilo Connect 这个 GitHub App 的授权。

解除 GitHub 连接的完整步骤

当你的组织不再使用 Kilo、更换账号或想收紧仓库访问权限时,需要解除 GitHub 集成。FAQ 给出的官方流程如下(完整版见 account-and-integration.md):

  1. 进入 GitHub 账户,导航到 Settings → Applications → Installed GitHub Apps(也可以直接访问 https://github.com/settings/installations)。
  2. 在已安装应用列表中找到 Kilo Connect。
  3. 点击 Kilo Connect 旁边的 Configure。
  4. 在配置页面中,你可以选择:
    • Uninstall:彻底卸载该集成(完全断开 Kilo 对 GitHub 的访问);
    • Edit:编辑已连接的仓库范围(保留集成,但调整哪些仓库被授权给 Kilo)。

💡 提示:如果之后想重新连接 GitHub,只需打开你的 Kilo Code 个人资料,进入 Integrations,再次连接 GitHub 即可。

从 Kilo 侧管理或移除集成

除了从 GitHub 侧卸载,也可以从 Kilo 的 Integrations 页面管理连接(见 integrations.md):

  • 在 Integrations 页面点击 "Manage on GitHub",可以:
    • 查看已连接的 GitHub 账户;
    • 更新 Kilo 有权访问的仓库列表;
    • 完全断开 GitHub;
    • 在权限变更后重新授权该应用。

需要注意:从 GitHub 侧卸载 Kilo Connect 是最彻底的解除方式;而从 Kilo 侧断开则更适用于"暂停使用但保留配置"的场景。

解除连接后的连带影响

从源码与文档结构看,解除 GitHub 连接会连带影响依赖仓库访问的功能:

  • Cloud Agents:在云端运行 Kilo Code、自动创建分支并持续推送代码的能力将不可用;
  • Code Reviews:在每次 PR/MR 上自动进行的 AI 代码评审将停止;
  • Kilo Deploy:从 Kilo 直接部署 Next.js 14/15 应用、推送时自动触发重建的能力将失效;
  • @kilocode-bot:在 GitHub Issue、PR 和评审评论上 @ 机器人的交互(读上下文、访问仓库、回答/评审/完整实现)将无法工作(见 github.md)。

重新连接与常见排查

重新连接很简单:打开 Kilo Code 个人资料 → Integrations → 重新连接 GitHub,然后按需安装 Kilo Code Bot GitHub App(github.com/apps/kilo-code-bot)到相关仓库。

官方文档(github.md)给出的常见问题与排查建议:

  • 机器人对 @ 提及没有响应:确认 Kilo Code Bot GitHub App 已安装到该仓库,并且你 @ 的是 @kilocode-bot(而不是 @kilo)。
  • 机器人无法访问仓库:确认 KiloConnect App 与 Kilo Code Bot App 都已安装且拥有该仓库的访问权限——这正是"只卸载了 Bot、没卸载 Connect"或相反情况下的典型症状。
  • 实现结果与预期不符:在 Issue 描述或评论中提供更多上下文,机器人对描述清晰的问题与目标效果处理得最好。

三、延伸:Kilo 集成体系的底层视角

Kilo 的集成能力在代码层面有清晰的组织。核心包 packages/core 中专门设有 integration 模块(integration/connection.ts),其通过 @opencode-ai/schema/connection 复用统一的 Connection 模式,导出 CredentialInfo、EnvInfo、Info 等类型——这意味着 GitHub/GitLab 等外部服务的凭据、环境与连接信息在 Kilo 核心层被统一建模,与账户、计费模块解耦。

结合 account/sql.ts 的存在可以推断:账户与组织信息在数据库层有独立的持久化结构,这为"组织环境隔离积分""试用期到期后组织不可访问"等账户行为提供了数据支撑。

对于 JetBrains 用户,Kilo 后端同样实现了连接服务(KiloBackendConnectionService),与 VS Code 侧的连接服务保持一致的设计,确保多 IDE 环境下集成状态的一致管理。


总结

场景 关键操作
试用期结束 组织不可访问、不自动扣费;联系 Support 将剩余积分转移至个人账户
积分显示偏低 用 IDE 环境选择器或 CLI /teams 命令切换到正确的环境
解除 GitHub 连接 GitHub → Settings → Applications → Installed GitHub Apps → Kilo Connect → Configure → Uninstall 或 Edit 仓库范围
重新连接 GitHub Kilo Code 个人资料 → Integrations → 重新连接 GitHub,并确保两个 App 都已安装
机器人无响应/无权限 确认 KiloConnect App 与 Kilo Code Bot App 都已安装且授权到对应仓库

掌握以上账户与集成管理要点,即可在试用到期、团队迁移或权限调整时,安全、可控地管理 Kilo Code 的账户生命周期与第三方集成授权。

登录后查看全文
kilocode