3.5 工作空间（Workspaces）
概述
工作空间是 Claude Code 的多项目隔离机制。每个工作空间拥有独立的标识符（wrkspc_ 前缀）和配置，适用于需要同时管理多个项目或进行团队协作的场景。
核心概念
工作空间标识符
每个工作空间拥有唯一的标识符：
wrkspc_abc123def456 # 工作空间标识符示例
与项目的区别
| 特性 | 普通项目 | 工作空间 |
|---|---|---|
| 隔离级别 | 会话级别 | 组织级别 |
| 上下文共享 | 仅当前会话 | 可跨会话共享 |
| 团队协作 | 不支持 | 支持 |
| 权限管理 | 无 | 基于角色 |
角色权限
工作空间支持多级角色：
| 角色 | 权限范围 |
|---|---|
| Workspace User | 使用工作空间，无法修改配置 |
| Limited Developer | 读取和写入文件，无法执行危险操作 |
| Developer | 完整开发权限，可执行命令 |
| Admin | 管理工作空间成员和设置 |
| Billing | 管理账单和订阅，无开发权限 |
使用场景
多项目并行管理
当你同时参与多个项目时，工作空间可以保持每个项目的上下文独立：
# 项目 A
→ /workspace switch wrkspc_project_a
# 项目 B
→ /workspace switch wrkspc_project_b
团队协作
团队成员可以在同一工作空间中协作：
# 查看工作空间成员
→ /workspace members
# 添加成员
→ /workspace add-member user@example.com Developer
企业级管理
企业组织可以使用工作空间进行项目级别的资源管理：
- 限制某些工作空间的 API 使用量
- 为不同团队分配不同权限
- 统一管理多个项目的上下文
管理命令
查看当前工作空间
/workspace current
切换工作空间
/workspace switch <workspace-id>
列出所有工作空间
/workspace list
创建新工作空间
/workspace create --name "新项目"
限制
- 每个组织最多 100 个工作空间
- 工作空间切换需要有效的组织成员资格
- 部分角色需要组织管理员授权
与普通会话的切换
工作空间和普通会话可以随时切换：
# 从工作空间退出，使用本地项目
→ /workspace exit
# 或直接指定本地路径
→ cd ~/projects/my-local-project
→ claude