文档 · 接入

命令行

在终端里配置 Origin MCP、安装 Origin Runner，以及在脚本和 CI 中用部署脚本发布游戏。

一行安装 Origin MCP

在 macOS、Linux 或 WSL 终端运行：

curl -fsSL https://origingame.ai/install.sh | sh

这个脚本会：

读取 Origin 的线上安装目录，目前其中只有统一的 origin MCP（https://mcp.origingame.ai/mcp）。
检测 PATH 上的 Claude Code（claude）、Codex（codex）和 Grok（grok），请你确认要配置哪些。
在每个选中的 Agent 的用户级配置里写入 origin。支持浏览器登录的 Agent（Claude Code、Codex）只写入地址，第一次使用时自己打开浏览器登录；其余 Agent 共用一次浏览器设备登录得到的可撤销凭据，保存在 ~/.origingame/connector-credential（权限 0600）。
移除早期版本写入的 origin-assets、origin-generate 等旧条目（只移除地址与 Origin 发布的地址完全一致的条目），并报告保留的条目。

它不安装任何 Origin 程序、运行时或常驻进程。重新运行同一条命令即可更新；设备登录可在访问凭据的「已登录设备」里撤销。脚本需要 curl、unzip 和 sha256sum（或 shasum）。

参数	作用
`--agents claude,codex,grok`	只配置列出的 Agent（逗号分隔），也可以写 `all` 表示所有检测到的 Agent；不加时脚本检测后请你确认
`--keep-legacy`	保留旧的分领域 MCP 条目
`--project`	把目录中的 Skill 装进当前项目，凭据和 MCP 配置仍留在用户目录
`--aigcc`	只安装 AIGCC 所需内容；安装目录只含 MCP 时，安装统一的 `origin` MCP，不附带本地上传工具
`--help`	显示用法

通过管道传参数时，在 sh 后加 -s --：

curl -fsSL https://origingame.ai/install.sh | sh -s -- --agents claude,codex

注意：脚本只支持默认配置目录，设置了自定义 CLAUDE_CONFIG_DIR 或 CODEX_HOME 时会停止。

Windows 上没有 PowerShell 版安装脚本：按 Origin MCP 的步骤直接添加地址，或使用 Origin Kit。

Origin Runner

Origin Runner 让 Origin 的线程在你自己的电脑上执行，游戏仓库保存在你的文件夹里。它不持有模型密钥或账号凭据。

macOS / Linux 安装：

curl -fsSL https://origingame.ai/downloads/runner/install.sh | sh

Windows 在 PowerShell 中运行，不需要管理员权限，安装到 %LOCALAPPDATA%\Origin。Windows 版尚未在真实的 Windows 主机上验证。

irm https://origingame.ai/downloads/runner/install.ps1 | iex

安装后连接到你的账号：

打开 Origin Runner 页面，填写名称并点「生成令牌」。令牌只显示一次；你的账号里需要已有至少一个游戏仓库。
运行页面上给出的命令：origin-runner login 从标准输入读取令牌并写入 ~/.origin/runner/token；origin-runner service install 带上页面给出的 --runner-id，以 --dir ~/Games 作为游戏文件夹，并安装常驻服务（Linux 为 systemd 用户服务，macOS 为 LaunchAgent，Windows 为计划任务）。

在网页上创建的游戏，第一次在这台电脑上运行会话时会克隆到 ~/Games，每个会话在旁边有自己的 Git 工作树。已有的检出可以用 --dir PATH=REPOSITORY_ID 提供。在 Linux 上，service install 会开启 lingering，让 Runner 在无人登录时也随开机启动。

在 macOS 上，Origin Kit 自带 Origin Runner，可以在 Kit 的「Runner」页面开启，不需要单独安装。Origin Runner 页面显示每个 Runner 是否在线，也可以随时撤销。

Skill 仓库与部署脚本

不使用 MCP 的脚本和 CI 可以用 Skill 仓库中的部署脚本发布游戏。它从环境变量读取账号 API Token：

获取 API Token

git clone https://github.com/fran0220/origingame-skill
export OG_API_KEY=og-...
export OG_HOST=https://origingame.ai
origingame-skill/scripts/deploy.sh ./dist --title "Neon Dodge" --cover cover.png

./dist 是构建好的游戏目录，--cover 是横版封面。更新已有游戏、引擎、类型、可见性等全部选项写在脚本开头的注释里。发布要求、版本与回滚见发布游戏。

注意：已经通过安装脚本或 Origin Kit 配置了 Origin MCP 的 Agent 应直接使用 MCP 发布，不要再为它另建 API Token。

环境变量

Skill 仓库的脚本读取以下环境变量：

变量	含义	未设置时
`OG_API_KEY`	账号 API Token（`og-...`），在访问凭据创建	需要凭据的命令报错退出
`OG_HOST`	Origin 网站的地址，用于发布游戏（`/api/deploy`）；正式环境设为 `https://origingame.ai`	`http://localhost:8787`
`OG_AI_GATEWAY`	Origin 公共 API 的主机，不带 `/v1`：模型接口在 `$OG_AI_GATEWAY/v1/...`	`https://api.origingame.ai`

不要把 OG_API_KEY 提交到仓库或写进游戏代码。在 CI 中用平台的密钥功能注入。

下一步

发布游戏：发布要求、更新、版本与回滚。
模型 API：用 OG_API_KEY 直接调用 https://api.origingame.ai/v1。
Origin MCP：在 Agent 里使用平台工具。