Coroid 在执行任何操作前都需要访问代码库。你只需在组织级别配置一次源代码管理提供商，随后即可将单个代码库关联到对应项目。
连接配置在设置 → 连接 → 源代码管理
(/settings/connections/source-control)。
连接服务提供商
GitHub 应用或令牌
设置 → 连接 → 源代码控制
代码库显示如下
该连接可访问的代码库
应用访问权限或令牌作用域
创建项目
每个代码库对应一个项目
项目 → 新建
首次分析
语言、构建和测试命令
可在项目设置中查看
支持的提供商
| 提供商 | 连接方式 | 可用性 |
|---|---|---|
| GitHub | 安装 GitHub 应用，或使用个人访问令牌 | 全面可用 |
| GitLab | 个人访问令牌 | 私有预览版 |
GitHub：应用安装或令牌
对于 GitHub，安装 Coroid GitHub 应用是更优选择。该应用按代码库而非用户授予权限，即便初始配置人员离职也能正常运行，且无需轮询即可让 Coroid 接收 Webhook 事件。
如果应用安装需要管理员审批而你没有相应权限，可选择使用个人访问令牌。
要安装该应用，请前往设置 → 连接 → 源代码管理，选择GitHub，然后按照安装流程操作。GitHub 会询问你授予哪些代码库的访问权限；后续也可从 GitHub 的设置中修改此配置。
通过个人访问令牌建立连接
先在提供商处创建令牌，然后将其粘贴到设置 → 连接 → 源代码管理。
该令牌需具备读取代码库内容、创建分支及拉取请求的权限。在 GitHub 中，传统令牌需具备repo权限；在 GitLab 中则需具备api。
令牌在存储前会经过加密处理，API 不会返回令牌内容，保存后界面中也不会再显示。令牌也不会包含在设置导出包中——导出的包中仅含占位符，导入到其他位置时需重新输入密钥。
将代码库关联到项目
连接配置仅让代码库可被访问；真正供 Coroid 运作的是项目。可在项目 → 新建中创建项目，选定已连接的代码库后，Coroid 会对代码库进行首次扫描，以识别所用语言、构建命令及测试命令。
正是这份首次分析结果能让智能体构建并测试你的项目，因此值得核对结果。若分析有误，可在项目设置中修正。
无需写入代码库即可体验 Coroid
选择仅本地模式，在创建项目时于代码库模式下勾选。此时 Coroid 会读取代码库内容，所有分支、提交及评审记录均保存在 Coroid 内部，它不会执行推送、评论或创建合并请求操作。若需生成合并请求，可选择开始同步，该选项可在任意评审页面或项目代码库设置中找到。详情请参阅同步模式或仅本地模式。
对于公开的 GitHub 代码库，无需建立任何连接：只需选择通过 URL 连接粘贴仓库地址并验证访问权限。如果没有GitHub连接，系统会默认选择本地模式，因为Coroid可以读取公共仓库，但无法向其中推送内容。
Coroid 的工作分支是哪一个
Coroid 会从默认分支派生出新分支，并针对该分支创建拉取请求。若需合并到其他分支而非main。
验证连接是否正常
当代码库出现在项目创建列表中且项目的首次分析完成后，说明连接正常。若预期的代码库未显示，常见原因包括：
- 已安装 GitHub 应用，但未授予其对该特定代码库的访问权限
- 令牌的权限范围过窄，无法列出私有代码库
- 代码库所属的组织与已配置的组织不一致
下一步
任务如何转化为 pull request——描述完工作内容后会发生什么。