# 安装与配置开发环境

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

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

## 安装百积木客户端和 CLI

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

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

```bash
baijimu --version
baijimu --help
```

第一条命令应返回版本号，第二条命令应返回顶层命令组。精确参数通过目标命令的分级
`--help` 按需查询。完整的登录及验收说明见[安装百积木 CLI](/cli/installation/)。

## 登录百积木

```bash
baijimu auth login
baijimu auth status --verify
```

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

## 选择和切换工作区

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

```bash
baijimu workspace list
```

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

```bash
baijimu workspace use <workspaceId>
baijimu workspace current
```

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

```bash
baijimu workspace use <workspaceId> --session
```

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

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

## 开发环境验收

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

1. 百积木客户端已经登录且设备在线。
2. `baijimu --version`、`baijimu --help` 和目标命令的分级 `--help` 正常返回。
3. `baijimu auth status --verify` 确认登录有效。
4. `baijimu workspace current` 显示目标工作区。

验收完成后，继续[选择工作区并获取项目](/development/project-setup/)。