sitdraw

如何使用 OpenCode CLI：安装、配置 Provider、终端首个编码任务

安装 opencode、连接 Provider 并选模型，在项目目录跑 /init 后完成第一个带审阅的小编码任务。

要在终端用 OpenCode CLI 跑第一个编码任务，先完成四步：官方方式安装、配置 Provider（/connect 或 opencode auth login）、在仓库启动 opencode 并可选 /init，再审阅后批准首个小改动。

对照 opencode.ai/docs 的安装与 Configure 章节，以及 dev.opencode.ai/docs/cli 的 auth login 与 Providers。检索词 OpenCode CLI 安装、OpenCode 配置 Provider。这是 OpenCode 产品，不是本站会议工具。短会见 sitdraw，步骤见 如何创建与加入房间。

安装 opencode/connect · 模型/init · 首任务

TUI 与 CLI 登录各解决什么

/connect

在交互界面里选 Provider（含 OpenCode Zen）、浏览器 OAuth 或粘贴 API key，适合第一次上手。

auth login

终端直接跑 opencode auth login anthropic --method key 等，凭证写入 ~/.local/share/opencode/auth.json，适合脚本化或 SSH 会话。

/connect配置 Provider
/models选模型
/init生成 AGENTS.md
目标入口第一次怎么验收
安装install 脚本 / npm / Homebrewopencode 能进入 TUI 或 opencode --version
Provider/connect 或 opencode auth login/models 能列出并选中模型
项目上下文仓库根 opencode → /init根目录出现 AGENTS.md
首个任务@文件 只读问或单文件小 diff审阅变更 → 本地 git diff 核对

安装、配置 Provider、首个编码任务

  1. 01
    安装 OpenCode CLI

    macOS/Linux：curl -fsSL https://opencode.ai/install | bash。或 npm install -g opencode-ai、brew install anomalyco/tap/opencode。Windows 优先 WSL；也可 npm install -g opencode-ai。确认 opencode 在 PATH 中。

  2. 02
    配置 Provider 与模型

    运行 opencode，输入 /connect，新手可选 OpenCode Zen（按提示到 opencode.ai/auth 登录并粘贴 API key），或选 Anthropic/OpenAI 等。也可退出 TUI 后执行 opencode auth login 交互选择 Provider。连接成功后 /models 选定默认模型。密钥存 ~/.local/share/opencode/auth.json，勿提交 git。

  3. 03
    进入项目并 /init

    cd 到你的项目根（建议已 git init）。运行 opencode，执行 /init 生成 AGENTS.md 并提交进仓库。用 @ 搜文件，先问只读问题熟悉代码库。

  4. 04
    跑第一个编码任务

    描述小改动（例如在 README 顶部加一行项目说明，或给某函数加注释）。可先用 Tab 切到 Plan 模式看方案，再切回 Build 执行。批准 diff 后用 git diff 确认；不满意可用 /undo 回滚。

# First hour · OpenCode CLI · 2026-09
# curl -fsSL https://opencode.ai/install | bash
# npm install -g opencode-ai · brew install anomalyco/tap/opencode
# opencode → /connect → /models
# opencode auth login anthropic --method key  # optional CLI path
# cd my-repo && opencode → /init
# @README.md ask read-only · then small diff · git diff
# Docs: opencode.ai/docs · dev.opencode.ai/docs/cli
和 Codex CLI、Gemini CLI 怎么选？
OpenCode 是开源多 Provider终端 Agent，模型来自 models.dev 目录；Codex CLI 走 OpenAI/ChatGPT；Gemini CLI 走 Google。可对照 Codex CLI 教程 与 Gemini CLI 教程。
/connect 后没有模型？
确认 auth.json 已写入、运行 /models 或检查 Provider 账单/API key；项目 .env 中的变量需被 OpenCode 进程读到。
必须 /init 吗？
非强制，但官方推荐在仓库根跑 /init 生成 AGENTS.md，便于 Agent 理解结构与约定。
装完能当架构白板吗？
不能。要对齐模块图时开 sitdraw。

先 /connect，再小 diff

首个任务控制在单文件只读或小改动；auth.json 与 Provider 密钥当密码文件处理。

开始画