OpenCode 快速入门佳实践 开源 AI 编程助手 OpenCode 的安装配置与高使用指南大同罐体保温施工队
什么是 OpenCode OpenCode 是一款开源的 AI 编程助手,支持终端界面(TUI)、桌面应用和 IDE 扩展三种使用方式。它基于 AI SDK 支持 75+ 种 LLM 提供商,包括 Anthropic、OpenAI、DeepSeek 等主流服务。
核心特点:
开源免费:完全开源,可自由使用和定制多模型支持:支持 Claude、GPT、DeepSeek 等 75+ 种模型终端原生:为终端用户设计,支持 Vim 风格快捷键项目感知:通过 AGENTS.md 理解项目结构和编码规范安装 OpenCode 方式一:一键安装脚本(荐)
方式二:使用包管理器
方式三:Docker
在 VSCode 中使用 OpenCode 除了终端界面,OpenCode 还提供 VSCode 扩展,让你在熟悉的编辑器中使用 AI 编程助手。
安装步骤:
打开 VSCode,进入扩展市场(快捷键 Cmd+Shift+X 或 Ctrl+Shift+X)搜索 "OpenCode"点击安装 OpenCode 扩展使用方式:
使用命令面板(Cmd+Shift+P 或 Ctrl+Shift+P)搜索 "OpenCode" 相关命令扩展会在侧边栏添加 OpenCode 面板,可以直接与 AI 对话支持选中代码后右键调用 OpenCode 进行解释或重构配置说明:大同罐体保温施工队
VSCode 扩展会复用终端版本的配置文件(~/.config/opencode/opencode.json),所以你只需配置一次即可在两个环境中使用。
配置 LLM 提供商 OpenCode 需要配置 LLM 提供商才能使用。以下是几种常见的配置方式:
方式一:使用 OpenCode Zen(简单)
OpenCode 官方提供的模型服务,已经过测试验证:
方式二:使用 Anthropic Claude
地址:大城县广安工业区方式三:使用 OpenAI
方式四:使用 DeepSeek(国内荐)
方式五:使用智谱 GLM(国内荐)
智谱 GLM 4.7 是国产大模型中编程能力较强的选择。由于 OpenCode 没有内置智谱大同罐体保温施工队 ,需要通过自定义提供商配置:
前往 智谱开放平台 注册账号并获取 API Key
在 OpenCode 中添加凭证:
创建或编辑配置文件 ~/.config/opencode/opencode.json:重启 OpenCode,运行 /models 即可看到智谱的模型选项配置完成后,铝皮保温使用 /models 命令选择要使用的模型。
初始化项目 进入你的项目目录,启动 OpenCode:
次使用时,运行初始化命令:
这会让 OpenCode 分析你的项目结构,并在项目根目录创建 AGENTS.md 文件。这个文件帮助 OpenCode 理解:
项目的技术栈和框架代码风格和命名规范目录结构和模块划分核心使用技巧 Plan 模式 vs Build 模式
OpenCode 有两种工作模式,通过 Tab 键切换:
Plan 模式:AI 只提供建议和计划,不修改代码Build 模式:AI 可以直接修改代码文件佳实践是先用 Plan 模式讨论方案,确认后再切换到 Build 模式执行。
提问技巧
引用文件
使用 @ 符号引用项目中的文件:
撤销和重做
常用命令速查 命令说明/init初始化项目,生成 AGENTS.md/connect配置 LLM 提供商/models选择使用的模型/undo撤销上一次修改/redo重做撤销的修改/share分享当前对话Tab切换 Plan/Build 模式快捷键速查 OpenCode 使用 Leader 键(默认 Ctrl+X)作为快捷键前缀:
快捷键说明Ctrl+X 然后 n新建会话Ctrl+X 然后 l会话列表Ctrl+X 然后 m模型列表Ctrl+X 然后 u撤销Ctrl+X 然后 r重做Tab切换 Agent 模式Escape中断当前操作配置文件 OpenCode 支持 JSON 配置文件,可以放在以下位置:
全局配置:~/.config/opencode/opencode.json项目配置:项目根目录的 opencode.json示例配置:
常用配置项:
theme:界面主题model:默认使用的模型autoupdate:是否自动更新permission:工具权限设置(ask 表示需要确认)本地模型支持 OpenCode 支持通过 Ollama、LM Studio 等运行本地模型:
Ollama 配置示例:大同罐体保温施工队
佳实践总结 先规划后执行:复杂任务先用 Plan 模式讨论方案维护 AGENTS.md:保持项目说明文件的更新,提升 AI 理解准确度善用文件引用:用 @ 引用相关文件,让 AI 有更多上下文及时撤销:发现问题立即 /undo,避免错误扩散选择适的模型:简单任务用快速模型,复杂任务用强力模型相关资源 官方文档:https://opencode.ai/docs/GitHub 仓库:https://github.com/anomalyco/opencode模型列表:https://models.dev/相关词条:不锈钢保温
18632699551