AB
AiBoss
Tutorials

驭码CodeRider

Tutorials

驭码CodeRider 快速上手:在 Cursor 中完成安装、登录与 AI 编程

面向初次接触驭码CodeRider 的开发者,介绍如何在 Cursor 编辑器中完成插件安装、用极狐GitLab 个人访问令牌登录,并在日常编码与 DevOps 流程中使用它的 AI 能力。全文按准备工作、操作步骤、完整示例与注意事项展开,涉及试用资格、令牌范围等易变信息时以官网当前信息为准。

驭码CodeRider 是极狐GitLab 推出的 AIGC 编程产品,能力分两块:一块是常规的 AI 编程辅助,包括代码优化、代码建议、代码注释、单元测试生成等;另一块是与 GitLab 的深度集成,把 AI 能力延伸到 DevOps 流程里,用于处理 Issue、Merge Request 和 CI/CD 相关事务。它本身以编辑器插件的形式提供,可以装在 Cursor 这类 AI 代码编辑器里使用。本文面向第一次接触这个组合的开发者,讲清楚从零到能用的完整路径:装好 Cursor、拿到可用的账号、在 Cursor 里装插件、用个人访问令牌完成登录,最后给出一个从头跑通的最小示例。如果你只是想先了解这个工具本身,可以先看 驭码CodeRider 的工具页,再回到本文动手操作。

准备工作

动手之前,需要把三样东西准备好:编辑器、账号、令牌。三者缺一不可,顺序也基本是固定的,因为令牌必须在账号体系里生成,而插件登录又依赖令牌。

一台可安装 Cursor 的机器

Cursor 提供对应操作系统的安装包,从它的下载页面取得与自己系统匹配的版本即可。安装过程就是常规的图形化安装:下载安装包,运行安装包,按提示完成。安装结束后点击 Cursor 图标启动,首次进入会看到欢迎界面,可以选择打开一个已有文件夹(Open a folder)。建议直接打开一个本地已有的代码仓库,这样后续试用代码建议、代码注释等功能时有真实的文件可操作,而不是对着空目录。

打开文件夹后可以看到 Cursor 的页面布局:左侧是文件资源管理器,中间是编辑区,右侧或侧边栏可以调出插件市场等面板。本文后续所有操作都在这个界面里完成。

一个极狐GitLab SaaS 账号

驭码CodeRider 的试用前提是拥有一个极狐GitLab SaaS 账号。也就是说,即使你只是想试试 AI 编程功能,也需要先在极狐GitLab 的 SaaS 服务上完成注册。注册入口在极狐GitLab 官网,按页面提示填写信息即可。个人和企业都可以申请试用,具体开通方式、试用期限与可用范围属于会调整的信息,请以官网当前公布的说明为准。

之所以必须先有 SaaS 账号,是因为插件登录所用的个人访问令牌(Personal Access Token)是在极狐GitLab 的账号设置里创建的。没有账号,就没有创建令牌的入口,插件也就无法完成认证。

明确你要用哪部分能力

准备阶段还值得花一分钟想清楚使用场景。如果只是想要代码补全、注释生成、单元测试生成这类编辑器内的辅助,那么登录完成即可开始;如果你打算用它与 GitLab 侧的对象打交道,比如让 AI 参与 Issue 处理、MR 审阅或 CI/CD 配置,那么你的账号需要对这些项目有相应权限。权限不足时,插件本身能登录,但涉及仓库与流水线的操作会受限。

操作步骤

整个集成过程可以拆成四步:装 Cursor、开通账号、装插件、登录。下面逐步说明,其中第三步和第四步是核心。

第一步:安装并打开 Cursor

从 Cursor 的下载页面取得对应操作系统的安装包,运行后完成安装。启动 Cursor,选择 Open a folder 打开一个本地仓库。此时编辑器已经可用,但还没有任何驭码CodeRider 的能力。

第二步:注册极狐GitLab SaaS 账号

访问极狐GitLab 官网完成 SaaS 账号注册。注册完成后建议先登录一次 Web 端,确认账号状态正常,并记下你将要使用的账号,因为后面创建令牌时会跳转到这个账号的设置页面。

第三步:在 Cursor 中安装驭码CodeRider 插件

在 Cursor 中打开插件市场,在搜索框输入 CodeRider,列表中会出现驭码CodeRider 插件。点击 install 完成安装。

安装完成后,插件市场入口旁边会出现一个箭头,点开下拉框可以看到驭码CodeRider 的条目,点击它就会打开驭码CodeRider 的登录界面。这一步相当于插件的控制面板入口,后续登录、切换账号都从这里进入。

第四步:用个人访问令牌登录

登录界面提供 Personal Access Token Login 方式。点击后先弹出隐私条款同意页面,点击 Agree and continue 继续,随后进入令牌填写页面。

这个页面上有一个 Create 按钮,位于 Personal Access Token 旁边。点击它会直接跳转到极狐GitLab SaaS 的个人访问令牌创建页面——这正是第二步必须先有 SaaS 账号的原因。在跳转后的页面中点击添加新令牌,注意页面已经默认填好了令牌名称并选好了 API 范围。如果不需要调整令牌的到期时间,直接点击创建访问令牌即可。令牌生成后只显示一次,务必立即拷贝保存。

回到 Cursor 中驭码CodeRider 的登录页面,把拷贝到的令牌粘贴进输入框,点击 Login。登录成功后,插件即可使用。

第五步:开始使用

在 Cursor 中使用驭码CodeRider 与在 VS Code 中使用它差别不大,操作习惯可以沿用。日常使用大致围绕两类场景展开:

  • 编辑器内辅助:对选中的代码请求优化建议、生成注释、生成单元测试等。这类操作以当前打开的文件和选区为上下文。
  • DevOps 流程处理:借助与 GitLab 的集成,让 AI 参与 Issue、MR 与 CI/CD 相关的工作。这类操作依赖账号在对应项目上的权限。

具体每个功能在界面上的位置与触发方式,以你安装的插件版本实际呈现为准;不同版本之间菜单组织可能有差异。

一个完整示例

下面把上面的步骤串成一个从零开始的最小流程,假设你手上有一个本地代码仓库,且此前从未用过 Cursor 与驭码CodeRider。

  1. 从 Cursor 下载页面取得与操作系统匹配的安装包,运行并完成安装。
  2. 启动 Cursor,点击 Open a folder,选择你的本地仓库目录打开。
  3. 在浏览器中访问极狐GitLab 官网,注册一个 SaaS 账号并登录 Web 端确认可用。
  4. 回到 Cursor,打开插件市场,搜索 CodeRider,点击 install 安装驭码CodeRider 插件。
  5. 点击插件市场入口旁的箭头,在下拉框中选中驭码CodeRider,打开登录界面。
  6. 点击 Personal Access Token Login,在隐私条款页面点击 Agree and continue。
  7. 在令牌页面点击 Personal Access Token 旁的 Create,浏览器跳转到极狐GitLab SaaS 的个人访问令牌创建页。
  8. 点击添加新令牌。页面已默认填好令牌名称与 API 范围,保持默认,直接点击创建访问令牌。
  9. 拷贝生成的令牌,回到 Cursor 的登录页面粘贴,点击 Login。
  10. 登录成功后,打开仓库中的任意一个源文件,选中一段函数,请求代码优化或注释生成,确认插件返回结果。

走完这十步,环境就绪。之后每次使用只需启动 Cursor,插件会保持登录状态;若令牌到期或被撤销,则需要重新走第四步生成新令牌并登录。

注意事项

令牌只显示一次。 个人访问令牌在创建后只展示一次,页面关闭后无法再次查看。如果没来得及拷贝,只能重新创建一个新令牌。建议创建后立即粘贴到登录框或存入密码管理器。

默认的 API 范围不要随意改动。 创建令牌时页面已经预填了名称并选好了 API 范围,这是插件正常工作所需的范围。如果手动删减范围,可能出现能登录但部分功能不可用的情况。

令牌到期时间会影响长期使用。 创建页面允许调整到期时间。若保持较短的默认期限,到期后插件会失去认证,需要重新生成令牌。团队协作场景下,建议把令牌的归属与到期安排记录清楚,避免多人共用同一个令牌。

账号是前置条件,不是可选项。 驭码CodeRider 的登录依赖极狐GitLab SaaS 账号,没有账号就无法创建令牌,也就无法完成登录。这一步不能跳过。

试用资格与配额以官网为准。 试用是否开放、面向个人还是企业、期限与额度如何,都属于会变化的信息。本文不给出具体数字,请在申请前查阅官网当前说明。

功能与权限相关。 涉及 Issue、MR、CI/CD 的操作需要账号在对应项目上具备相应权限。若发现某类操作无响应或报权限错误,先检查账号在该项目中的角色,而不是反复重装插件。

跨编辑器行为一致但不完全相同。 在 Cursor 中的使用方式与在 VS Code 中差别不大,但界面入口、菜单命名会随插件版本和宿主编辑器版本变化。遇到与本文描述不一致的界面,以实际显示为准。

价格与版本信息请查官网。 本文不涉及具体定价、版本号与配额数字,这些内容变动频繁,使用前请以官网当前公布的信息为准。