安装并完成模型配置后，首次启动 OpenCode 时建议花两分钟调整基础行为，使其更符合个人编码习惯与团队安全规范。以下设置不涉及模型 API，仅关乎日常交互体验。
1. 进入基础设置页
- VS Code：
文件→首选项→设置，搜索OpenCode；或点击状态栏 OpenCode 图标，选择「插件设置」。 - JetBrains：
File→Settings→Tools→OpenCode→General。 - 部分版本在首次启动时会弹出「快速设置向导」，可直接在向导中完成以下调整。
2. 代码补全触发方式
在设置页找到「内联补全（Inline Completion）」相关选项：
- 自动触发（默认开启）：输入时实时推荐，触发延迟通常 200 ms–800 ms 可调。适合大多数用户。
- 手动触发：若项目极大（如千万行级单体仓库）或本地机器配置较低，可关闭自动触发，改为按快捷键主动请求建议。默认手动触发键通常为
Alt + \（VS Code）或Ctrl + Shift + Space（JetBrains），可在 IDE 的键盘快捷键设置中修改。
3. 快捷键自定义
OpenCode 默认复用 IDE 标准按键，若与其他插件冲突建议尽早调整：
| 常用操作 | VS Code 默认 | JetBrains 默认 | 建议 |
|---|---|---|---|
| 接受建议 | Tab | Tab | 若与 Emmet 冲突，可改为 Ctrl + → |
| 拒绝/取消建议 | Esc | Esc | 一般无需修改 |
| 查看下一条建议 | Alt + ] | Alt + ] | 多候选时切换 |
| 打开侧边栏对话 | Ctrl + Shift + A | Ctrl + Shift + A | 按个人习惯绑定 |
| 解释选中代码 | 右键菜单 | 右键菜单 | 可绑定独立快捷键如 Ctrl + Shift + E |
提示：若同时安装了 GitHub Copilot 或其他 AI 插件，强烈建议只保留一个活跃助手，并将另一个完全禁用，避免快捷键与 UI 互相覆盖。
4. 隐私与代码安全设置（企业用户必读）
无论使用云端还是本地模型，都建议检查以下隐私项：
- 代码上传策略：
- 始终允许：适合完全信任的服务商或私有化模型。
- 每次询问：适合混合使用云端模型的场景，执行敏感操作前会弹窗确认。
- 仅当前项目生效：可为不同工作区设置不同策略。
- 禁用敏感文件解析：在排除列表中加入
.env、*.pem、config/secrets.yml、密钥管理文件等，防止敏感文本进入上下文索引。 - 本地模式锁定：若 2.2.2 节部署了本地模型，可勾选「优先使用本地模型处理补全」，确保代码片段不离开本机。
注意：隐私设置仅影响插件侧行为，无法替代代码仓库本身的权限管理。涉及核心算法或密钥硬编码的文件，仍应通过
.gitignore与仓库权限进行源头保护。
5. 项目索引与性能优化
大型项目中，索引范围直接影响补全速度与 IDE 内存占用：
- 排除目录：将
node_modules、vendor、build、dist、.git、.idea、缓存目录加入忽略列表。多数情况下插件会跟随 IDE 的排除配置，无需重复设置；若补全仍卡顿，可手动在 OpenCode 设置中再添加一次。 - 单文件大小上限：默认跳过超过 1 MB 的单个文件。打开日志文件或生成的 JSON 大文件时，该设置可避免无意义的解析与等待。
6. 界面与交互细节
- 回车键行为：部分版本允许设置
Enter键是直接换行还是接受当前建议。习惯用Tab接受建议的用户，建议将回车设为「始终换行」，降低误触概率。 - 候选展示方式：默认以灰色斜体文本行内展示；部分版本支持改为下拉列表，适合不喜欢幽灵文本（ghost text）的用户。
- 语言偏好：对话与解释的语言通常跟随 IDE 界面语言（中文或英文），也可手动锁定，避免在中文项目中输出英文解释。
7. 配置验证清单
保存设置后，建议逐项验证：
- [ ] 输入
def或function时，1–2 秒内出现灰色补全提示。 - [ ] 按
Tab后建议文本被正确采纳，光标位置合理。 - [ ] 选中一段代码，右键菜单出现「OpenCode：解释代码」或类似选项。
- [ ] 侧边栏对话窗口可正常打开，且能收到模型回复。
- [ ] 状态栏显示绿色圆点（或已登录/已连接标识）。
若验证失败，返回对应设置项排查，或参考第 4 章常见问题。
常见问题
- 设置保存后未生效：VS Code 通常即时生效；JetBrains 部分版本需点击
Apply并重启 IDE。 - 快捷键无效：检查 IDE 的
Keyboard Shortcuts全局设置，确认未被其他插件占用。 - 排除目录后补全仍卡顿：可能是缓存未刷新，尝试在命令面板执行
OpenCode: Reindex Project（如有）或重启 IDE。