命令已经执行，Agent 还是说“无法访问浏览器”？web-access 的安装最容易卡在两个地方：一是把 Skill 安装入口和 Claude 插件入口混为一谈，二是文件装好了，却没把 Chrome 或 Edge 的远程调试打开。

安装命令没问题，问题在于选错入口

想让 Skills CLI 自动识别宿主，Claude Code 与 Codex 都可先走官方仓库给出的通用命令：

npx skills add eze-is/web-access

仓库声明兼容 Codex CLI，但安装后是否已进入 Codex 能扫描的目录，要看 Skills CLI 的检测结果和宿主提示；不要自行编造一条不存在的 Codex 专用插件命令。

只在 Claude Code 里按插件方式安装时，才使用这组命令：

claude plugin marketplace add https://github.com/eze-is/web-access
claude plugin install web-access@web-access --scope user

手动安装则是把仓库克隆到 ~/.claude/skills/web-access。三种方式选一种即可，重复安装反而容易让旧目录和新版本同时存在。

装完不等于浏览器已经能连

1. 确认 Node.js 为 22 或更高版本。项目的依赖检查会直接据此判断 CDP 环境能否启动。
2. Chrome 打开 chrome://inspect/#remote-debugging；Edge 打开 edge://inspect/#remote-debugging。
3. 勾选“Allow remote debugging for this browser instance”，按页面提示重启浏览器。
4. 在 Skill 目录运行 node "${CLAUDE_SKILL_DIR}/scripts/check-deps.mjs"。退出码为 0，才表示 Node、调试端口和 Proxy 已通过检查。

如果脚本询问浏览器类型，就在 config.env 写入 WEB_ACCESS_BROWSER=chrome 或 WEB_ACCESS_BROWSER=edge；只想临时测试，可给检查命令加 --browser chrome。成功后的表现不是“网页立刻弹到前台”，而是 Agent 能在新后台标签中列出页面、读取 DOM，并在任务完成后关闭自己创建的标签。若仍失败，先看检查脚本的退出码和错误行，别反复重装 Skill。