OpenCode作为一款开源的AI编程助手,支持多种安装方式和75家大语言模型提供商。本文将详细介绍其安装配置、核心功能使用以及高级技巧,帮助开发者快速上手这个强大的编程辅助工具。
智能速览
支持npm、Chocolatey等多种安装方式
可连接75家大语言模型提供商包括国内厂商
/init命令生成AGENTS.md文件建立项目上下文
内置build和plan两个核心代理模式
支持Skills技能系统扩展功能
可配置Ollama本地模型服务
精华内容
深入了解OpenCode的安装配置和核心功能,掌握这款开源AI编程助手的使用技巧,提升编程效率。
安装准备
OpenCode提供多种安装方式。推荐使用PowerShell 7终端获得更好体验,它是一个开源跨平台的自动化工具。通过npm安装时需先安装Node.js环境,命令为npm i -g opencode-ai。使用Chocolatey包管理器安装更为便捷,命令为choco install opencode。注意安装后如遇360等杀毒软件拦截,需将文件加入信任区域。
模型配置
启动OpenCode后,输入/connect命令连接LLM供应商。支持75家大语言模型提供商,包括Moonshot AI、智普AI、阿里百炼等国内厂商。输入/models命令选择具体模型。连接成功后即可与AI对话,获得编程辅助。还支持运行本地模型,如通过Ollama部署的qwen3-coder-next:cloud等模型。
项目初始化
/init命令是OpenCode的核心功能,会扫描项目结构并生成AGENTS.md文件。该文件包含项目概览、文件地图、编码规范等信息,作为AI理解项目的上下文基准。后续编程时,OpenCode会优先参考AGENTS.md提供精准建议。可通过修改该文件指定AI输出语言,例如添加中文输出配置。
代理模式
OpenCode内置两个核心代理:build代理拥有完整开发权限,可读写文件执行命令;plan代理为只读模式,适合分析代码和规划任务。通过Tab键切换代理模式。终端操作支持@文件引用、!执行shell命令、esc退回等快捷方式。还提供/compact压缩会话、/new开始新会话等实用命令。
技能系统
Skills是OpenCode的可扩展功能包,通过约定目录下的SKILL.md文件定义。文件需包含YAML头部指定name、description等元信息。描述字段决定技能触发机制,AI根据需求自动匹配加载。可从官方仓库、第三方市场获取技能,如Skill Creator自动生成新技能、Frontend Design增强UI设计等。
OpenCode作为开源AI编程助手,通过灵活的配置和丰富的功能,为开发者提供了强大的编程辅助能力。其模块化设计和技能系统使其具备了良好的扩展性,未来有望成为AI编程工具生态中的重要组成部分。