
驭码CodeRider
驭码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。
- 从 Cursor 下载页面取得与操作系统匹配的安装包,运行并完成安装。
- 启动 Cursor,点击 Open a folder,选择你的本地仓库目录打开。
- 在浏览器中访问极狐GitLab 官网,注册一个 SaaS 账号并登录 Web 端确认可用。
- 回到 Cursor,打开插件市场,搜索
CodeRider,点击 install 安装驭码CodeRider 插件。 - 点击插件市场入口旁的箭头,在下拉框中选中驭码CodeRider,打开登录界面。
- 点击 Personal Access Token Login,在隐私条款页面点击 Agree and continue。
- 在令牌页面点击 Personal Access Token 旁的 Create,浏览器跳转到极狐GitLab SaaS 的个人访问令牌创建页。
- 点击添加新令牌。页面已默认填好令牌名称与 API 范围,保持默认,直接点击创建访问令牌。
- 拷贝生成的令牌,回到 Cursor 的登录页面粘贴,点击 Login。
- 登录成功后,打开仓库中的任意一个源文件,选中一段函数,请求代码优化或注释生成,确认插件返回结果。
走完这十步,环境就绪。之后每次使用只需启动 Cursor,插件会保持登录状态;若令牌到期或被撤销,则需要重新走第四步生成新令牌并登录。
注意事项
令牌只显示一次。 个人访问令牌在创建后只展示一次,页面关闭后无法再次查看。如果没来得及拷贝,只能重新创建一个新令牌。建议创建后立即粘贴到登录框或存入密码管理器。
默认的 API 范围不要随意改动。 创建令牌时页面已经预填了名称并选好了 API 范围,这是插件正常工作所需的范围。如果手动删减范围,可能出现能登录但部分功能不可用的情况。
令牌到期时间会影响长期使用。 创建页面允许调整到期时间。若保持较短的默认期限,到期后插件会失去认证,需要重新生成令牌。团队协作场景下,建议把令牌的归属与到期安排记录清楚,避免多人共用同一个令牌。
账号是前置条件,不是可选项。 驭码CodeRider 的登录依赖极狐GitLab SaaS 账号,没有账号就无法创建令牌,也就无法完成登录。这一步不能跳过。
试用资格与配额以官网为准。 试用是否开放、面向个人还是企业、期限与额度如何,都属于会变化的信息。本文不给出具体数字,请在申请前查阅官网当前说明。
功能与权限相关。 涉及 Issue、MR、CI/CD 的操作需要账号在对应项目上具备相应权限。若发现某类操作无响应或报权限错误,先检查账号在该项目中的角色,而不是反复重装插件。
跨编辑器行为一致但不完全相同。 在 Cursor 中的使用方式与在 VS Code 中差别不大,但界面入口、菜单命名会随插件版本和宿主编辑器版本变化。遇到与本文描述不一致的界面,以实际显示为准。
价格与版本信息请查官网。 本文不涉及具体定价、版本号与配额数字,这些内容变动频繁,使用前请以官网当前公布的信息为准。