命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
连接GitHub账户以使用网页版功能
/web-setup 是 Claude Code CLI 内的内置会话命令。它读取本地 GitHub CLI (gh) 的已认证 token,将其同步到你的 Claude 账户,并在你尚无云端环境时自动创建一个默认云端环境。完成后即可从终端发起云端会话(--remote)或配置定期任务(/schedule)。
这是浏览器引导流程的终端快捷替代路径,面向已使用 gh CLI 的开发者。
平台 / 订阅要求(来源:官方文档原文):
# 若尚未认证 GitHub CLI,先执行
gh auth login
# 若尚未登录 claude.ai 账户,先执行
/login
# 核心命令
/web-setup
执行后:
gh token 被同步到你的 Claude 账户gh 未安装或未认证,则自动打开浏览器引导流程# 将当前任务以云端模式运行
claude --remote
# 在 CLI 内配置定期自动任务
/schedule
/web-setup 创建的默认云端环境可在 claude.ai/code 中后续编辑,字段如下:
| 字段 | 说明 |
|---|---|
| Name | 显示标签,有多个环境时用于区分 |
| Network access | 网络访问级别,默认 Trusted(允许 npm / PyPI / RubyGems 等常见包注册表,屏蔽通用互联网) |
| Environment variables | .env 格式,值不要加引号(引号会被存入值本身) |
| Setup script | 可选 Bash 脚本,在 Claude Code 启动前运行;结果被缓存,不会每次会话重跑 |
| 约束 | 原因 / 说明 |
|---|---|
| CLI 版本须 ≥ v2.1.80 | 低于此版本报 "Unknown command" |
| 须以 claude.ai 订阅账户登录 | API key / 第三方 provider 不支持云端会话 |
须先完成 gh auth login | /web-setup 读取本地 gh token;未认证则回退到浏览器流程 |
| 须在 Claude Code CLI 内输入 | 在 shell 提示符下输入无效 |
| Zero Data Retention 组织不可用 | 组织策略禁止云端会话特性,无法绕过 |
| Enterprise 组织需管理员启用 | 报 "Not available for the selected organization" 时需联系 Anthropic 客户团队 |
| 方式 | 操作入口 | 前提 | 适合人群 |
|---|---|---|---|
/web-setup | Claude Code CLI | 已完成 gh auth login | 常用终端的开发者 |
| 浏览器引导流程 | claude.ai/code | 仅需浏览器 + GitHub 账户 | 首次配置或不使用 gh CLI 的用户 |
两种方式的最终结果相同:GitHub 账户与 Claude 账户关联,云端环境就绪。
gh 管理 GitHub 认证的开发者:跳过浏览器,单条命令完成云端环境初始化/web-setup 后立即用 claude --remote 将任务分发到 Anthropic 云端 VM 运行,无需本地守候/schedule 设置定期在云端自动执行的任务(如夜间跑 CI、每日生成报告)在 shell 中输入 /web-setup 无效:此命令须在 claude 进程内部输入。先运行 claude 进入 CLI 交互界面,再输入 /web-setup。
报 "Unknown command":两种原因——CLI 版本低于 v2.1.80,或当前以 API key / 第三方 provider 登录。先运行 claude update 升级,再运行 /login 切换为 claude.ai 账户登录。
Zero Data Retention 组织无法使用:这是组织级别的策略约束,/web-setup 及所有云端会话功能均被禁用,属于不可绕过的硬限制。
Enterprise 组织报 "Not available for the selected organization":需由组织管理员联系 Anthropic 客户团队开启 Claude Code on the web 功能。
/web-setup 完整步骤与 troubleshooting 原文)