OpenCode 上手教程装完就在终端里让 AI 改好你的第一个 Bug【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencodeOpenCode 是跑在终端里的开源 AI 编程智能体解决问 AI 得先开浏览器、贴代码的问题运行opencode后直接在终端读代码、改代码、跑测试。快速上手2 种方式装好 OpenCode[初级] 多数用户直接用官方一键脚本自动检测系统并安装curl -fsSL https://opencode.ai/install | bash opencode跑通后你会看到终端交互界面左侧是会话列表输入框直接写自然语言。npm 或 Homebrew 用户也可以等价地用npm i -g opencode-ailatest、brew install anomalyco/tap/opencode。[进阶] 想改源码就从仓库编译git clone https://gitcode.com/GitHub_Trending/openc/opencode cd opencode bun install bun run build装完别急着删旧文件如果机器上有 0.1.x 老版本先卸载再装新否则新旧二进制会互相顶掉。核心能力终端里直接让 AI 改代码场景构建报错想让 AI 定位并修好。 修掉这个测试失败改完自己跑测试验证默认的 build 智能体有完整文件与命令权限改完会自己跑测试并展示 diff。按Tab可切到 plan 智能体它默认拒绝写文件、跑 bash 前先问你要权限只分析不动手。适合修 bug、小重构。不适合只想让 AI 看看别动手——那就切到 plan。在编辑器里逐行审查 AI 的改动嫌终端 diff 不够细就装 VS Code 扩展侧边栏对话下AI 修改会以逐行 diff 显示在编辑器里单段采纳或整体回退都可以不用离开窗口。适合大重构、多文件联动修改。不适合纯服务器无图形界面环境用终端 diff 即可。用 GitHub Copilot 登录调 Claude 或 GPT没有各家 API key 时用 GitHub 账号登录Copilot 订阅额度可以直接调用 Claude、GPT 等模型opencode auth login选 github-copilot完成后再用/models切换当前会话模型。适合不想单独管理 key 的开发者。不适合本地模型服务需要另外配自定义 provider。[进阶] 进阶玩法配置、模型与环境变量配置文件是opencode.json/opencode.jsonc按全局 → 项目顺序合并。最常用的几项配置项作用默认值推荐值model固定会话模型目录默认值日常用快模型instructions自动纳入上下文的文件/glob空指向CONTRIBUTING.mdOPENCODE_PERMISSION环境变量JSON 权限覆盖内置策略CI 中锁死 bashtool_output.max_lines工具输出截断行数内置上限日志被截断时调大autoupdate自动更新策略notifytrue组合拳快模型 instructions指向团队规范每次会话自动带上编码风格不用重复叮嘱。CI 场景OPENCODE_CONFIG_DIR指向独立配置再用OPENCODE_PERMISSION收紧命令权限可以无人值守跑。plan 模式 调大tool_output大仓库里 AI 的搜索结果不会被截断。注意OPENCODE_PERMISSION的 JSON 非法时会被直接跳过只在日志里留一条 warning别等权限不生效了才去查。踩坑 真实问题装完opencode报错或版本行为异常原因PATH 里残留 0.1.x 旧二进制和新版本冲突。先彻底卸载旧版再重装。brew install opencode装的版本总是落后原因官方 formula 更新频率低。换成 tapbrew install anomalyco/tap/opencode。权限配置消失了原因OPENCODE_PERMISSION的 JSON 格式错误加载器静默跳过。先校验再改python3 -m json.tool your-permission.json还卡住的话去 packages/docs/ 搜关键词或直接到仓库 issue 区搜相同报错。路线图 社区入口v2 配置重构配置 schema 正按字段逐组评审command、skills等会重新定型见 specs/v2/桌面应用macOS / Windows / Linux 安装包已在 BETA 阶段插件生态plugins字段按序加载钩子覆盖会话与工具事件多 provider 协议packages/llm持续增加模型协议适配最低门槛的参与方式先读一遍 CONTRIBUTING.md从提一个能复现的 issue 开始。先把上面安装命令跑一遍报错就把日志贴到 issue 区能跑通的话从修一个你手头的测试失败开始最直观。【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考