企业官网建设流程全解析

OpenCode AI编程实战：15分钟从安装到跑通第一条对话

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

读完后你能在15分钟内装好OpenCode并完成首次响应，直接在自己的终端里跑通一条AI编程对话。OpenCode是一个开源的AI编程agent，装好后在任何项目目录里都能作为自然语言编程助手使用。

📋 跑通之前确认这几件事

门槛不高，安装也快，所以直接挑一条路径装起来。

📦 安装：挑一种就行

下面三种方式装出来是同一个二进制，挑一种即可，不要叠装。

Homebrew（macOS / Linux，推荐）：官方tap持续跟随主分支更新，macOS和Linux用户基本没理由不选它。

brew install anomalyco/tap/opencode # 从 anomalyco/tap 拉取最新构建，装进本地 Homebrew 前缀

官方安装脚本（任意系统）：一行命令完成架构探测、下载、落盘和PATH配置。

curl -fsSL https://opencode.ai/install | bash # 下载对应平台的最新发布包，默认装到 ~/.opencode/bin，已存在 ~/bin 则装那里

npm（已有Node工具链的人）：全局包统一用npm管的话用这条，bun、pnpm、yarn同样适用。

npm i -g opencode-ai@latest # 全局安装 opencode-ai 包，提供的命令名是 opencode

装完不等于能跑，先确认二进制可用，再把第一条对话跑出来。

✅ 验证 + 第一次跑起来

1. 看版本号：

opencode --version

输出一行版本号（形如0.1.x），说明安装成功。

2. 跑一次性问答：

opencode run "用一句话解释什么是闭包"

AI的回复直接打印在终端，结束即退出。如果你还没配过模型，它会停下来提示你配置认证，先按提示走一遍也行。

3. 显式配置模型：

opencode auth login

从provider列表里选一个、粘贴密钥，凭据会存进~/.local/share/opencode/auth.json，之后不用再管。

4. 启动交互式终端：

opencode

TUI界面打开，底部输入框写问题、回车发送，按Tab可以在build（可读写）和plan（只读）两个agent之间切换。

第一次跑起来卡在"没有可用模型"的话，是认证没配好，下一节专门解决这件事。

🔑 接入你的AI服务

OpenCode接入的provider覆盖常见商业服务和本地方案，常用的有：Anthropic、OpenAI、Google、xAI、Groq、Mistral、OpenRouter，以及任何OpenAI兼容的自建服务。

最直接的是环境变量方式，对任何兼容provider都生效：

export ANTHROPIC_API_KEY=sk-ant-你的密钥 export OPENAI_API_KEY=sk-你的密钥

另一条路是opencode auth login，把密钥统一管在auth.json里，好处是不用往shell文件里撒密钥。走环境变量的话，记得把两行export追加到~/.zshrc（zsh用户）或~/.bashrc（bash用户）末尾再重新加载，不然关掉终端密钥就没了。

🖥️ 界面长这样

认证配好后，OpenCode的主体形态是终端里的TUI，也可以嵌进你的IDE工作流里用。

• 左侧是会话列表，新开对话、翻历史都在这里，多个项目会话并存不打架
• 主区域是消息流，AI改文件时会以diff形式展示变更，逐个确认再应用
• 底部输入框支持@引用文件，Tab切换agent：build有完整读写权限，plan默认只读、执行命令前会先问

除了终端，它也提供IDE集成和GitHub等外部入口，形态随你的工作流走。

熟悉界面之后，日常真正高频用的是下面这几条固定命令。

装完最常用这几条

命令都会了也躲不开环境问题，下面几个是群里被问得最多的坑。

踩坑速查

装完提示 command not found→ 安装目录不在PATH里 → 把~/.opencode/bin（或~/bin）加进PATH，重载shell配置。

跑起来提示没有可用模型 / provider未配置→ 认证没配 → 执行opencode auth login，或按上一节设环境变量。

老版本行为异常、两个版本互相打架→ 0.1.x时代的旧版本残留 → 官方README明确建议先删掉0.1.x之前的版本再装。

opencode run --attach连不上→ 后台serve没起或端口不对 → 先opencode serve，再attach到http://localhost:4096。

TUI显示乱码或快捷键失灵→ 终端能力不够（不支持真彩或鼠标事件） → 换iTerm2、WezTerm或Windows Terminal这类现代终端。

想往深里走

• 全局配置在~/.config/opencode/opencode.json，项目配置用项目根目录的opencode.json
• 配置与provider文档：config.mdx、providers.mdx

现在 cd 进你的项目目录，敲一下 opencode，把第一个问题丢给它。

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