一条命令装好：OpenCode 开源终端 AI 编程助手完整使用指南

一条命令装好：OpenCode 开源终端 AI 编程助手完整使用指南

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode

OpenCode 是一个住在终端里的开源 AI 编程助手。你用自然语言下指令，它替你读代码、修 bug、写文档。免费、代码全公开，支持在各大厂模型和本地部署之间自由切换。这篇指南从安装讲到日常使用，几分钟就能看完。

🚀 核心能力速览

先看它强在哪：

• 终端原生：不占编辑器，直接在命令行里下指令，它自己读项目、改代码，装完就能用。
• 模型随便切：支持 Anthropic、OpenAI、Google 等厂商的模型，也接本地模型端点，不被任何一家绑死。
• 两种内置 Agent：build 模式负责动手写代码，plan 模式只读不改、专门分析，按 Tab 键随时切换。

⚡ 一条命令装好并运行

用官方脚本一条命令安装：

curl -fsSL https://opencode.ai/install | bash

习惯包管理器的话，npm install -g opencode-ai也可以。装好后，进入任意项目目录输入opencode。第一次运行会让你选提供商、填 API key，确认完就能开始下指令了。

🔍 日常三用法：写代码、查 bug、补文档

• 让它写功能：说一句“给设置页加个重置按钮”，它会自己读相关文件、给出改动，并展示 diff 让你确认后才落盘。
• 排查 bug：把报错信息和相关文件路径丢给它，它分析逻辑、定位原因，再提交修复方案。
• 补文档：让它给已有函数生成注释，整个模块的文档一次补齐，省掉逐行翻代码的时间。

⚙️ API Key 设置与模型怎么选

首次运行前先配好你要用的提供商密钥：

export ANTHROPIC_API_KEY=你的key # 或者：export OPENAI_API_KEY=你的key

模型怎么选：日常补全、起名这类小任务用 Haiku 这类快模型，省钱也省等待；重构、调试复杂逻辑时换 Sonnet 或 Opus 这类旗舰模型，一次把事做对。

🧩 扩展能力：远程、协作与插件

OpenCode 采用客户端-服务器设计，除了本地终端，还能从另一台设备远程接入，把会话共享给团队一起看。插件系统也开放给你：想加自定义命令或工具，写一个插件注册进去就行。如果你更喜欢图形界面，也有桌面版（Beta）可用。

避坑指南

• 安装失败：多半是权限问题。可以用OPENCODE_INSTALL_DIR指定一个你有写权限的目录，或者改用 brew 安装绕开。
• API 没反应：按顺序查三件事——环境变量有没有真正导出、key 是否有效、网络能否连上提供商。
• 响应太慢：换个更快更轻的模型，或检查网络是否走了不稳定的代理。

结语

如果你受够了在网页和 IDE 之间来回切换，OpenCode 把这个助手搬回了终端，而且完全开源、完全归你控制。

现在就装上，让它在你的下一个项目里接个小任务试试。想玩得更深，项目的贡献文档和社区随时欢迎你参与。

【免费下载链接】opencodeThe open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/openc/opencode