OpenCode 快速入门指南：5 分钟装好开源 AI 编程助手

OpenCode 快速入门指南5 分钟装好开源 AI 编程助手【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode如果你已经受够了注册账号、装客户端、配插件三步走一遍才能用上 AI 写代码那么 OpenCode 值得试试——它是一个开源的 AI 编程助手coding agent直接跑在终端里装完就能用。你只需要一条安装命令、一个 API Key剩下的读代码、改文件、跑命令都交给它。一行命令装好它环境要求很轻macOS、主流 Linux 发行版或 Windows 10 以上走 WSL2内存 4GB 起步磁盘留 500MB 就够。推荐直接用官方安装脚本它会自动下载到合适的目录curl -fsSL https://opencode.ai/install | bash不想用脚本的也可以走包管理器npm 执行npm i -g opencode-ailatestmacOS/Linux 推荐brew install anomalyco/tap/opencode版本最新Windows 可用scoop install opencode。装完验证一下opencode --version能打印出版本号就成功了。如果提示找不到命令把安装目录加进 PATH默认在~/.opencode/binecho export PATH$HOME/.opencode/bin:$PATH ~/.bashrc source ~/.bashrc想自定义安装位置的话安装前设置OPENCODE_INSTALL_DIR即可例如OPENCODE_INSTALL_DIR/usr/local/bin curl -fsSL https://opencode.ai/install | bash。API Key 怎么配OpenCode 不绑定单一模型厂商模型列表基于 Models.dev所以你基本想接哪家就接哪家。最省事的方式是交互式登录它会把密钥存到~/.local/share/opencode/auth.jsonopencode auth login习惯用环境变量也行任选其一export ANTHROPIC_API_KEY你的anthropic_api_key # Anthropic export OPENAI_API_KEY你的openai_api_key # OpenAI之后在配置里可以用apiKey: {env:ANTHROPIC_API_KEY}这样的写法引用环境变量敏感信息不必硬编码进文件。完整的配置字段说明可以看仓库里的配置文档packages/web/src/content/docs/config.mdx。它能帮你做什么build / plan 双模式默认是 build 模式有完整权限读写文件、执行命令一气呵成按Tab键切到 plan 模式它变成只读——不碰你的文件、跑命令前先问专门用来分析陌生代码库或先想方案再动手。多模型自由切换Anthropic 代码能力强适合复杂逻辑OpenAI 通用性和多模态好本地模型则胜在隐私和离线随项目需要换。general 子代理遇到跨多文件的复杂搜索或多步骤任务在消息里输入general就能调度它拆解执行。不止终端还有 Beta 版桌面应用macOS/Windows/Linux 都有包brew install --cask opencode-desktop可直接装。实战从启动到拿到第一段代码假设你刚 clone 了一个没见过的仓库跟着做三步进入项目目录启动 OpenCodecd your-project opencode先用 plan 模式探路按Tab切到只读模式输入帮我梳理一下这个项目的目录结构和入口文件。它会只读地浏览代码输出一份结构说明——这时候它改不坏任何文件。切回 build 模式再按一次Tab直接下指令给 login 接口加一个单元测试。它会自己读相关文件、写测试、跑命令验证你看着终端里的进度就行。中途随时可以用opencode --help查可用命令不想用某个模型时通过 provider 配置切换即可。CLI 的完整命令说明在 packages/web/src/content/docs/cli.mdx。排坑 FAQ这几个问题最常见提示opencode: command not found大概率是 PATH 没生效重新加载 shell 配置source ~/.bashrc或确认安装脚本实际落盘到了哪个目录。安装失败或装完行为怪先删掉 0.1.x 之前的旧版本再重装然后检查网络是否稳定、目录写权限是否足够。提示模型未授权跑一次opencode auth login或确认对应的ANTHROPIC_API_KEY/OPENAI_API_KEY环境变量已生效。Windows 上装不上建议进 WSL2 装或者直接scoop install opencode、choco install opencode。想升级版本重跑一遍安装脚本即可Homebrew 用户执行brew upgrade opencode。接下来可以做什么把opencode开在长期项目里跑一周感受 plan 模式和 build 模式的分工再决定日常默认用哪个。读一遍配置文档 packages/web/src/content/docs/config.mdx给常用项目写一份自己的默认模型与权限配置。需要图形界面就从 Beta 桌面版开始试packages/desktop/README.md 里有各平台下载说明。祝你在终端里越写越快。更新永远只需一行curl -fsSL https://opencode.ai/install | bash【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考