安装
你可以使用安装脚本或包管理器安装 Bob Shell。
系统要求
操作系统
macOS、Linux 或 Windows
内存
最低 4 GB RAM（推荐 8 GB）
存储
最低 500 MB 可用磁盘空间
网络
活跃的网络连接
Node.js
24 或更高版本
安装
Bob Shell 2.0.0 需要全新安装。目前没有从 1.0.x 自动升级的路径。你现有的设置和配置将在安装过程中保留。
选择通过安装脚本、包管理器或命令面板安装 Bob Shell。
使用安装脚本
选择您的操作系统，然后复制并运行命令以安装 Bob Shell。
curl -fsSL https://bob.ibm.com/download/bobshell.sh | bashcurl -fsSL https://bob.ibm.com/download/bobshell.sh | bashpowershell -c "irm -Uri https://bob.ibm.com/download/bobshell.ps1 | iex"从下载的软件包安装
如果您已从 Releases 页面手动下载了 Bob Shell 软件包，可以使用以下包管理器之一进行安装：
您必须修改以下命令，使用您下载文件的实际路径。
以下 Windows 命令必须使用 PowerShell 运行。
身份验证
Bob Shell 使用与所有其他 Bob 客户端相同的登录入口：bob.ibm.com/login。首次运行 Bob Shell 或会话过期后，Bob 会在浏览器中打开此页面。
有关登录工作原理的完整概述（包括 IBMid、SSO 和会话管理），请参阅登录。
根据您的使用场景，从 2 种身份验证方式中选择。
| 方式 | 适用场景 | 要求 |
|---|---|---|
| SSO / IBMid | 交互式会话 | 有效的 IBMid 或企业 SSO 账户、浏览器访问 |
| API key | 自动化、CI/CD pipeline、非交互式环境 | Bob 网页门户中的 API key、环境变量 |
SSO / IBMid 身份验证（默认）
当 Bob Shell 需要进行身份验证时，它会在浏览器中打开 bob.ibm.com/login。输入您的 IBMid 邮箱地址并点击继续，系统会自动将您路由到正确的身份提供商。
- 如果您的组织已配置 SSO，您将被重定向到公司的登录页面。
- 否则，您将被重定向到 IBMid。
在浏览器中完成身份验证后，返回到 Bob Shell。您的会话将自动建立。
API key 身份验证
API key 身份验证非常适合自动化、CI/CD pipeline 以及无法使用基于浏览器的身份验证的非交互式环境。
在 Bob 网页门户中创建一个范围设置为 Inference 的 API key。有关详细说明，请参阅 API key。
生成 key 后，下载或复制 key 值。请安全存储，因为您无法再次查看它。
切勿与任何人分享您的 API key。
使用您的 API key 值设置 BOB_API_KEY 环境变量：
export BOB_API_KEY="your-api-key-here"要使其永久生效，请将其添加到您的 shell 配置文件（~/.bashrc、~/.zshrc 等）：
echo 'export BOB_API_KEY="your-api-key-here"' >> ~/.bashrc$env:BOB_API_KEY="your-api-key-here"要使其永久生效，请使用：
[System.Environment]::SetEnvironmentVariable('BOB_API_KEY', 'your-api-key-here', 'User')设置 API key 后运行 Bob Shell：
bob run "your prompt"或启动交互式会话：
bob chat如果您的 API key 类型为 general（而非 Inference），在运行 Bob Shell 时还必须传递 --team-id <team-id>。