by 运行时依赖
安装命令
点击复制技能文档
OpenCode AI - AI 代码编辑器 OpenCode 是一个原生 AI 代码编辑器，运行在您的终端（CLI/TUI）。可以将其想象为 Cursor/Windsurf，但在终端中。 版本：1.3.9 | 平台：macOS Darwin x64 前置条件 OpenCode 需要 sysctl 来检测架构。确保 /usr/sbin 在 PATH 中：export PATH="/usr/sbin:/usr/bin:/sbin:/bin:$PATH" # 添加到 ~/.zshrc 以使其永久生效 何时使用 ✅ 使用：复杂重构、AI 辅助功能、PR 审查/修复、代码库探索、多文件编辑、基于会话的编码 ❌ 不使用：简单的一行编辑（使用 edit 工具）、读取文件（使用 read 工具） 核心命令 快速任务（一次性） # 运行单个任务 opencode run "在登录表单中添加输入验证" opencode run --dir ~/project "重构以使用 async/await" opencode run -m anthropic/claude-sonnet-4 "优化查询" # 附加文件以提供上下文 opencode run -f src/auth.js -f src/db.js "修复身份验证错误" # 继续上一个会话 opencode run --continue opencode run --session abc123 --fork # 共享会话（创建可共享链接） opencode run --share "实现功能 X" # 模型变体（推理努力） opencode run --variant high "解决这个复杂问题" 关键选项 选项 描述 -m, --model 模型（提供者/模型，例如 anthropic/claude-sonnet-4） -c, --continue 继续上一个会话 -s, --session 继续特定会话 --fork 在继续时分叉会话 --share 共享会话 -f, --file 附加文件到消息 --agent 使用特定代理 --dir 运行目录 --format 输出格式：默认或 json --variant 推理努力：high, max, minimal --thinking 显示思考块 --title 设置会话标题 --attach 附加到运行服务器（例如 http://localhost:4096） --pure 在没有外部插件的情况下运行 --command 运行特定命令（使用消息作为参数） -p, --password 基本身份验证密码用于服务器模式 交互式 TUI opencode # 在当前目录开始 opencode ~/project # 在特定项目中开始 TUI 斜线命令 /sessions — 会话选择器（继续现有或创建新会话） /agents — 切换代理（见下面的代理） /models — 模型选择器 /title — 更改会话标题 /summary — 生成会话摘要 /compaction — 压缩对话历史 可用代理 代理类型 目的 plan 主要 分析和设计（无代码编辑） build 主要 实现和编码 explore 子代理 了解代码库，仅读取探索 general 子代理 一般辅助 compaction 主要 压缩/总结会话上下文 summary 主要 生成会话摘要 title 主要 生成会话标题 memory-automation 子代理 自动内存管理 memory-consolidate 子代理 合并内存条目 ⚠️ --agent 标志在 opencode run 中始终回退到默认代理。代理切换仅在 TUI 中通过 /agents 斜线命令工作。 推荐工作流程：计划 → 构建 选择计划代理（/agents） 描述任务 → 审查/批准计划 切换到构建代理（/agents） 实现 → 迭代 其他命令 # 提供者和身份验证 opencode providers # 管理 AI 提供者/凭据（别名：auth） opencode providers login [url] # 登录到提供者 # 模型 opencode models # 列出所有模型 opencode models --verbose # 包括成本信息 opencode models --refresh # 刷新缓存 # 会话 opencode session list # 列出会话 opencode export [sessionID] # 以 JSON 导出 opencode import # 导入会话 # GitHub opencode pr 123 # 检出 PR + 运行 OpenCode opencode github --help # GitHub 代理选项 # MCP 服务器 opencode mcp list # 列出 MCP 服务器 opencode mcp add # 添加 MCP 服务器 opencode mcp auth [name] # OAuth 为 MCP 服务器 # 代理 opencode agent list # 列出代理 opencode agent create # 创建自定义代理 # 插件 opencode plugin # 安装插件（别名：plug） # 服务器模式 opencode serve # 无头服务器 opencode web # 服务器 + 打开浏览器 # ACP（代理客户端协议） opencode acp # 启动 ACP 服务器 # 附加到远程 opencode attach # 附加到运行实例 # 实用程序 opencode stats # 令牌使用和成本 opencode debug # 调试/故障排除工具 opencode upgrade [target] # 升级 opencode opencode uninstall # 删除 opencode opencode db # 数据库工具 与 OpenClaw 集成 您是编排者。OpenCode 是您的工人。 何时委托 多文件重构 复杂功能实现 PR 审查和修复 需要持续上下文的代码探索 何时自己做 简单的一行编辑 读取文件 快速命令 模式：通过 exec 委托 # 简单任务（前台，等待结果） opencode run "在身份验证模块中添加错误处理" # 复杂任务（后台，稍后检查） # 使用带有 b 的 exec