命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
配置网络会话的默认远程环境
/remote-env 是 Claude Code CLI 内的 slash 命令,作用是为 --remote 派发的云端会话选择默认环境(cloud environment)。官方命令参考逐字定义为「Choose the default environment for cloud agents」。
关键澄清:/remote-env 只负责"选默认",不负责"增/改/归档"。官方原文:「/remote-env only selects the default; add, edit, and archive environments from the web interface.」——环境的创建、编辑、归档全部在 claude.ai web 界面完成,终端这条命令只是把其中某个设为 --remote 的默认。若你只有一个环境,运行 /remote-env 会显示当前配置(而非空列表)。
环境(environment)= 运行 Claude Code on the web 时所用的 Anthropic 托管沙箱的一套配置:网络访问级别 + 环境变量 + setup 脚本。同一份配置可被多个云端会话复用。
计划/订阅要求: Claude Code on the web 处于研究预览,支持 Pro、Max、Team,以及持有 premium seats 或 Chat + Claude Code seats 的 Enterprise 用户(API key 不支持)。
在任意 Claude Code CLI 会话内输入:
/remote-env
命令无可验证来源的必填参数。它打开/显示环境选择器,让你把某个 web 端已建好的环境设为 --remote 派发时的默认。
No remote environments available.(此空态字面文案无官方一手出处,见下文 issue #19573)。先到 claude.ai web 界面 Add environment 建一个再回来选。环境的增删改在 web 界面,选默认在终端。完整动作分工(均出自官方 claude-code-on-the-web#configure-your-environment):
| 动作 | 在哪做 | 怎么做 |
|---|---|---|
| 新增环境 | web | 点当前环境打开选择器 → Add environment;对话框填 name、网络访问级别、环境变量、setup 脚本 |
| 编辑环境 | web | 点显示当前环境名的云图标打开选择器 → 悬停某环境 → 点右侧设置图标 |
| 归档环境 | web | 在编辑对话框选 Archive;归档后从选择器隐藏,但已有会话继续运行 |
选为 --remote 默认 | 终端 | 运行 /remote-env;单环境时显示当前配置 |
没有独立的 Environments 页面——云图标出现在任何你启动云端会话或配置 routine 的地方。
| 配置项 | 说明 |
|---|---|
| 网络访问级别 | 默认 Trusted(放行 npm/PyPI/RubyGems/crates.io 等常见 registry);可设 None(全断,setup 脚本装包会失败)或 Custom(自填 Allowed domains,每行一个域名) |
| 环境变量 | .env 格式,每行一个 KEY=value,值不要加引号(引号会被当作值的一部分存进去) |
| setup 脚本 | 新云端会话启动前、Claude Code 启动前运行的 Bash 脚本,用于装依赖/配工具。首次跑完后 Anthropic 快照文件系统(environment caching),后续会话直接用快照、跳过脚本;改脚本或改允许域、或约 7 天过期时重建。建议总时长 < 5 分钟 |
密钥/凭据警告:目前没有专用 secrets store。环境变量和 setup 脚本都存在环境配置里,任何能编辑该环境的人都能看到——按此可见性来放敏感值。自定义基础 Docker 镜像也尚不支持,只能用 setup 脚本在官方提供的镜像上叠加,或用 docker compose 跑自己的镜像作为旁挂容器。
setup 脚本 vs SessionStart hook:前者挂在云环境、配在云 UI、受缓存加速、只在云端跑;后者挂在仓库
.claude/settings.json、每次会话(含 resume)都跑、本地云端都生效(用CLAUDE_CODE_REMOTE环境变量可只在云端跑)。
--remote 派发的关系/remote-env 选的默认环境,正是 claude --remote <task> 派发云端会话时所用的环境来源。
# 从终端派发一个云端会话(用 /remote-env 选定的默认环境)
claude --remote "Fix the authentication bug in src/auth/login.ts"
--remote 在 claude.ai 上新建一个云端会话,克隆当前目录的 GitHub remote 在当前分支的代码(VM 从 GitHub 克隆而非你本机,有本地未推 commit 要先 push),一次只处理单个仓库;任务在云端跑,你本地继续工作。用 /tasks 查进度,或在 claude.ai / 手机 App 直接交互。
三个相近概念别混:
--remote= 新建云端会话(用/remote-env选的环境);--teleport= 把已有云端会话拉回本地终端继续(CLI 侧握手是单向的:能拉回、不能把本地推上云);--remote-control(别名/rc)= 把本地 CLI 会话暴露出来供 web/手机监控,代码仍在本机跑,与云端环境无关。
| 原语 | 触发方式 | 执行位置 | 用途 |
|---|---|---|---|
/remote-env | 会话内 slash 命令 | — | 查看远程环境列表 |
/remote-control（别名 /rc） | 会话内 slash 命令 | 本地机器 | 将本地会话暴露给 claude.ai/code 或移动端 |
claude --remote-control | CLI 启动标志 | 本地机器 | 启动时即开启 Remote Control |
claude remote-control | CLI 子命令 | 本地机器 | 以服务器模式启动，等待多个远程连接 |
--remote flag | CLI 启动标志 | Anthropic 云 | 将本地任务迁移到云端沙箱执行 |
核心区别: /remote-control 让你的本地会话从远程设备可见,代码仍在本机跑;/remote-env 管理的是完全运行在 Anthropic 云端的沙箱环境(Claude Code on the web)。
claude --remote 派发到正确环境。claude --permission-mode plan 本地规划 → 保存计划 push → claude --remote "Execute the migration plan in docs/migration-plan.md" 在云端自治执行。Error: Unable to create remote session 等错误。显示 "No remote environments available." 但订阅和 GitHub 均已连接
GitHub issue #19573 记录了此问题:即使持有 Claude Max 订阅、完成 /login 且已授权 GitHub 仓库,/remote-env 仍可能返回空列表。该 issue 原文明确表示 「no known workaround」(无已知绕过方式),且以 closed-as-duplicate 关闭,未提供任何解决路径。
注意:Anthropic Platform 的
ant beta:environments create属于 Managed Agents API(需ANTHROPIC_API_KEY),与 Claude Code on the web(claude.ai OAuth 账号体系)是两套完全独立的产品,不能用于解决本 issue。
/remote-env 与 /remote-control 混淆
两者名称相近,功能截然不同。/remote-control(别名 /rc)让你从手机或浏览器继续本地会话;/remote-env 管理的是在 Anthropic 云端运行的沙箱。误用会导致预期行为不符。
为 claude.ai 订阅者新增斜杠命令，允许恢复和配置远程会话