安装

Baize 自托管：运行在你自己的机器或你控制的服务器上。

前置条件

• Node.js >= 20
• Linux 服务器或 macOS
• Claude 订阅或 OpenAI Codex 环境（Codex CLI v0.129.0+，推荐 0.146+）

中国大陆：Claude 官方服务（claude.ai）不可达，建议使用 Codex runtime——npm 版即官方最新，npmmirror 已同步；安装时 --cn 会默认选择 Codex。

手动安装（npm）

npm install -g @baize-ai/core
baize init

baize CLI 以 @baize-ai/core 发布到 npm。baize init 负责搭建完整环境，可随时安全重跑。

Docker 部署

镜像由已发布的 @baize-ai/core npm 包构建（构建上下文不含源码）。

国内（阿里云 ACR，直连免加速——推荐）：

docker run -d --name baize \
  --restart unless-stopped \
  -p 3456:3456 \
  -p 8443:8443 \
  -e TZ=Asia/Shanghai \
  -e BAIZE_WEB_PASSWORD='<控制台登录口令>' \
  -v baize-data:/home/baize/baize \
  -v claude-config:/home/baize/.claude \
  crpi-8bg62qbrjs3cr3as.cn-hangzhou.personal.cr.aliyuncs.com/baize01/baize-core:0.3.15

海外（GitHub Container Registry）：

docker run -d --name baize \
  --restart unless-stopped \
  -p 3456:3456 \
  -p 8443:8443 \
  -e TZ=Asia/Shanghai \
  -e BAIZE_WEB_PASSWORD='<控制台登录口令>' \
  -v baize-data:/home/baize/baize \
  -v claude-config:/home/baize/.claude \
  ghcr.io/baize01-ai/baize-core:0.3.15

• baize-data —— Agent 主目录（~/baize）：记忆、技能、服务。容器内路径固定为 /home/baize/baize，多实例也只换卷名和宿主端口、不改容器路径
• claude-config —— AI 运行时的配置（~/.claude）
• 端口 3456 —— 网页控制台；端口 8443 —— A2A daemon（启用 A2A 协作时需放行防火墙）

完整说明（端口、卷、多实例）见 Docker 部署。

安装之后

打开 http://localhost:3456 进入网页控制台，在「模型设置」中配置认证——Claude API key / setup token / 自定义端点，或 Codex / ChatGPT 登录。

中国大陆：默认使用 Codex 模式（保存 API key 即生效，无需登录 OAuth）。不建议切换为 Claude Code（cc）——官方服务不可达，切换会导致 Agent 无法启动。若使用第三方 OpenAI 兼容 API（如 DeepSeek），在供应商配置中填写对应的 base_url 与模型名。

首次对话建议：配置完成后，在「聊天」窗口发送以下内容，确认 npm 源可访问（第三方 API key 已配置时 Agent 会执行并回复结果）：

请确认当前环境的 npm 源（registry）是否为 https://registry.npmmirror.com；如果不是，请将全局 npm 源切换为 https://registry.npmmirror.com。