安装与配置开发环境

安装百积木客户端、CLI 和 Codex，登录账号、切换工作区并完成开发前验收。

完成本页后，本机应同时具备百积木客户端、baijimu CLI 和 Codex，并且能够确认当前账号与工作区。不要在工具尚未验收或工作区不明确时开始写入项目。

安装百积木客户端和 CLI

从百积木客户端下载与当前操作系统和 CPU 架构匹配的官方安装包。客户端安装包会同时安装 baijimu CLI；不要从其他来源复制可执行文件或认证文件。

安装完成后重新打开终端，执行：

baijimu --version
baijimu capabilities --offline --json

第一条命令应返回版本号，第二条命令应返回与当前 CLI 版本绑定的命令树和文档入口。完整的登录及验收说明见安装百积木 CLI。

baijimu auth login
baijimu auth status --verify

在浏览器中完成设备授权。auth status --verify 必须确认服务端登录有效；不要把 token、密钥、Cookie 或本机认证文件内容复制到项目、Git 仓库或 Agent 对话中。

先列出当前账号可以访问的工作区：

baijimu workspace list

确认目标工作区的准确 ID 后，设置并回读默认工作区：

baijimu workspace use <workspaceId>
baijimu workspace current

workspace use 修改本机共享的默认工作区。多个任务需要并行使用不同工作区时，使用下面的会话模式获取仅供当前任务使用的环境变量，不要反复覆盖共享默认值：

baijimu workspace use <workspaceId> --session

具体输出和使用方式以本机 baijimu workspace use --help 为准。执行创建、修改、构建、安装、升级或发布前，都要重新运行 baijimu workspace current。

切换工作区不会切换其他目标

CLI 默认工作区只决定后续平台命令的默认授权范围。它不会切换当前终端目录、本地 Git 仓库、项目 ID、Codex 个人登录，也不会替你选择开发、测试或生产环境。

在百积木客户端的“应用”中安装 Codex Connector。连接器会完成 Codex 所需组件、隔离的工作区模型凭证和真实调用验证；已有个人 ChatGPT/Codex 登录会保持不变。

按照Codex 个人用户安装完成安装，直到连接器页面明确显示全部检查通过。然后在新终端中确认：

codex --version

设备安装的底层脚本、凭证传递和验收规则由Codex 设备安装执行规范维护。普通开发者不应手工拆分或改写该流程。

开始项目开发前，以下结果必须同时成立：