tidemeet

如何安装并使用 OpenCode：装 CLI/TUI、登录或 API Key、第一次仓库任务

安装 OpenCode CLI/TUI，接上密钥，再在真实仓库跑完第一次任务。

你要的是在终端里装一个能读仓库、能改文件的开源代理，而不是再开一个网页聊天窗口。

这篇按官方文档走完 如何安装并使用 OpenCode：装 CLI/TUI，用 /connect 或 opencode auth login 登录或粘贴 API Key，再在真实仓库完成第一次任务。步骤以 opencode.ai/docs 的 Intro、Providers 与 CLI 页为准。

安装 CLI 登录或 API Key 第一次仓库任务

它适合谁、不适合谁

OpenCode 是开源终端代理：无参数运行 opencode 即进入 TUI，也可用 CLI。官方还提到桌面端和 IDE 扩展，本文只走终端。第一次需要现代终端模拟器，外加一把可用的模型密钥。

01

对着真实仓库

先 cd 到你真正维护的项目。第一次问三要点或一个可加测试，而不是整仓重构。

02

密钥走鉴权文件，不走提示词

官方把提供方密钥存在 ~/.local/share/opencode/auth.json。TUI 用 /connect，CLI 用 opencode auth login。不要把密钥贴进对话。

03

先初始化再改文件

/init 会分析项目并写出 AGENTS.md，官方建议提交。小改动可直接 Build；更大功能先用 Tab 切到 Plan 模式。

安装、鉴权、第一次任务

  1. 1

    安装 CLI 并打开 TUI

    在 macOS/Linux/WSL 运行 curl -fsSL https://opencode.ai/install | bash，或 npm install -g opencode-ai，或 brew install anomalyco/tap/opencode（官方更推荐 anomalyco tap）。Windows 原生可用 Chocolatey、Scoop 或 npm，完整能力更建议 WSL。装完运行 opencode --version，再执行 opencode 进入 TUI。

  2. 2

    登录或添加 API Key

    在 TUI 输入 /connect：新手可选 OpenCode Zen，到 opencode.ai/auth 登录、填写账单并粘贴密钥；也可选 OpenAI、Anthropic 等其他提供方。等价 CLI：opencode auth login。用 opencode auth list 确认。密钥也可来自环境变量或项目 .env。

  3. 3

    在仓库里跑第一次任务

    cd 到项目后运行 opencode，先 /init 生成 AGENTS.md。第一次提问例如「用三条要点说明仓库结构，并建议一个可加的小测试」。小编辑只改一行注释并保持行为不变。看完 diff 再接受。可用 /undo。脚本场景用 opencode run。

1
次 CLI 安装
2
条鉴权路径
/init
写出 AGENTS.md
curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai
# or: brew install anomalyco/tap/opencode

opencode --version

# Auth (pick one):
# In the TUI:  /connect   → provider or OpenCode Zen → paste API key
# CLI:         opencode auth login
# Check:       opencode auth list
# Keys live in ~/.local/share/opencode/auth.json  (do not commit)

cd /path/to/your/repo
opencode
# In the TUI:  /init     → writes AGENTS.md (ok to commit)
# First task:  Explain the repo layout in three bullets and name one small test I can add
# Small edit:  Add a one-line comment to the main entry file; do not change behavior
# Undo:        /undo

# Non-interactive alternative:
# opencode run "Explain README.md in three bullets and suggest one small test"

第一次容易卡住的地方

方式账单更适合
安装脚本 / npm / brew工具本身开源本机第一次装 CLI
OpenCode Zen 或提供方 API KeyZen 账单或各家 Platform 价云端读仓与改文件
环境变量 / 项目 .env同提供方计费CI 或不想写进 auth.json
TUI 花屏或快捷键失灵
官方要求较新的终端，如 WezTerm、Alacritty、Ghostty、Kitty。系统自带终端若渲染差，先换模拟器再查模型。
把 auth.json 当密码本
默认在 ~/.local/share/opencode/auth.json。不要拷进公开仓库。若密钥已进 Git，到对应控制台轮换。
Windows 功能不全
官方建议用 WSL 获得完整兼容。Chocolatey / Scoop / npm 可装原生二进制，但体验以文档 Windows 节为准。

官方提醒：API 按供应商或 Zen 计费。第一次用便宜模型摸 /init 与 /undo，再换到你真正要付的模型。

改完要和人对着看时

代理改完常缺一张图：动了哪、为什么能合。不必再装会议套件。可在tidemeet用浏览器开短时空间，或看如何创建空间。画布见共享白板基础。同站终端代理见Aider与Codex CLI。

还有疑问？

必须使用 OpenCode Zen 吗？

不必。Zen 是文档给新手的策划模型列表。/connect 也可选其他提供方，或走 opencode auth login。以 Providers 页为准。

AGENTS.md 要提交吗？

官方建议提交，好让代理记住项目结构和习惯。不要把密钥写进这个文件。

第一次该开 Plan 模式吗？

小改动可直接在 Build 里做。较大功能用 Tab 切到 Plan（此时不会改文件），谈妥再切回 Build。

和临时协作工具有什么关系？

没有产品绑定。只是要对着 diff 讲两句时，临时会议工具对比说明何时用短时浏览器空间即可。

免费创建空间