Cody插件安装后必须登录GitHub/Google/GitLab账号才能工作，未登录时聊天框提示“Sign in to use Cody”，补全和搜索功能不可用；登录后状态栏图标变蓝并弹出欢迎提示，且需通过@mention文件或代码搜索精准锚定上下文。
安装后没登录，Cody 就不工作
插件装完只是第一步，Cody 不像普通语法高亮插件那样开箱即用。它必须绑定 GitHub / Google / GitLab 账号才能拉取代码上下文、调用远程模型（Claude 3.5 Sonnet 或 GPT-4o）。没登录时点击聊天框会直接提示 “Sign in to use Cody”，补全和搜索功能全部灰掉。
- 登录入口在状态栏最右侧的
Cody图标 → 点击后选择账号类型 - 如果用 GitHub 登录，需授权
public_repo权限（仅读取你有权限的仓库，不会写入） - 登录成功后，状态栏图标会从灰色变成蓝色，且右下角弹出 “Welcome to Cody” 提示
@mention 文件才能精准问答
Cody 的语义搜索不是全局盲扫，而是靠你主动锚定上下文。直接问 “这个函数为什么返回 undefined？” 很可能得不到答案——它不知道“这个函数”指哪。
- 把光标停在目标函数/类/变量上，按
Ctrl+Enter（Windows/Linux）或Cmd+Enter（macOS），自动插入@file/path.ts - 也可以手动输入
@src/utils/apiClient.ts，路径必须是工作区内的相对路径（非绝对路径） - 多个文件用空格分隔：
@src/store/index.ts @tests/unit/login.spec.ts - 注意：@ 后面不能带通配符，
@src/**/*.ts无效；也不能用 glob，只认真实存在的文件路径
搜索代码比 Chat 更快，但要会用关键词
想快速定位某个 API 的所有调用点？别先开聊天窗口，用 Cody 的代码搜索（快捷键 Ctrl+Shift+P → 输入 “Cody: Search code”）更准、更快。
- 搜函数名：
fetchUser（默认匹配函数定义 + 调用处） - 搜带参数的调用：
fetchUser("id")（引号内是字面量，会精确匹配） - 搜注释关键词：
// TODO: handle error（支持中文，但需加引号） - 性能影响：首次搜索会触发本地索引（基于 tree-sitter），大项目可能卡 2–5 秒；后续搜索毫秒级响应
企业版才支持远程仓库上下文
免费版 Cody 只能访问当前 VS Code 工作区里的代码。如果你问 “对比 main 和 feature/auth 分支里 login.ts 的差异”，它会报错 “No context found for branch feature/auth”。
- 这个能力叫 “Remote repository context”，仅
Cody Enterprise订阅用户可用 - 个人用户若真需要跨仓库引用，只能手动复制粘贴相关代码块到聊天窗口，并明确说 “参考以下代码：…”
- 本地索引深度也受限：免费版默认跳过
node_modules/、dist/、.git/，但无法自定义忽略列表（企业版可配.codyignore）
