opencode

环境要求

• 类 Unix 终端环境，可用 curl 与 bash 执行安装脚本
• 网络可访问 GitHub（raw.githubusercontent.com）
• 至少一个 AI 提供商的 API Key（OpenAI、Anthropic、Groq、OpenRouter 等）
• 注意：该仓库已归档，官方建议改用 Charm 团队的 Crush 项目

安装与启动步骤

1. 1运行安装脚本

   用 curl 拉取官方 install 脚本并通过 bash 执行，安装最新版 opencode，需能访问 GitHub 原始文件地址。

   curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | bash

   复制

2. 2安装指定版本

   如需固定版本，用 VERSION 环境变量指定，README 示例为 0.1.0，替换即得其他版本。

   curl -fsSL https://raw.githubusercontent.com/opencode-ai/opencode/refs/heads/main/install | VERSION=0.1.0 bash

   复制

3. 3创建配置文件

   在 $HOME/.opencode.json、$XDG_CONFIG_HOME/opencode/.opencode.json 或当前目录 ./.opencode.json 任选一处新建配置文件。

4. 4填入密钥与模型

   配置 providers 中至少一个提供商的 apiKey，并在 agents 里指定 coder/task/title 使用的模型名称。

5. 5单次提问运行

   用 -p 直接传入提示词，程序处理完打印结果到标准输出后退出，该会话内所有权限自动批准。

   opencode -p "Explain the use of context in Go"

   复制

6. 6静默模式调用

   加 -q 或 --quiet 关闭等待时的 spinner 动画，适合在脚本或自动化流程中调用。

   opencode -p "Explain the use of context in Go" -q

   复制

7. 7启动交互式 TUI

   直接运行可执行文件进入终端交互界面，需先切换到二进制所在目录。

   ./opencode

   复制

关键配置

如何确认成功

执行 opencode -p "Explain the use of context in Go" 后，终端直接输出 AI 回答并正常退出，即说明安装与配置成功。

常见问题

注意事项

• 该项目 README 顶部已标注 Archived，不再维护，生产环境使用风险自负。
• README 同时标注处于早期开发阶段，功能可能变更、失效或不完整。
• API Key 属于敏感信息，不要把含密钥的 .opencode.json 提交到公开仓库。
• MCP 工具配置后会与内置工具一样需要用户逐次授权才能执行。