如何在 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 加注释或类型，最后在聊天里问只读问题。確認連通後再做可回溯的改動，並人工審查每一行。