企业官网建设流程全解析

1. 项目概述：这不是一个聊天窗口，而是一套可嵌入、可编排、可交付的代码工程系统

“Claude-Code -setup 实战：把 Claude Code 从聊天工具变成工程系统”——这个标题里藏着一个被绝大多数人忽略的关键转折：setup 不是安装，而是系统化落地的起点。我第一次在客户现场看到工程师对着 Claude 的聊天界面反复粘贴、手动改路径、再复制回 IDE 时，就意识到问题不在模型能力，而在交付形态。它本质上是一个未完成的“半成品工具链”，而 setup 就是把它从“能用”推向“可用、好用、可集成”的临界点。

核心关键词claude-code指向 Anthropic 官方发布的 CLI 工具包（@anthropic-ai/claude-code），它不是网页版的简单命令行封装，而是基于 Rust 编写的原生二进制（native binary），具备低延迟、高吞吐、可离线调用等工程级特性；setup在这里绝非npm install -g那么简单，它涵盖环境沙箱构建、权限策略配置、插件依赖注入、技能（skills）注册中心初始化、CLI 全局行为定制等一整套系统初始化流程；CLI是它的交互入口，但更是整个系统的能力出口——你可以把它嵌入 CI 流水线、挂载为 Git Hook、集成进 VS Code 插件、甚至作为微服务的底层推理引擎；plugin和skills则是它的扩展心脏：plugin 负责对接外部系统（如数据库驱动、Git API、CI 平台 SDK），skills 则是面向具体开发任务的原子能力封装（比如“自动生成单元测试覆盖率报告”、“一键修复 ESLint 错误并提交 PR”、“根据 Jira ticket 自动创建分支并生成 stub 代码”）。这已经完全跳出了“AI 辅助编程”的初级认知，进入“AI 原生开发工作流”的新阶段。

适合谁来读？如果你是团队技术负责人，正为 AI 工具无法纳入现有 DevOps 流程而头疼；如果你是资深前端/后端工程师，厌倦了在多个窗口间复制粘贴、手动校验输出；如果你是内部工具平台开发者，需要为团队提供统一、可控、可审计的 AI 编程能力；或者你只是个想真正掌控 AI 工具、而不是被它牵着鼻子走的独立开发者——这篇文章就是为你写的。它不讲大道理，只拆解真实场景下每一个setup命令背后发生了什么、为什么必须这么设、不这么设会掉进哪些坑。接下来的内容，全部来自我在三个不同规模项目中落地claude-codeCLI 的实操记录，包括一次因non-admin sandbox权限问题导致整条 CI 流水线卡住 7 小时的复盘，以及如何让superpower skills在无外网、无 Docker 的生产服务器上稳定运行的完整方案。

2. 系统设计与思路拆解：为什么必须放弃“直接 npm install”思维

2.1 从“玩具 CLI”到“工程系统”的本质跃迁

很多人看到npm install -g @anthropic-ai/claude-code就以为 setup 完成了，结果运行claude code --help时弹出claude native binary not installed，或者执行claude skill run test直接报错failed to launch plugin: failed to install dependencies。这不是安装失败，而是对claude-code架构的严重误判。它的设计哲学非常清晰：CLI 是壳，Rust Native Binary 是核，Plugin/Skills 是肢，Sandbox 是笼。四者缺一不可，且存在严格的启动依赖顺序。

• Rust Native Binary：这是性能和安全的基石。所有重计算（如代码理解、上下文压缩、token 预估）都在本地 Rust 进程中完成，避免 Node.js 层的 GC 延迟和内存抖动。它被编译为平台特定的二进制（Windows.exe，macOS.dylib，Linux.so），不依赖全局 Node.js 版本，也不受nvm或fnm切换影响。这也是为什么npm install只是下载 JS 包管理器和脚本，真正的“大脑”需要单独下载并验证签名。

• Sandbox（沙箱）：这是工程化的第一道防火墙。claude-code默认拒绝以管理员权限运行，强制启用一个受限的、隔离的执行环境。这个沙箱控制着三件事：文件系统访问范围（默认仅限当前目录及子目录）、网络请求白名单（默认禁用所有外网，除非显式配置--allow-network）、进程派生权限（禁止spawn任意 shell 命令）。它不是为了防黑客，而是为了防“自己”——防止一个写错的 skill 脚本删掉整个node_modules或~/.ssh。couldn't set up non-admin sandbox retry setup to continue这个错误，90% 的情况是因为用户试图在 Windows 上以普通用户身份运行需要写入C:\Program Files的旧式安装包，而claude-code的沙箱明确要求将 runtime 目录放在用户空间（如%USERPROFILE%\AppData\Local\ClaudeCode\runtime）。

• Plugin（插件）：这是连接现实世界的脐带。claude-code自身不内置任何数据库操作、Git 交互或云服务调用能力。所有这些都通过 plugin 实现。每个 plugin 是一个独立的、可版本化的 Node.js 包（如@claude-code/plugin-git），它暴露一组标准化的 RPC 接口（JSON-RPC over stdio），由 CLI 主进程调用。failed to install dependencies: failed to install d这类错误，根源在于 plugin 的package.json中声明的 peerDependencies（如gitCLI 工具、mysql-client、aws-cli）未在宿主机上预装，而非 plugin 本身安装失败。

• Skills（技能）：这是面向开发者的“应用层”。一个 skill 是一个 YAML + JavaScript 的组合体，定义了触发条件（when）、输入参数（input）、调用的 plugin 链（steps）和输出格式（output）。superpower skills并非官方术语，而是社区对一类高阶 skill 的统称：它们不直接生成代码，而是协调多个 plugin 完成端到端任务。例如pr-reviewerskill 会调用gitplugin 获取 diff，调用githubplugin 获取 PR 信息，调用claude自身 API 进行代码审查，最后调用githubplugin 发布评论。它的 setup 不是npm install，而是claude skill install https://github.com/org/superpower-skills.git，这会将远程仓库克隆到本地~/.claude/skills/并解析其manifest.yml。

放弃“npm install 万能论”，转而接受“四层架构”思维，是成功 setup 的前提。下面的每一步，都是在为这四层打地基。

2.2 为什么选择 Inno Setup 而非 NSIS 或 Setup Factory？

当项目需要将claude-code打包为团队分发的桌面客户端时，选型至关重要。网络热词中频繁出现的inno setup、setup factory、vb.net building setup exe file，指向同一个需求：一个轻量、可靠、可静默部署、且能精确控制沙箱路径的安装器。

我们对比了三种主流方案：

• NSIS（Nullsoft Scriptable Install System）：脚本强大，但学习曲线陡峭，对 Windows UAC（用户账户控制）权限提升的处理不够优雅，容易在非管理员环境下静默失败，且其沙箱路径硬编码逻辑复杂，难以与claude-code的--runtime-dir参数无缝集成。
• Setup Factory：商业软件，UI 美观，但生成的安装包体积庞大（常超 50MB），且其沙箱初始化逻辑是黑盒，无法注入自定义的pre-installhook（比如自动检测并安装gitCLI）。
• Inno Setup：开源免费，生成的安装包极小（通常 < 5MB），其 Pascal Script 引擎允许我们在InitializeSetup()阶段就执行任意逻辑。最关键的是，我们可以用它精准控制claude-code的沙箱根目录。例如，在setup.iss中写：

  [Code] function InitializeSetup(): Boolean; begin // 创建专属沙箱目录 CreateDir(ExpandConstant('{userappdata}\ClaudeCode\runtime')); // 写入配置文件，强制 CLI 使用此路径 SaveStringToFile(ExpandConstant('{userappdata}\ClaudeCode\config.json'), '{"runtime_dir": "' + ExpandConstant('{userappdata}\ClaudeCode\runtime') + '"}', False); Result := True; end;

  这样，无论用户是否管理员，安装后首次运行claude code，它都会读取该配置，将沙箱锁定在用户空间，彻底规避non-admin sandbox报错。而quartus的generate s imulator setup scr或vb.net building setup exe file这类传统安装脚本，缺乏这种细粒度的运行时环境干预能力。

2.3 CLI 与 Skills 的耦合设计：为什么不能“先装 CLI 后装 Skills”

一个常见的误区是：先全局安装claude-codeCLI，再单独npm install各种 skills。这会导致严重的版本错配和依赖冲突。claude-code的设计是“CLI 与 Skills 共享同一套 runtime 环境”。它的skills目录（默认~/.claude/skills/）不是一个简单的 JS 文件集合，而是一个由 CLI 管理的、带有版本锁（skills.lock）的模块仓库。

当你执行claude skill install <url>时，CLI 会：

1. 克隆远程仓库到~/.claude/skills/<name>@<commit-hash>/
2. 解析其package.json，检查engines.claude-code字段（如"^1.2.0"）
3. 如果本地 CLI 版本不满足，会提示Incompatible CLI version并拒绝安装
4. 如果满足，则读取manifest.yml，将其dependencies（如@claude-code/plugin-git@^0.8.0）写入skills.lock
5. 最后，CLI 启动时会根据skills.lock动态加载对应版本的 plugin，确保 skill A 调用的plugin-git@0.8.0与 skill B 调用的plugin-git@0.7.5互不干扰（通过 Node.js 的require.resolve路径隔离实现）

因此，“setup” 的正确顺序是：先确定 CLI 版本 → 再初始化 skills 目录 → 最后批量安装 skills。任何跳过claude skill init的操作，都会让 skills 失去版本管理和依赖隔离能力，最终在codex cli或cursor skills场景下出现plugin 'mysql_native_password' is not loaded这类看似随机的插件加载失败。

3. 核心细节解析与实操要点：绕开那些“文档没写”的深坑

3.1 Rust Native Binary 的下载、校验与路径绑定

npm install -g @anthropic-ai/claude-code只是第一步，它会在node_modules/@anthropic-ai/claude-code/bin/下放置一个claude脚本，这个脚本的核心逻辑是：查找并执行同名的 Rust 二进制文件。如果找不到，就报claude native binary not installed。这个二进制文件不会随 npm 包一起下载，必须手动获取。

正确做法（以 macOS 为例）：

# 1. 创建存放二进制的目录（必须与 CLI 预期路径一致） mkdir -p ~/.claude/bin # 2. 从官方 GitHub Releases 下载对应平台的二进制（注意版本号要匹配 CLI） # CLI 版本可通过 `npm list -g @anthropic-ai/claude-code` 查看，假设为 1.3.0 curl -L https://github.com/anthropic/claude-code/releases/download/v1.3.0/claude-macos-arm64 \ -o ~/.claude/bin/claude # 3. 赋予可执行权限 chmod +x ~/.claude/bin/claude # 4. 关键一步：告诉 CLI 去哪里找它！ # 创建符号链接，覆盖 npm 安装的脚本 rm /usr/local/bin/claude ln -s ~/.claude/bin/claude /usr/local/bin/claude

提示：Windows 用户请下载claude-windows-x64.exe，并将其重命名为claude.exe，放入C:\Users\<user>\AppData\Local\ClaudeCode\bin\，然后在系统环境变量PATH中添加该路径。切勿双击运行.exe，必须通过 CLI 调用。

为什么必须手动下载？因为claude-code的 Rust 二进制是经过严格签名的，npm 包无法包含它（违反 npm 安全策略）。自动下载脚本（如某些第三方codex setup 安装示例）往往使用未经验证的镜像源，存在供应链攻击风险。手动下载并校验 SHA256 是唯一安全方式：

# 下载官方提供的 checksums.txt curl -L https://github.com/anthropic/claude-code/releases/download/v1.3.0/checksums.txt \ -o checksums.txt # 校验 shasum -a 256 ~/.claude/bin/claude | grep $(cat checksums.txt | grep "claude-macos-arm64" | awk '{print $1}')

3.2 Sandbox 沙箱的深度配置：从--allow-network到--file-access-level

沙箱不是开关，而是一组精细的旋钮。claude-code提供了-S, --sandbox主开关，但真正决定其行为的是以下三个关键参数：

• --file-access-level <level>：控制文件系统访问粒度。none（默认）禁止所有文件读写；current-dir允许读写当前工作目录及子目录；full允许读写任意路径（极度危险，仅用于调试）。vue3 组合式api <script setup>教程中提到的“必须在 setup 函数顶部调用”，与此类似——claude-code的--file-access-level也必须在 CLI 命令最开头指定，否则会被后续参数覆盖。

• --allow-network <host:port>：网络白名单。可以多次使用，如--allow-network github.com:443 --allow-network api.anthropic.com:443。error 2059 (hy000): authentication plugin 'caching_sha2_password' cannot be这类 MySQL 错误，往往是因为 skill 尝试连接本地127.0.0.1:3306，但未在--allow-network中声明，导致连接被沙箱拦截。

• --runtime-dir <path>：沙箱的“家”。这是 setup 的核心。必须是一个绝对路径，且该路径的父目录需对当前用户有写权限。ubuntu20.04上安装codex cli时常见问题bun setup 失败 zsh:command not found，根源就是bun的PATH未包含~/.bun/bin，而claude-code的--runtime-dir若指向/opt/claude，普通用户根本无权写入。

实操心得：我们在金融客户项目中，为--runtime-dir设计了一套“三级缓存”策略：

1. 一级（内存）：/dev/shm/claude-runtime（Linux），利用 tmpfs 提升 I/O 速度，但重启即失；
2. 二级（本地）：$HOME/.claude/runtime，持久化存储，作为主沙箱；
3. 三级（网络）：/mnt/nas/claude-shared，挂载为 NFS，供团队共享 skills 和 plugin 缓存。 CLI 启动时，按此顺序探测，首个存在的路径即为最终--runtime-dir。这通过一个 wrapper 脚本实现：

#!/bin/bash # /usr/local/bin/claude-safe if [ -d "/dev/shm/claude-runtime" ]; then exec claude "$@" --runtime-dir "/dev/shm/claude-runtime" elif [ -d "$HOME/.claude/runtime" ]; then exec claude "$@" --runtime-dir "$HOME/.claude/runtime" else mkdir -p "$HOME/.claude/runtime" exec claude "$@" --runtime-dir "$HOME/.claude/runtime" fi

3.3 Plugin 的安装、调试与故障隔离

Plugin 是claude-code的“手脚”，但它的安装远比npm install复杂。以@claude-code/plugin-git为例，它的package.json中声明了peerDependencies: { "git": ">=2.20.0" }。这意味着gitCLI 必须已存在于系统PATH中，且版本达标。

标准安装流程：

# 1. 全局安装 plugin（注意：是全局，不是项目本地） npm install -g @claude-code/plugin-git # 2. 验证 git 是否可用（CLI 会调用此命令） git --version # 必须输出 >=2.20.0 # 3. 告诉 claude-code 加载此 plugin claude plugin enable git # 这会在 ~/.claude/config.json 中添加 {"plugins": ["git"]}

调试技巧：当failed to launch plugin: failed to install dependencies报错时，不要盲目重装。先执行：

claude plugin debug git

它会输出 plugin 的完整加载日志，包括：

• Resolved path: /usr/local/lib/node_modules/@claude-code/plugin-git
• Peer dep check: git -> /usr/bin/git (v2.34.1) ✅
• Runtime check: node v18.17.0 matches engines.node "^16.0.0 || ^18.0.0" ✅
• Init script output: ...（plugin 自定义的初始化脚本输出）

故障隔离：如果某个 plugin 导致整个 CLI 崩溃（如this application failed to start because no qt platform plugin could be init），可临时禁用它：

claude plugin disable qt # 或者，更激进地，清空所有 plugin 配置 claude plugin reset

claude plugin reset会删除~/.claude/config.json中的plugins字段，并重置所有 plugin 的状态，是解决“插件污染”的终极手段。

3.4 Skills 的开发、测试与发布：从uniapp must be called at the top of a setup function得到的启示

Skills 的开发范式，与 Vue3 的<script setup>高度相似：所有声明式逻辑（import、defineProps、onMounted）必须位于顶层，不能包裹在函数内。claude-code的 skill 也是同理：manifest.yml中的steps是一个扁平的、顺序执行的数组，每个 step 的action（调用哪个 plugin）和input（传什么参数）必须在定义时就确定，不能在运行时动态生成。

一个典型的auto-testskill 结构如下：

# ~/.claude/skills/auto-test/manifest.yml name: auto-test description: 自动生成并运行单元测试 triggers: - on: "git commit" when: "files match **/*.js" steps: - action: "git" input: command: "diff --staged --name-only" output: "staged_files" - action: "shell" input: command: "jest --findRelatedTests {{staged_files}}" output: "test_result" - action: "github" input: pr_id: "{{context.pr_id}}" comment: "Test result: {{test_result}}"

开发与测试流程：

1. 本地开发：在~/.claude/skills/my-skill/下编写manifest.yml和可选的index.js（用于复杂逻辑）。
2. 本地测试：使用claude skill test命令，它会模拟一个最小上下文（context）并执行steps：

   claude skill test my-skill --context='{"pr_id": 123}'

3. 发布：claude skill publish会将整个目录打包为 tarball，并上传到你指定的私有 registry（如 Nexus），生成一个唯一的 URL。团队成员只需claude skill install <url>即可。

注意：uniapp must be called at the top of a setup function的教训在这里同样适用。如果你在index.js中写了if (process.env.NODE_ENV === 'dev') { ... }，那么在生产环境中，这个if块会被静态分析工具忽略，导致process.env.NODE_ENV未定义而报错。正确的做法是：所有环境判断，都应在manifest.yml的when字段中用 Jinja2 语法表达，如when: "{{ env.NODE_ENV == 'prod' }}"。

4. 实操过程与核心环节实现：一个完整的“企业级 setup”流水线

4.1 初始化：从零开始构建可复现的沙箱环境

我们以 Ubuntu 20.04 服务器为基准，构建一个供 CI 流水线使用的claude-code环境。目标：无需 root 权限，所有文件存于$HOME，可被 Jenkins Agent 以普通用户身份稳定调用。

步骤 1：准备基础依赖

# 更新系统 sudo apt update && sudo apt upgrade -y # 安装必要 CLI 工具（满足 plugin 的 peerDependencies） sudo apt install -y git curl jq unzip # 安装 Node.js 18（使用官方 .deb 包，避免 nvm 的 PATH 问题） curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # 验证 node -v # v18.17.0 npm -v # 9.6.7 git --version # git version 2.25.1

步骤 2：创建沙箱根目录并下载 Rust Binary

# 创建结构化目录 mkdir -p ~/claude/{bin,runtime,skills,config} # 下载 Rust Binary（Linux x64） curl -L https://github.com/anthropic/claude-code/releases/download/v1.3.0/claude-linux-x64 \ -o ~/claude/bin/claude chmod +x ~/claude/bin/claude # 下载并校验 checksums curl -L https://github.com/anthropic/claude-code/releases/download/v1.3.0/checksums.txt \ -o ~/claude/checksums.txt shasum -a 256 ~/claude/bin/claude | grep $(cat ~/claude/checksums.txt | grep "claude-linux-x64" | awk '{print $1}')

步骤 3：配置 CLI 全局行为创建~/claude/config.json：

{ "runtime_dir": "/home/ubuntu/claude/runtime", "file_access_level": "current-dir", "allow_network": ["github.com:443", "api.anthropic.com:443"], "plugins": ["git", "shell"] }

这个配置文件是 setup 的“宪法”，它确保了每次claude命令都以相同的安全策略运行。

步骤 4：安装并启用核心 Plugin

# 全局安装 plugin npm install -g @claude-code/plugin-git @claude-code/plugin-shell # 启用它们 claude plugin enable git shell # 验证 claude plugin list # 输出应包含： # git enabled /usr/lib/node_modules/@claude-code/plugin-git # shell enabled /usr/lib/node_modules/@claude-code/plugin-shell

步骤 5：初始化 Skills 目录并安装第一个 Skill

# 初始化 skills 仓库 claude skill init --dir ~/claude/skills # 安装一个基础 skill（如官方的 `hello-world`） claude skill install https://github.com/anthropic/claude-code-skills.git#hello-world # 验证 claude skill list # 输出应包含： # hello-world 1.0.0 https://github.com/anthropic/claude-code-skills.git#hello-world

至此，一个最小可行的claude-code工程系统已在 Ubuntu 上 setup 完成。它不依赖 root，所有路径都在$HOME，且配置文件化，可被 Ansible 或 Terraform 完全复现。

4.2 进阶：将 CLI 集成进 Git Hook，实现“提交即审查”

让claude-code真正成为工程系统，意味着它要主动介入开发流程。我们将它嵌入pre-commitHook，实现“每次git commit时，自动对修改的 JS 文件进行代码风格审查”。

步骤 1：创建pre-commitHook 脚本在项目根目录创建.git/hooks/pre-commit：

#!/bin/bash # 检查是否有 JS 文件被修改 CHANGED_JS=$(git diff --cached --name-only --diff-filter=ACM | grep '\.js$') if [ -z "$CHANGED_JS" ]; then exit 0 fi # 设置 claude-code 的环境变量 export CLAUDE_CONFIG_PATH="/home/ubuntu/claude/config.json" export CLAUDE_RUNTIME_DIR="/home/ubuntu/claude/runtime" # 调用 review skill echo "Running Claude code review on: $CHANGED_JS" claude skill run code-review --input="files=$CHANGED_JS" --quiet # 如果 review 失败（返回非0），中断 commit if [ $? -ne 0 ]; then echo "❌ Claude review failed. Please fix issues and try again." exit 1 fi

步骤 2：赋予可执行权限

chmod +x .git/hooks/pre-commit

步骤 3：创建code-reviewSkill在~/claude/skills/code-review/manifest.yml中：

name: code-review description: Review JavaScript files for common anti-patterns triggers: - on: "manual" steps: - action: "git" input: command: "diff --cached --unified=0 {{input.files}}" output: "diff_output" - action: "claude" input: prompt: | You are a senior JavaScript engineer. Review this git diff for: 1. Potential security vulnerabilities (e.g., eval(), unsafe DOM manipulation) 2. Performance anti-patterns (e.g., large array methods in loops) 3. Style guide violations (e.g., missing semicolons, inconsistent quotes) Output ONLY a JSON array of objects with keys: 'file', 'line', 'message', 'severity' (error/warning). Diff: {{diff_output}} output: "review_result" - action: "shell" input: command: | echo "{{review_result}}" | jq -r '.[] | "\(.file):\(.line) \(.severity): \(.message)"' | while IFS= read -r line; do if [[ "$line" == *"error:"* ]]; then echo "$line" >&2 exit 1 else echo "$line" fi done

现在，每次git commit，系统都会自动调用claude-code进行审查。error 2059或plugin:ecc:chrome-devtools mcp server 失败这类错误，会直接导致 commit 失败，将质量门禁前移到开发者本地，而非等待 CI 报告。

4.3 生产就绪：为superpower skills构建离线运行环境

superpower skills（如pr-merger、incident-responder）往往依赖多个 plugin 和外部 API。但在金融、政府等强监管行业，服务器是“空气隔离”的，没有外网，甚至没有 Docker。如何让它们运行？

方案：全离线 Bundle

1. 预下载所有依赖：在有网机器上，执行claude skill bundle <skill-name>。它会递归下载该 skill 及其所有依赖的 plugin、Rust binary、甚至node_modules，打包成一个.tar.gz。
2. 传输并解压：将 bundle 传到离线服务器，解压到~/claude/offline-bundles/。
3. 配置 CLI 使用 Bundle：修改~/claude/config.json：

   { "runtime_dir": "/home/ubuntu/claude/runtime", "offline_mode": true, "offline_bundle_dir": "/home/ubuntu/claude/offline-bundles" }

4. 启动：claude skill run pr-merger --offline。CLI 会自动从offline_bundle_dir中加载所有资源，不再发起任何网络请求。

这个方案成功解决了could not load plugin 'mysql_native_password'和authentication plugin 'caching_sha2_password' cannot be等因网络或驱动缺失导致的问题，让claude-code真正成为一个可交付、可审计、可离线的工程系统组件。

5. 常见问题与排查技巧实录：那些让你抓狂的 setup 错误真相

5.1 “Failed to launch plugin” 错误的 5 种根源与速查表

failed to launch plugin是 setup 阶段最高频的报错，但它背后隐藏着截然不同的原因。以下是我在三个项目中总结的速查表，按发生概率排序：

实操心得：永远不要在报错信息里找答案，而要在claude plugin debug <name>的输出里找。它会打印 plugin 的完整生命周期日志，从resolve、load、init到execute，每一行都是线索。

5.2 “Couldn’t set up non-admin sandbox” 的 3 种破解法

这个错误在 Windows 上尤为顽固，因为它触及了操作系统最底层的安全机制。以下是经过实战验证的三种破解法：

方法一：强制指定--runtime-dir（推荐）

# 在 CMD 中执行（非 PowerShell） claude code --runtime-dir "%USERPROFILE%\AppData\Local\ClaudeCode\runtime" --file-access-level current-dir

%USERPROFILE%是普通用户可写的，AppData\Local是 Windows 应用的标准数据目录，完美规避 UAC。

方法二：使用runas以当前用户身份重启（适用于组策略限制）

# 创建一个 bat 文件 echo claude code --runtime-dir "%USERPROFILE%\AppData\Local\ClaudeCode\runtime" > setup.bat # 右键 setup.bat -> “以其他用户身份运行” -> 输入当前用户名和密码

这会绕过某些组策略对“非管理员沙箱”的硬性阻止。

方法三：修改注册表（终极手段，仅限测试环境）

Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\System] "EnableLUA"=dword:00000000

将EnableLUA（用户账户控制）设为 0，彻底关闭 UAC。警告：此操作极大降低系统安全性，生产环境严禁使用。

5.3 “This application failed to start because no qt platform plugin could be init” 的 Qt 插件迷思

这个错误看似与claude-code无关，但它经常出现在@claude-code/plugin-qt或某些 GUI-based skills 中。根源在于：Qt 应用需要一个platforms插件（如libqxcb.so）来渲染 UI，而claude-code的沙箱默认禁用了对/usr/lib/x86_64-linux-gnu/qt5/plugins/platforms/的访问。

解决方案：

1. 找出缺失的插件：

   ldd ~/.claude/bin/claude | grep "not found" # 如果输出包含 libq