安装并验证 OpenCode

安装 Agent 等于在电脑上加入一个能读取文件和执行命令的程序。来源必须比“能不能装上”更重要。

选择安装渠道

如果企业已有内部软件仓库或安装脚本，使用企业渠道。个人可控环境可以按照 OpenCode 官方文档使用安装脚本：

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

重新打开终端，或按安装输出提示更新 PATH。然后验证：

command -v opencode
opencode --version

command -v 应指向你的用户目录或管理员指定路径，而不是临时下载目录。

无外网或代理环境

不要关闭证书校验来“解决”下载失败。正确做法是：

1. 向管理员确认代理变量和企业 CA；
2. 使用内部镜像或离线安装包；
3. 核对包的版本、来源和校验值；
4. 将安装步骤记录到团队文档。

常见代理变量由管理员提供：

env | grep -Ei '^(http|https|no)_proxy='

这条命令可能显示内部地址，只在自己的终端检查，不要把输出贴到公共 Issue。

第一次启动前

回到练习仓库：

cd "$HOME/workspace/vibe_coding_guide"
git status

确认工作区干净。下一课才会配置模型 API；现在启动后如果要求选择 Provider，可以先退出，不要随便粘贴真实 Key。

完成检查

安装来源符合企业政策command -v opencode 指向预期路径opencode --version 能正常输出我没有关闭 TLS 校验或使用不明镜像练习仓库仍保持干净