OpenCode 入门教程:一条命令装好这个免费的终端 AI 编程助手
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
还在把 AI 聊天框里的代码逐行复制到编辑器里?OpenCode是跑在终端里的开源 AI 编程代理,它能直接读你的代码、改文件、执行命令,改动实时展示 diff。从装好到跑起来,只要 2 条命令。
🎯 先判断 OpenCode 适不适合你
它解决一个痛点:不用离开终端,就能让 AI 真正"干活"。在项目目录里敲个命令,它就能看代码、跑命令、改文件。三个典型用法:
- 接手陌生代码库:plan 代理只读不改,安全地帮你把项目讲明白
- 日常小改需求:用自然语言描述,AI 给出逐行 diff,一键采纳或拒绝
- 新项目接入:一条
/init生成项目说明,AI 之后不再"乱来"
如果你只想要纯问答、完全不想让 AI 碰文件,它未必适合你;其余开发者直接看下一步。
⚡ 1 分钟装好并验证
最推荐官方一键脚本(npm、Homebrew、scoop 等包管理器方式也有,任选其一):
curl -fsSL https://opencode.ai/install | bash装完在任意项目目录输入opencode,看到带版本号的 OPENCODE 欢迎页就说明成功:
欢迎页下方还列了常用命令速查:/help帮助、/models模型列表、/sessions历史会话,新手可以照着敲。想要图形界面也可以装桌面版(BETA):brew install --cask opencode-desktop。
🧩 核心功能 30 秒拆解
直接看到改动的终端界面
AI 一旦开始改代码,界面立即显示"改动前后"的逐行红绿对比(见下图),当场确认或拒绝,不用回头翻文件:
两种模式,Tab 键切换
- build 模式(默认):完整权限,用于实际开发
- plan 模式:只读,默认拒绝改文件、跑命令前先征求同意,专门分析陌生代码
AI 真的在"干活"
它不只是回答:能读写文件、执行 shell 命令,还能用@general调用子代理处理多步复杂任务。另有 VS Code 扩展,在 IDE 里也能用同一套能力。
📝 3 个场景,直接抄作业
- 场景:接手同事的仓库,完全看不懂 →你说:"这个项目是干嘛的,讲讲目录结构"(先按 Tab 切到 plan 模式)→结果:一份只读探索说明,文件零改动
- 场景:改一个按钮样式 →你说:"把 Settings.tsx 里的按钮从 primary 改成 danger" →结果:AI 给出逐行 diff,确认即完成
- 场景:新项目上手 →你做:输入
/init→结果:生成 AGENTS.md 项目说明,后续对话都按项目约定来
⚠️ 避坑指南
- 装完提示命令找不到:重开终端,或确认安装目录(
~/.opencode/bin或~/bin)在 PATH 里 - 安装时报旧版本冲突:先删掉 0.1.x 的旧版本,再重新跑安装命令
- 担心 AI 乱改文件:按 Tab 切到 plan 模式,它只能看、不能写
- 升级:brew 用户执行
brew upgrade opencode,npm 用户重新跑一次安装命令即可
OpenCode 最大的价值,是把 AI 从"问答框"搬进终端,让它直接动手干活。现在就打开终端,把上面那条安装命令敲进去,在任意项目目录输一下opencode试试。🚀
【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考