如何在 VS Code 中使用极狐GitLab Duo

TUTORIAL · 上手实录

2026.10

一份照着做就能跑通的四步上手清单

装扩展 · 认证 · 连仓库 · 开开关 · 避坑指南

极狐GitLab Duo 官方文档实操版

TUTORIALHANDS-ON

📋 本文目录

01 装扩展，三条路任选

02 认证，OAuth 或 PAT 二选一

03 把仓库连进来

04 开启 Duo 的先决条件

05 两个容易踩的坑

写在前面

工具不该是瓶颈，AI 应该直接长在你的工作流里

你是不是也经历过这种场景：函数写到一半，脑子里明明有思路，手却慢了半拍；想问某个仓库里的历史遗留代码「这段为什么这么写」，只能翻 commit 记录翻到眼花。

工具不该是瓶颈。极狐GitLab Duo 把 AI 能力直接塞进了你的工作流——不只是代码补全，而是一个能读懂你整个仓库上下文、能帮你执行操作的 Agent 智能体。

这篇指南基于极狐GitLab 官方文档整理，从零开始，十分钟跑通。

01 装扩展，三条路任选

极狐GitLab for VS Code 扩展是入口，安装方式按你的环境选：

标准 VS Code 用户

直接在 Visual Studio Marketplace 搜索安装。

非官方 VS Code 发行版（如 VSCodium 等）

从 Open VSX Registry 安装。

追求安全隔离的团队

在 VS Code Dev Container 里跑，容器化环境，代码不出沙箱。

多说一句 Dev Container 这条路：它适合对数据边界敏感的企业场景。前提是本机装好 Docker 并装上 Dev Containers 扩展，然后在项目的 devcontainer.json 里加一段配置：

// .devcontainer/devcontainer.json
{
  "name": "My Project",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "customizations": {
    "vscode": {
      "extensions": [
        "GitLab.gitlab-workflow"
      ]
    }
  }
}

接着执行命令面板里的 Dev Containers: Open Folder in Container，扩展会自动装进容器。

✦ 一句话理解

AI 能力和代码，一起被关在沙箱里，数据边界由容器说了算。

02 认证，OAuth 或 PAT 二选一

扩展装好了，下一步是让它认识你。打开命令面板：

macOS

Command + Shift + P

Windows / Linux

Control + Shift + P

GitLab: Authenticate

回车。选择你的极狐GitLab 实例 URL（手动输入时记得带上 https:// 前缀），然后二选一：

方式一：OAuth 登录

18.3 版本起，私有化部署实例也支持 OAuth 了——按提示跳转登录即可，体验最顺滑。

方式二：PAT 个人访问令牌

适合不想走浏览器的环境。前提：令牌必须带 api 权限，在个人设置里创建即可，参考官方令牌文档。

认证完成后，扩展会把你的 Git 仓库远程 URL 和实例 URL 自动匹配。多账号、多项目的同学别慌，后面会讲怎么切换。

✦ 自签名证书

如果你的企业网络用了自签名证书，扩展也支持自定义 SSL 配置，详见官方说明。

03 把仓库连进来

AI 要干活，得先看得见你的代码。三步：

1. VS Code 顶部菜单「终端 > 新终端」，克隆你的仓库：git clone ；

2. 进入目录、检出分支；

3. 左侧边栏点开 GitLab 图标，选中你的项目名称。

顺手验证一下远程配置：终端里跑下面这条命令，能看到 fetch/push 两条记录就对了。

git remote -v

如果远程缺失，去源代码管理面板，右键你的仓库，「远程 > 添加远程存储库 > 从 GitLab 添加远程存储库」，选一下即可。

✦ 小彩蛋

如果最近一次提交关联了流水线、当前分支挂着合并请求，VS Code 状态栏会直接显示这些信息——不用切回浏览器了。

04 开启 Duo，关键在先决条件

这一步是很多人卡住的地方，先划重点：

先划重点

扩展装好 ≠ Duo 能用，开关在实例侧，不在编辑器侧

对照这份清单逐项确认：

• 管理员已在实例/群组层面开启极狐GitLab Duo

• 你的项目位于群组命名空间下

• 想用工作流（Flows），需开启基础工作流

• 想用 Agent，需开启内置 Agent，并按需启用自定义 Agent

• 已设置默认的 Duo 命名空间，或当前项目本身可访问 Duo

• 要用代码建议（Code Suggestions），还需满足额外先决条件

全部满足时，Duo 功能在 VS Code 里默认即用，不需要再手动点什么。

真想关掉也简单：Command/Control + , 打开设置，「扩展 > GitLab > GitLab Duo」，去掉对应功能的勾选即可。Agentic Chat 里逐个批准工具嫌烦？可以配置每会话批准一次，见工具批准文档。

05 两个容易踩的坑

坑一：多账号不知道用了哪个

扩展按工作区绑定账号。当你认证了多个账号、且 Git remote 无法唯一确定归属时，状态栏会亮出「多个极狐GitLab 账号」提示——点它选择，或用命令面板的下面这条命令。

GitLab: Select Account for this Workspace

坑二：频繁重建的环境里令牌总丢

比如在 Gitpod 这类容器环境里反复删除 VS Code 存储，令牌跟着蒸发。解法：启动 VS Code 前设置两个环境变量——

• GITLAB_WORKFLOW_INSTANCE_URL：你的实例 URL

• GITLAB_WORKFLOW_TOKEN：你的个人访问令牌

环境变量在存储被清空后依然保留。注意：如果你在扩展里也配了同一实例的令牌，扩展侧配置优先。

✦ 遥测提醒

扩展会遵循 VS Code 的遥测设置上报使用数据。介意的话，在「设置 > 应用程序 > 遥测」里可以调级别，甚至完全关掉（off）。

写在最后

跑完这四步，你现在拥有的不只是一个「更聪明的补全工具」——Duo Chat 里的 Agent 能读你的仓库、理解你的上下文，直接替你执行操作。

开发这件事，正在从「人驱动工具」变成「人指挥 Agent」。

十分钟装一个扩展，换个范式，这买卖不亏

试过了吗？欢迎留言聊聊你让 Agent 干的第一件事是什么。想深入了解 Duo Agent Platform 的完整能力，可以查阅官方文档中心；还没有环境试用？去官网申请一个。

既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。

本文内容照搬自极狐GitLab 微信公众号（2026 年 10 月 12 日）。原文：