如何在 VS Code 安装并使用 Sourcegraph Cody：扩展、登录、内联编辑与代码库聊天
安装 Cody 扩展、完成企业实例登录，再在自己的仓库里拿到第一条内联建议，或用 @-mention 向代码库提问。
第一次在 VS Code 里用 Sourcegraph Cody，卡住的通常不是提示词，而是扩展有没有装对、企业 Sourcegraph 实例 URL 或访问令牌有没有登录成功，以及内联补全、Edit Code 和带 @ 上下文的聊天有没有真正连上。按官方文档装扩展、在浏览器完成认证，再在自己的仓库里触发第一条建议或问一个带代码库上下文的问题。
检索词是 如何在 VS Code 安装并使用 Sourcegraph Cody。下文对照 Sourcegraph 文档 sourcegraph.com/docs/cody/clients/install-vscode、快速入门 sourcegraph.com/docs/cody/quickstart 与 Marketplace 项 sourcegraph.cody-ai。这是 Sourcegraph 的 IDE 助手，不是本站会议产品。要约短会对齐改动，用 wbmeet 建房即可，步骤见 如何创建与加入房间。
先核对你是否具备企业 Cody 访问权限
Cody 是 Sourcegraph 在 IDE 里的 AI 助手：内联自动补全、侧边栏聊天、Edit Code 内联编辑，以及通过 Sourcegraph 搜索引擎拉取的代码库上下文。VS Code 扩展由 Sourcegraph 发布，id 为 sourcegraph.cody-ai。Marketplace 与官方文档写明：Cody 现面向 Sourcegraph Enterprise 用户，需管理员在实例上启用 Cody；非企业个人用户已不可用。自托管实例需在 Site configuration 设置 cody.enabled: true 并配置 LLM 提供商。
第一次：安装、登录、补全、Edit Code 与聊天
- 1
从 VS Code 市场安装 Cody
打开 VS Code，
Cmd+Shift+X（macOS）或Ctrl+Shift+X（Windows/Linux）。搜索 Cody AI，选发布者 Sourcegraph，点 Install。也可 Quick Open（Cmd+P/Ctrl+P）粘贴ext install sourcegraph.cody-ai。安装后若提示重载窗口，先 Reload。活动栏会出现 Cody 图标。 - 2
登录企业 Sourcegraph 实例
点活动栏 Cody 图标，选 Sign In to Your Enterprise Instance，输入管理员提供的实例 URL（自托管形如
https://sourcegraph.example.com，云托管由账户经理提供）。浏览器弹出授权页，点 Authorize，再回到 VS Code 点 Open。若浏览器授权失败：在实例 Account Settings → Access Tokens 生成令牌，回到 VS Code 选 Sign In to Sourcegraph Instances v5.1 and above，粘贴令牌。 - 3
验证内联自动补全
File → Open Folder，打开你拥有、能回滚的项目。新建或打开代码文件，正常打字。几秒后应出现灰色内联补全；按
Tab接受，Esc拒绝。官方示例：在空函数体里输入function bubbleSort(array) {}并继续打字，观察 Cody 是否给出上下文感知建议。 - 4
用 Edit Code 做第一次内联编辑
选中一段代码（或把光标放在函数内），按
Opt+K（macOS）或Alt+K（Windows/Linux），或右键 Cody → Edit Code。用自然语言描述改动，例如「给这个函数加 JSDoc 注释」。审查 diff 后再接受。第一小时目标是确认 Edit 能响应，而不是直接改生产分支。 - 5
在聊天里用 @-mention 引用代码库上下文
按
Opt+L/Alt+L打开 Cody 聊天。新聊天默认会显示当前仓库与当前文件的 context chips。输入@加文件名（@filename）或@#加符号名引用定义。先问只读问题：「这个仓库的入口文件在哪？」或「解释 @#main 的作用」。聊天里 Cody 可用 Smart Apply 把建议插入文件；不要把密钥写进提示。
# First hour · Sourcegraph Cody in VS Code · as of 2026-09
# 1. Extensions → Cody AI (publisher Sourcegraph)
# id: sourcegraph.cody-ai
# 2. Cody icon → Sign In to Your Enterprise Instance
# URL from admin · browser Authorize · or access token (v5.1+)
# 3. Open your repo. Type in a source file → Tab to accept ghost text
# 4. Select code → Opt+K / Alt+K → "Add error handling to this function"
# 5. Opt+L chat: "@src/index.ts where is the main entry point?"
# Do not commit access tokens. Cody requires Enterprise access.登录路径、功能与常见坑
| 功能 | 官方怎么写 | 第一次注意 |
|---|---|---|
| 内联补全 | 打字时出现灰色建议，Tab 接受 | 先确认已登录且 Cody 已启用 |
| Edit Code | Opt+K / Alt+K 或右键 Cody → Edit Code | 选中代码再下指令，审查 diff |
| 聊天 + 上下文 | @file、@#symbol、默认 repo/file chips | 第一问先用只读问题试通 |
| Smart Apply | 聊天代码块上的 Apply 按钮 | 逐块应用，别一次合并大段 |
| 访问令牌 | Account Settings → Access Tokens | 当密码保管，勿提交 Git |
装完却找不到登录入口
确认装的是最新版 sourcegraph.cody-ai，旧版 Cody 需卸载后重装并重载 VS Code。企业用户选 Sign In to Your Enterprise Instance，不是已下线的个人免费路径。
实例 URL 不确定
向 Sourcegraph 管理员或账户经理索取。自托管与 Sourcegraph Cloud 的 URL 不同；填错会导致浏览器授权失败或 404。
聊天说找不到仓库上下文
检查管理员是否配置了 Cody Context Filters 排除了当前仓库，以及 cody.enabled 是否在实例上打开。被 exclude 的仓库无法 @-mention。
官方安装页：市场搜 Cody AI → Cody 图标 → Sign In to Your Enterprise Instance → 浏览器 Authorize → 打字测补全 → Opt+K 试 Edit → Opt+L 聊天加 @ 上下文。计划与定价以 Sourcegraph Enterprise 文档与 cody.dev 为准。
- Enterprise 是硬门槛
- Marketplace 写明 Cody 不再面向非企业用户。没有企业账号时，应联系组织管理员开通，而不是寻找共享账号。
- @ 上下文有 token 上限
- @-mention 多个大文件会占满模型上下文窗口，可能报 File too large。优先引用符号或小范围行号（如
@file:1-50）。 - 教程页不是会议说明书
- 只讲 Cody 第一次。短会白板见 wbmeet 与 对照笔记。
还想核对的问题
Cody 还能免费个人使用吗？
不能。Sourcegraph Marketplace 与官方文档写明 Cody 现需 Sourcegraph Enterprise 账号且实例上启用 Cody。个人开发者需通过公司订阅或联系 Sourcegraph 销售了解 Enterprise 计划。
浏览器授权失败怎么办？
在 Sourcegraph 实例 Account Settings → Access Tokens 生成令牌，回到 VS Code 选 Sign In to Sourcegraph Instances v5.1 and above，粘贴令牌完成授权。令牌不要提交到版本库。
内联补全和 Edit Code 有什么区别？
内联补全是打字时的灰色 ghost text，Tab 接受。Edit Code（Opt+K）针对选中代码块，用自然语言指令生成定向 diff。聊天则适合跨文件问答，可 @-mention 引用代码库上下文。
第一个任务必须改生产代码吗？
不必。先在一个小文件里试补全，再用 Edit Code 加注释或类型，最后在聊天里问只读问题。确认连通后再做可回滚的改动，并人工审查每一行。