OpenCode 云服务器部署：安装、常驻与接入
截至 2026-10-20，可以在 QCode 云服务器上安装 OpenCode，用 opencode serve 常驻，再用 QCode Key 调用模型。云服务器与 AI 服务各自独立售卖，只共用账号与余额。
更新于 2026-10-20
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个部署要点
无头 HTTP 服务
官方 server 文档：opencode serve 启动一个 headless HTTP server，暴露 OpenAPI endpoint；默认端口 4096，默认监听 127.0.0.1。
完整 root 权限
QCode 云服务器是 KVM 主机，带独立公网 IPv4 与完整 root 权限，系统与数据由你自己管理。
试用时长
试用 1 天（24 小时），按所选配置计费；试用期内可在面板转成 1、3、6 或 12 个月，否则到期后服务器会被删除，数据不保留。
下单时可选
下单时可选填 SSH 公钥，并可勾选「只允许密钥登录（关闭 root 密码登录）」。当前没有网页控制台：私钥丢失后只能重装系统，数据会清空。
这台服务器上能做什么
在 QCode 云服务器上跑 OpenCode 的做法是：下单拿到带 root 权限的 KVM 主机，用 OpenCode 官方脚本安装，把 QCode 端点写进 opencode.json，再在 tmux 里运行 opencode serve。QCode 云服务器是一台海外机器，独立售卖，带一个独立公网 IPv4；它和 AI 服务是两个产品，只共用账号与余额。QCode 文档列出的地区是香港、日本、韩国、美国和德国，每个地区一条或多条线路。
官方页面怎么说
OpenCode 官方 server 文档（opencode.ai/docs/server，属于 OpenCode 1 的文档）写明 opencode serve 是无头 HTTP 服务，默认端口 4096、默认监听 127.0.0.1，可用 --hostname 与 --port 改；设置 OPENCODE_SERVER_PASSWORD 后启用 HTTP basic auth，用户名默认 opencode。QCode 文档的 OpenCode 页给出 ~/.config/opencode/opencode.json 的 QCode 端点写法。
时间线
QCode 的 OpenCode 接入页于 2026-10-20 核对，补充了 OpenCode 2 一节。
OpenCode 2 的 npm 包 @opencode/cli 发布 2.1.0；opencode.ai/docs 仍是 OpenCode 1 的文档，OpenCode 2 的文档在 opencode.ai/v2/docs。
QCode 云服务器文档与 Cloud 页面于 2026-10-20 核对：可以在线升级配置、每台最多 3 个快照，下单页可选填 SSH 公钥。
已确认 vs 没有核实到的
已确认（官方页逐字可核）
QCode 云服务器：海外独立机器、KVM、完整 root、每台 1 个独立公网 IPv4（开通后分配、不可更换）、香港 / 日本 / 韩国 / 美国 / 德国、1 天（24 小时）付费试用、试用期内可转 1、3、6 或 12 个月、可在线升级、每台最多 3 个快照。OpenCode：opencode serve 是无头 HTTP 服务，默认 127.0.0.1:4096，OPENCODE_SERVER_PASSWORD 启用 basic auth；OpenCode 1 的官方安装脚本是 curl -fsSL https://opencode.ai/install。
未证实与官方未公布
GitHub 上有一位用户报告（#56668，2026-10-18 创建，报告版本为 Desktop 2.0.32，截至 2026-10-20 仍是 open）：桌面端通过 SSH 添加新的远程服务器时，首次连接可能花数分钟下载或上传远程 OpenCode server，对话框只显示 Connecting over SSH…，看起来像卡住。这是用户报告，不是官方结论。
两种跑法的区别
opencode serve
无头 HTTP 服务，适合从别的客户端或脚本调用。默认只监听 127.0.0.1，远程访问要用 --hostname 改监听地址，并用 OPENCODE_SERVER_PASSWORD 保护。
本机 TUI
官方 server 文档写明：运行 opencode 会同时启动 TUI 和 server，TUI 是连接 server 的客户端；opencode serve 可以单独启动一个 server。
部署步骤
① 在 QCode 下单：选地区、线路、配置、系统与时长，试用选 1 天；网络步骤固定含 1 个独立公网 IPv4；设置 root 密码的步骤里可选填 SSH 公钥。② 开通后用 ssh root@服务器IP 登录，root 密码是下单时设置的。③ 按 OpenCode 官方安装页安装：curl -fsSL https://opencode.ai/install | bash。官方安装页把这个脚本作为安装 OpenCode 1 的方式；QCode 文档写明，页上的 provider / options.baseURL 配置在 OpenCode 1 和 OpenCode 2 中都能使用。OpenCode 2 的安装命令不同，两者默认不能并存，见常见问题最后一条。④ 写 ~/.config/opencode/opencode.json 的 QCode 端点，用 opencode auth login 写入 Key。⑤ 用 tmux 常驻：tmux new -s opencode，运行 OPENCODE_SERVER_PASSWORD=你的密码 opencode serve（默认只监听 127.0.0.1:4096），按 Ctrl+B 再按 D 分离；tmux attach -t opencode 回来。
在云服务器上配置 QCode 接入
QCode 文档的 OpenCode 写法：配置文件 ~/.config/opencode/opencode.json，Anthropic provider 的 baseURL 填 https://api.qcode.cc/claude/v1，OpenAI provider 填 https://api.qcode.cc/openai/v1；Key 通过 opencode auth login 或 /connect 写入；OpenCode 1 保存在 ~/.local/share/opencode/auth.json，OpenCode 2 存在 SQLite 并导入旧 auth.json。使用前要先开启 API direct access 权限：该权限默认关闭，需联系在线客服或发邮件到 hi@qcode.cc，为你购买的 API Key 开通。按 token 计费，各模型单价见 /models。不想包月？按量包 ¥25 起买一笔额度，7–90 天内用完为止（人民币充值 ¥100 起）。已有个人套餐的用户额度不够时买加油包。
常见问题
在云服务器上怎么安装 OpenCode？
用 OpenCode 官方安装页给出的脚本：curl -fsSL https://opencode.ai/install | bash。官方安装页把这个脚本作为安装 OpenCode 1 的方式。OpenCode 2 的安装命令不同，见本页最后一个问题。
断开 SSH 后 opencode serve 会停吗？
直接在前台运行会随连接结束。QCode 文档介绍用 tmux 保持任务（文档示例的会话名是 agent，会话名可自定，这里用 opencode）：tmux new -s opencode 新建会话，运行 opencode serve，按 Ctrl+B 再按 D 分离；之后用 tmux attach -t opencode 回来。tmux 会话在意外断线或主动脱离后仍会保留。
怎么让 OpenCode 用 QCode 的 Key 调模型？
照 QCode 文档写 ~/.config/opencode/opencode.json：Anthropic provider 的 baseURL 用 https://api.qcode.cc/claude/v1，OpenAI provider 用 https://api.qcode.cc/openai/v1。Key 用 opencode auth login 或 /connect 写入；OpenCode 1 保存在 ~/.local/share/opencode/auth.json，OpenCode 2 存在 SQLite 并导入旧 auth.json。使用前先开启 API direct access 权限。
买云服务器要同时买 AI 套餐吗？
不需要。QCode 文档写明云服务器与 AI 服务分开售卖，只共用账号和余额，在机器上跑 Claude Code 或 Codex 不代表必须买 AI 套餐。让 OpenCode 调用 QCode 的模型则要用你的 QCode Key，模型侧按 token 计费，各模型单价见 /models。
云服务器能升级配置或换线路吗？
可以在线升级配置：在服务器详情的「操作 → 升级与扩展」里选更高的配置，只补到期前的差价，立即生效，服务器会自动重启一次，到期日不变。暂不支持降级，也不能更换地区或线路；需要别的线路时，请另开一台。试用服务器转为正式后才能升级。
服务器上该装 OpenCode 1 还是 OpenCode 2？
取决于你照哪份文档。opencode.ai/docs（含 server 文档）是 OpenCode 1 的文档，curl -fsSL https://opencode.ai/install 安装的是 OpenCode 1；OpenCode 2 的文档在 opencode.ai/v2/docs，安装脚本是 curl -fsSL https://opencode.ai/v2/install | bash。两者都使用 opencode 命令，默认不能并存，OpenCode 2 的 curl 安装脚本会替换 V1 的二进制。opencode.json 的 QCode 写法见 QCode 的 OpenCode 接入页（2026-10-20 核对）；按 QCode 文档，页上的 provider / options.baseURL 配置在 OpenCode 1 和 OpenCode 2 中都能使用。
信息来源
QCode 云服务器文档（2026-10-20 抓取，含地区、试用、升级、快照、SSH 公钥）；QCode Cloud 页面（2026-10-20 抓取）；QCode 云计费文档（2026-10-20 抓取）；QCode 云服务器 Agent 文档（2026-10-20 抓取，含 tmux 与界面语言）；OpenCode 官方 server 与安装文档（2026-10-20 抓取）；QCode 的 OpenCode 接入页与按量包页面（2026-10-20 抓取）。
相关阅读
Claude Code 按量包：不包月，7–90 天有效
一次买一笔额度，7–90 天内随用随扣，不订阅；续买额度累加到同一把 Key。
OpenCode 会话共享下线（1.19.1）与升级 2.0
会话共享下线与升级到 OpenCode 2 的说明。
OpenCode 2026：200K+ Stars 开源编程助手
OpenCode 是什么、怎么安装、多代理与 BYOK，以及在 QCode 上接入。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
本页云服务器事实核对时间为 2026-10-20，以 qcode.cc/cloud 与 docs.qcode.cc 为准；OpenCode 事实核对于 2026-10-20，以 OpenCode 官方安装页与 server 文档为准；模型可用性与单价以 /models 为准，官方调整不另行通知。