升级前先了解：Cody 适合解决什么问题

Sourcegraph Cody 是面向开发者的 AI 编程助手。常见用途包括：代码解释、函数生成、单元测试补充、重构建议、跨文件问答和提交前检查。

它的优势不只是“写一段代码”。它还能结合当前项目上下文理解调用关系。尤其适合中大型项目、遗留系统维护、多人协作代码库和日常开发提效。

更新升级的意义主要有三点：

• 获得更稳定的补全和对话体验，减少扩展卡顿、上下文读取失败等问题
• 支持新的模型接入和更细的模型切换策略
• 修复安全与兼容性问题

对于已经在 VS Code、JetBrains 系列 IDE 或 Sourcegraph 网页端使用 Cody 的用户，建议优先保持扩展为较新版本。避免因接口变化导致登录、索引或模型调用异常。

升级前准备：账号、环境和配置检查

开始升级前，先确认三项基础条件：

• 编辑器版本：VS Code 用户建议使用稳定版。JetBrains 用户建议检查 IDE 是否仍在官方支持周期内。
• 账号登录：确认 Sourcegraph Cody 账号可以正常登录。企业用户还需要确认组织管理员是否开放了 Cody 功能。
• 备份配置：备份自定义指令、模型偏好、代码补全开关、忽略文件规则以及企业实例地址。

如果项目中包含未公开代码、客户资料、密钥、内部接口文档等内容，升级前应先检查 Cody 的上下文读取范围。不要把密钥写在代码注释或配置文件中，也不要在对话框中粘贴访问凭据。

AI 编程工具可以提升效率，但不应替代代码审查、权限管理和安全测试。

VS Code 版 Cody 更新步骤

VS Code 用户最常见的升级方式是通过扩展市场更新。

打开 VS Code，进入左侧“扩展”面板。在搜索框输入“Sourcegraph Cody”，进入扩展详情页。如果页面显示“更新”按钮，点击后等待安装完成。更新结束后，建议重启 VS Code，确保旧进程释放缓存并加载新版本。

如果没有看到更新按钮，可以先点击扩展详情页的齿轮图标，确认是否关闭了自动更新。也可以在扩展面板中筛选“已安装”，找到 Cody 后查看版本号。

若扩展市场加载异常，可先退出编辑器，重新打开后再试。仍然失败时，可从 Sourcegraph 官方发布渠道下载对应版本的安装包，再在 VS Code 中选择“从 VSIX 安装”。手动安装时要确认来源可靠，不要使用来路不明的安装文件。

升级后建议做一次可用性测试：

• 打开一个真实项目，选择一段函数代码，向 Cody 提问“解释这段代码的主要逻辑”
• 再新建一个简单函数，观察行内补全是否出现
• 最后尝试让 Cody 为某个函数补充测试思路

如果三项均正常，说明基础功能已恢复。

JetBrains 版 Cody 更新步骤

JetBrains 系列 IDE 包括 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等。更新入口通常在“Settings / Preferences”中的“Plugins”。

进入插件页面后，在“Installed”列表里找到 Cody。若有新版本会出现更新提示，点击更新并重启 IDE 即可完成。

如果更新后 Cody 面板无法打开，先检查 IDE 右下角是否有插件加载错误提示。再进入插件页确认 Cody 是否被禁用。部分情况下，IDE 版本过旧会导致新版插件无法运行，此时应先升级 IDE，或回退到兼容的 Cody 插件版本。企业环境中如果有统一插件仓库，还需要确认内部仓库是否同步了新版本。

命令行和网页端的注意事项

部分团队会结合 Sourcegraph 实例、代码索引和 Cody 功能一起使用。网页端通常不需要用户手动升级，但企业部署场景需要由管理员维护 Sourcegraph 服务端版本。

普通开发者遇到网页端 Cody 不可用时，不要急于修改本地配置。应先确认是否为组织层面的功能开关、授权额度或服务端版本问题。

如果团队使用命令行工具或自动化脚本调用相关能力，升级前应阅读版本变更说明，重点关注：参数名称、认证方式、默认模型、输出格式是否变化。

生产脚本不要直接使用未经验证的新版本。建议先在测试项目中运行，确认输出稳定后再推广。

升级后必做配置：登录、索引与上下文

更新完成后，第一步是检查登录状态。打开 Cody 面板，如果提示登录，按引导完成授权。登录成功后，确认账号显示正常，并检查当前连接的是 Sourcegraph Cloud 还是团队自建实例。企业用户尤其要核对实例地址，避免把问题误判为扩展故障。

第二步是检查上下文设置。Cody 的效果很大程度取决于它能读取哪些代码和文档。小项目可以直接使用当前工作区上下文；中大型项目建议配合 Sourcegraph 的代码索引能力，让 Cody 更好地理解跨文件调用。对于不希望被读取的目录，例如构建产物、日志、临时文件、密钥样例，应通过忽略规则排除。

第三步是调整补全体验。若觉得补全干扰编码，可以降低自动补全频率，或只在特定语言中启用。若经常处理样板代码、接口适配、类型定义，则建议保留行内补全，这类场景提效明显。

模型选择建议：不要只看“最强”

选择模型时，应按任务拆分，而不是固定使用同一个模型。

• 日常代码补全：追求速度和稳定，适合选择响应快、成本适中的模型
• 复杂架构分析、跨文件重构、疑难错误排查：适合选择推理能力更强、上下文窗口更大的模型
• 写注释、生成测试用例、整理提交说明：对模型要求相对均衡

如果 Cody 面板中提供多种模型，可按以下思路选择：

1. 轻量补全优先选速度快的模型，减少等待
2. 代码问答和重构建议优先选理解能力强的模型
3. 长文件分析优先选支持更长上下文的模型
4. 团队协作场景优先选组织已批准的模型，确保权限和审计策略一致

常见组合是：默认模型用于日常问答和补全，高能力模型用于复杂问题，经济型模型用于批量生成注释、简单测试或文档草稿。不要把所有任务都交给高成本模型，也不要为了省资源在关键代码评审中使用能力不足的模型。

实测升级流程中的常见问题

问题一：更新后无法登录。 通常是旧授权状态失效或浏览器授权未完成。可先退出 Cody 账号，再重新登录；如果使用企业实例，确认实例地址无误，并联系管理员检查 Cody 功能是否开启。

问题二：补全没有反应。 先确认当前文件类型受支持，再检查是否关闭了自动补全。也可能是项目过大、编辑器索引未完成，等待片刻或重启编辑器后再测试。若只在某个项目失败，重点检查项目配置和忽略规则。

问题三：回答内容与项目不匹配。 多半是上下文没有正确加载。可在提问时明确指出文件、函数或目录，例如“结合当前打开文件说明这个方法的调用链”。对于大型代码库，建议先建立索引，再进行跨模块问答。

问题四：升级后变慢。 新版扩展可能会重新扫描工作区，首次启动较慢属于正常现象。若持续卡顿，可关闭不必要的工作区、排除大型生成目录，并检查其他插件是否占用过高资源。

回退版本与故障处理

如果新版本影响正常工作，可以临时回退。VS Code 用户可在 Cody 扩展页面选择安装其他版本；JetBrains 用户可卸载当前插件后安装兼容版本。回退前记录当前版本号、编辑器版本、系统环境和错误提示，方便后续定位。

需要注意的是，回退只是临时措施。 若问题来自账号授权、服务端策略或模型额度，单纯更换扩展版本未必有效。团队使用时应建立统一升级节奏，先由少量成员试用，再推广到全员，避免同一天集中升级造成排查困难。

安全边界：哪些内容不该交给 AI 工具

Cody 可以辅助开发，但不应接触不必要的敏感内容。不要在对话中提交：密钥、访问令牌、内部账号、未脱敏日志、客户身份资料、合同原文或未公开方案。生成的代码也不能直接进入生产环境，必须经过人工审查、测试验证和安全扫描。

对于企业项目，建议明确三条规则：

• 只在批准的工具和账号中使用
• 只让 Cody 读取必要的代码范围
• 重要变更必须经过同伴审查

AI 给出的解释可能合理但不一定正确。尤其在并发、权限、加密、数据一致性等场景，更要以项目规范和测试结果为准。

实用升级建议

个人开发者可以开启扩展自动更新，但要保留回退入口。团队用户更适合采用“灰度升级”：先在测试项目验证登录、补全、问答和模型切换，再更新主力环境。升级记录应写清版本号、更新时间、已知问题和处理方式。

模型选择方面，建议建立自己的任务模板：

• 简单补全用快速模型
• 复杂排查用高能力模型
• 批量文档用经济型模型

提问时尽量给出文件位置、目标、限制条件和期望输出格式，减少来回沟通。只要升级流程稳、上下文配置准、模型选择合理，Sourcegraph Cody 在日常编码中的实际提升会更加明显。