用途
本技能用于安装和验证独立的 Anthropic Claude Code CLI（命令 claude）。Agent 负责终端操作，客户只需说明目标，并在官方浏览器或系统授权界面完成登录。适用于希望安装 Claude Code CLI、遇到「Claude 命令不存在」、需要检查或更新版本，或需要完成 Claude 登录授权的场景。
主要能力
- 安装 Claude Code：检查系统和已有来源，使用官方用户级渠道安装，展示当前版本、来源、安装目录和验证结果。
- 检查或更新：比较当前版本与官方最新版；在明确授权后沿原来源更新，并给出「无需更新」「可更新，未执行」或「已更新」的结果。
- 登录 Claude：启动 claude 官方登录流程，展示浏览器授权步骤，不显示凭据。
- 命令不可用排查：检查 PATH、重复安装和 claude doctor，给出阻塞原因与安全修复方案。
使用方式
客户直接说明「帮我安装 Claude Code CLI」，不需要复制终端命令。Agent 先执行只读检查并展示计划；安装请求只授权安装缺失的 CLI，不授权更新已有版本。只说「更新 Claude」时先显示两个版本并询问是否更新到最新；只有「更新到最新版本」等明确表述才调用更新器。需要登录时由 Agent 启动流程，客户在 Anthropic 官方页面点击授权，不得把授权码、API key 或密码发到聊天中。安装、更新和登录后分别验证独立 CLI 的版本、帮助命令、诊断结果和登录状态。
标准流程包括：执行 python3 scripts/inspect_cli.py --json 只读获取命令、版本、路径、安装方式与配置目录状态；执行 python3 scripts/check_latest.py --json 从 npm 官方发布元数据取得最新版，失败时写「未取得」；已安装且可运行则当前状态写「已安装」，无最新版授权即停止；未安装时优先官方独立安装，客户选择 npm 时才使用 npm install -g @anthropic-ai/claude-code；更新到最新时官方独立来源用 claude update，npm 来源用 npm install -g @anthropic-ai/claude-code@latest，Homebrew 来源先识别实际 cask 再更新；最后用 scripts/render_status.py 生成客户状态列表。
首次登录与配置验证要求同时读取 config_status 和 config_file_status，不能把默认路径当成「已配置」。若配置目录或文件尚未创建，Agent 在客户选定项目中启动 claude，由 Claude Code 展示官方登录选项；登录完成后重新运行 claude doctor 和检查脚本，未完成浏览器授权时处理结果写「等待首次登录」。
回复以固定十列表格开头（技能、当前状态、当前版本、最新版本、运行状态、安装方式、安装目录、配置文件目录、更新时间、处理结果），只输出一行 Claude Code CLI。安装目录和配置目录优先显示 ~ 相对路径。更新时间在最终验证后生成。发现多个 claude 时汇报当前登录 shell 实际生效的副本并提示冲突，不删除其他副本。真正改变机器时生成 run_id，按 checking → planning → [waiting_confirmation] → installing/updating → verifying → completed/failed/blocked 阶段记录，记录只保存固定 result_code、阶段和时间，不保存命令全文、账号、token、响应正文或私有绝对路径。
国内网络环境下 npm 渠道安装超时或下载失败时，可先切换 npmmirror 镜像源再重试，完成后按需切回官方源：
npm config set registry https://registry.npmmirror.com # 切国内镜像
npm config set registry https://registry.npmjs.org # 切回官方源
依赖
macOS、Linux 或 Windows 为强依赖，只使用官方文档支持的系统与架构；Node.js/npm 为 npm 渠道依赖，官方独立安装不需要，选择 npm 时才调用 soia-env-node-install；网络诊断为可选前置，官方站点失败时调用 soia-env-network-diagnose，不自动修改网络；Anthropic 账号为登录依赖，客户在官方浏览器完成授权。
适用场景与限制
适用场景为 Claude Code CLI 的安装、版本检查、更新与登录引导。能力边界包括：不代客户完成登录与授权，浏览器授权、验证码、API key 创建由客户在 Anthropic 官方页面完成，不读取、不接收、不回显任何凭据；默认不更新已装版本，「帮我安装」只授权安装缺失的更新需明确表述；不动系统，不默认 sudo，不改 shell profile 与 PATH，不卸载或清理其他 claude 副本；不负责 Claude 桌面应用与账号计费。产品自动更新边界：本技能「默认不更新」指 Agent 不调用安装器或更新器，但 Claude Code 产品自身可能启用自动更新，必须在状态说明中披露；只读检查不得修改 autoUpdates、DISABLE_AUTOUPDATER 或任何配置。
安装
装整个域（Claude Code 与 Codex 共用同一份域插件）：
claude plugin marketplace add soia-team/soia-open-skills
claude plugin install soia-env@soia
只装这一个技能：
npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-claude-cli-install -y
WorkBuddy 的装载单位是角色化专家而不是插件，npx skills add -a '*' 覆盖不到它，需要单独安装。