Sourcegraph Cody 使用教程：从入门到上手

Sourcegraph Cody 是什么

Sourcegraph Cody 是 Sourcegraph 公司推出的一款 AI 编程助手，核心定位是“深度代码理解 + 智能搜索”。它不像普通代码补全工具那样只盯着你当前打开的文件，而是能理解整个代码仓库的上下文，包括跨模块、跨服务的调用关系。Cody 集成了聊天、代码搜索和 IDE 插件三大能力，支持 VS Code、JetBrains 等主流编辑器。

简单说，如果你在维护一个大型项目，或者需要快速理解陌生代码库，Cody 会比普通 AI 编程工具更顺手。它特别适合处理那些“代码散落在多个文件里，逻辑纠缠不清”的场景。

核心功能怎么用

1. 深度代码搜索

这是 Cody 的看家本事。传统搜索只能匹配关键词，Cody 能理解你问的“哪个函数处理了用户登录后的 token 刷新”这种问题，直接返回相关的代码片段和调用链。在 IDE 里按 Cmd+Shift+E（或 Ctrl+Shift+E）调出搜索框，用自然语言描述需求即可。搜索结果会高亮显示关键行，并附带文件路径和上下文。

2. AI 对话

在 IDE 侧边栏打开 Cody 聊天窗口，你可以直接问“这个模块的日志打印逻辑在哪里”“帮我解释这段代码的作用”。Cody 会结合当前打开的代码文件和整个仓库索引来回答。如果它给出的答案不够准确，你可以追问“具体是哪个方法”或“给我看调用链”，它会进一步定位。

3. 代码生成与修改

选中一段代码，右键选择“Ask Cody”或“Edit Code”，可以要求它重构、添加注释、生成单元测试。比如你选中一个复杂的条件判断，告诉它“把这个逻辑拆成三个函数”，Cody 会生成改动建议，并高亮显示差异。你可以一键接受或拒绝。

第一次上手步骤

1. 安装插件：在 VS Code 或 JetBrains IDE 的插件市场搜索“Cody”安装。安装后重启 IDE，右侧会出现 Cody 图标。
2. 登录账号：点击图标，选择“Sign in with Sourcegraph”。如果没有账号，需要去 Sourcegraph 官网注册（国内访问可能受限，可考虑国产替代方案）。
3. 配置仓库：Cody 默认会索引你当前打开的项目。如果项目很大（比如超过 10 万行代码），建议在设置中指定要索引的目录，避免首次加载过慢。
4. 开始使用：在搜索框输入“如何找到订单超时处理的代码”，或在聊天窗口问“这个项目的错误处理风格是什么”。Cody 会花几秒到几十秒分析仓库，然后给出答案。
5. 调整权限：如果团队使用私密仓库，需要在 Sourcegraph 后台添加仓库链接并授权。个人项目一般不需要额外配置。

适合什么场景

• 接手遗留项目：团队新成员快速理解代码结构，比如“这个微服务怎么和支付模块通信的”。
• 跨模块调试：当你需要追踪一个 API 请求从网关到数据库的完整路径，Cody 能帮你串联起所有相关文件。
• 代码审查：审查 PR 时，选中改动代码，让 Cody 解释“这段代码可能引入什么风险”。
• 文档缺失的项目：直接问“这个配置文件的格式是什么”，比翻半天文档快得多。
• 大型单体应用：代码量超过 50 万行，普通 IDE 搜索会卡顿，Cody 的索引机制更高效。

不推荐用于：写简单脚本、做算法题、或者项目代码量少于 1 万行（大材小用）。

价格说明

Cody 提供免费版和 Pro 版（约 9 美元/月）。免费版每月有 500 次搜索和 50 次对话额度，适合个人学习或小型项目。Pro 版不限次数，支持私有仓库索引和团队协作功能。企业版需要联系销售，价格按用户数和仓库规模计算。

注意：免费版对仓库大小有限制（建议不超过 50 万行代码），Pro 版没有这个限制。如果你只是偶尔用用，免费版足够；如果每天都要处理复杂代码库，Pro 版更划算。

另外，由于 Sourcegraph 是海外服务，国内访问可能不太稳定，如果遇到问题，可以看看类似功能的国产工具（如阿里通义灵码、字节豆包 Marscode 等）。