在 JetBrains IDE 中接入 OpenCode 并配置自定义模型 - SharpCJ
内容提要
OpenCode 是一款开源 AI 编程代理，支持多模型提供商和隐私保护，可接入 Android Studio 等 IDE。文章介绍通过 JetBrains AI Assistant 插件启用 OpenCode Agent，配置 Zen 免费模型或自定义 OpenAI 兼容 API，并设置中文回复规则。还涵盖 Token 优化、本地 Ollama 方案及项目级规则建议，帮助开发者高效使用。
延伸解读
配置文件的共享与隔离
IDE 内的 OpenCode 与终端中的 OpenCode 共享同一份全局配置（~/.config/opencode/opencode.jsonc 和 AGENTS.md），但运行时进程相互独立。这意味着你只需配置一次，即可在两种环境中获得一致的模型和规则。不过，修改配置后需要重启 IDE 或手动杀掉残留进程，否则旧配置仍会生效。
中文回复的强制规则
通过 ACP 接入的 Agent 会绕过 JetBrains 的语言设置，因此需要借助全局规则文件 AGENTS.md 强制指定中文回复。该文件不会提交到 Git，仅影响本地会话。若某些项目需要英文回复，可在项目根目录创建项目级 AGENTS.md 覆盖全局规则，实现灵活控制。
Token 优化与本地方案
中文分词比英文多消耗约 1.5 倍 Token，建议采用中英混编提问以节省用量。若追求完全离线，可用 Ollama 运行本地模型（如 qwen2.5-coder），修改 baseURL 即可接入，但性能受硬件限制，复杂任务可能不如云端模型。
Q&A
如何在 Android Studio 中安装 OpenCode Agent？
首先安装 JetBrains AI Assistant 插件，然后在设置页面的 Available Agents 列表中找到 OpenCode，点击 Add / Install，等待下载完成后即可在 AI Chat 窗口的 Agent 下拉菜单中看到 OpenCode 选项。
OpenCode 支持哪些模型提供商？
OpenCode 基于 AI SDK 构建，支持 75+ 家 LLM 提供商，包括 Anthropic、OpenAI、Google、DeepSeek 等，也支持通过 Ollama 运行本地模型。
OpenCode 的隐私保护措施是什么？
OpenCode 采用隐私优先的设计，不存储用户的代码和上下文数据，因此在对隐私敏感的开发环境中也能放心使用。
如何配置自定义 OpenAI 兼容 API？
修改 OpenCode 的全局配置文件 opencode.jsonc，在 provider 字段中添加服务商信息，包括 npm 包名、baseURL、apiKey 和模型列表。例如，配置火山引擎时，设置 baseURL 为 https://ark.cn-beijing.volces.com/api/coding/v3，并指定模型 ID。
如何让 OpenCode 用中文回复？
在全局规则文件 ~/.config/opencode/AGENTS.md 中添加语言控制指令，例如：'You must think, plan, analyze code, and reply STRICTLY in Simplified Chinese (简体中文).' 该文件优先级最高，可覆盖 IDE 的语言设置。
OpenCode Zen 提供哪些免费模型？
OpenCode Zen 目前限时免费提供 deepseek-v4-flash-free、mimo-v2.5-free、laguna-s-2.1-free、ling-3.0-flash-free、north-mini-code-free、nemotron-3-ultra-free 等模型，输入、输出和缓存读取均为 $0。
如何优化 OpenCode 的 Token 消耗？
建议采用中英混编策略，提问时直奔主题，专有名词保持英文，让 AI 用中文输出解释，例如「优化这段 Room 数据库的 Migration 逻辑」，这样比全英文或全中文长句更省 Token。
如何使用 Ollama 实现本地离线方案？
用 Ollama 在本地运行 qwen2.5-coder 或 deepseek-r1，然后将 opencode.jsonc 中的 baseURL 改为 http://localhost:11434/v1，去掉或留空 Authorization 头，即可实现免费、离线的工程级 Agent 辅助。
