快速开始

这条路径安装当前正式版本，启动一个本机 instance，并部署最小 Worker。正式二进制支持 Apple silicon macOS、ARM64 Linux 和 x86-64 Linux。

让 AI coding agent 完成安装

把下面这段提示复制到 Codex、Claude Code 或其他 coding agent。代码块自带一键复制按钮：

阅读 https://open-compute.dev/llms.txt，在这台机器上安装 open-compute 当前正式版本并配置一个本机 instance。先检查已有安装，默认保留现有配置和 instance 数据；使用 sudo 或执行破坏性操作前先询问我。最后运行 ocd status，并报告结果。

llms.txt 只包含最基本的 setup 和使用方式，需要时再按链接读取详细文档。

1. 安装

安装最新正式版本：

curl -fsSL https://open-compute.dev/install.sh | sudo sh

Installer 会选择当前平台对应的二进制文件，验证 release checksum，并把 ocd 安装到 /usr/local/bin。

2. 初始化平台

创建推荐的系统配置、注册 managed service，并启动第一个 instance：

sudo ocd setup --yes

随后验证 instance 并打开 Dashboard：

ocd status
ocd dashboard

status 必须显示 ready。dashboard 打开一次性登录 URL，不要求复制长期 admin token。

3. 创建 Worker 项目

创建普通 Wrangler 项目，并把 Wrangler 固定为项目依赖：

mkdir hello-worker
cd hello-worker

npm

npm init -y
npm install --save-dev wrangler@4.127.1 @open-compute/workers-types

pnpm

pnpm init
pnpm add --save-dev wrangler@4.127.1 @open-compute/workers-types

bun

bun init -y
bun add --dev wrangler@4.127.1 @open-compute/workers-types

mkdir src

创建 src/index.ts：

export default {
  fetch(request: Request): Response {
    return Response.json({
      message: "hello from open-compute",
      path: new URL(request.url).pathname,
    });
  },
} satisfies ExportedHandler;

创建 wrangler.jsonc：

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "hello-worker",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-08",
  "workers_dev": false
}

4. 开发与部署

快速本地循环直接使用 Wrangler：

npm

npm exec -- wrangler dev

pnpm

pnpm exec wrangler dev

bun

bun run wrangler dev

随后通过选中的 open-compute instance 部署：

ocd wrangler deploy

使用 Wrangler 输出的平台路径访问 Worker。查看实时日志：

ocd wrangler tail

下一步阅读开发应用了解 environment 和远程 target，阅读运行与运维配置生产环境，或查看产品添加 bindings。