CLI codert

从源码构建并首次部署

cd /path/to/codeRuntime
pnpm install --frozen-lockfile
pnpm --filter @coderuntime/cli --fail-if-no-match build
export XDG_CONFIG_HOME=/tmp/codert-ac39-config
rm -rf "$XDG_CONFIG_HOME"
node apps/cli/dist/index.js deploy ./dist --origin https://coderuntime.com

将 ./dist 换成含 index.html 的目录；将 --origin 换成当前控制面。成功后打印预览 URL 与版本，从不打印 Guest Token。

Guest Token 与 project 绑定写入 ~/.config/codert/config.json（权限 0600）。请勿将该文件提交到 git 或分享给他人。

再次部署（同项目）

# 修改静态文件后再次执行同一命令即可
node apps/cli/dist/index.js deploy ./dist --origin https://coderuntime.com

CLI 自动附带已保存的 Bearer Token 与 projectId。稳定预览 Host 不变，版本递增；失败部署不覆盖当前 ready。

认领到邮箱账号

node apps/cli/dist/index.js claim --origin https://coderuntime.com

CLI 打印认领链接与 6 位校验码；浏览器完成邮箱登录授权后，在原终端输入同一校验码确认。确认成功后 Guest 凭据轮换为 Account Token。丢失 Guest Token 无法走人工绕过。

额度与安全注意

• 匿名 Guest 仅 1 个项目；超限时 CLI 展示 problem 错误码并提示认领。
• 预览默认公开；不要部署含密钥的前端配置。
• 控制面与预览 Host 分离；Cookie 模式站点不在页面中渲染 Token。

返回快速开始 · HTTP API