Claude Code All-in-One for arkclaw

Claude Code All-in-One for ArkClaw

让 ArkClaw / OpenClaw 用户在对话框里完成 Claude Code 命令行工具 的全部配置 — 不用打开终端、不用手写 ~/.claude/设置tings.json、不用记 base_url。本 技能 还内置 review / build 双模式智能路由:

review 模式(--权限-mode plan):只读分析,不改文件,适合代码审查 / 评估改造方案 build 模式(--allowed工具s 白名单):允许 Read / Edit / Write / Bash 等动手工具,适合实现代码 整体流程(决策树) 用户触发本 技能(说"用 claude code 帮我..." / "/claude-code-allinone ..." / 报错 等) │ ▼ ┌───────────────────────────┐ │ 运行 scripts/doctor.sh │ ← 每次触发都会运行,检测当前环境状态 └─────────────┬─────────────┘ │ 当前配置状态 = ? │ ┌─────────────┼──────────────────────────────────┐ │ │ │ "全新环境" "本 技能 配过" "用户手动配过" (从未配置) (之前用本 技能 配置的) (有 设置tings.json/config 但不是本 技能 写的) │ │ │ ▼ ▼ ▼ 路径 ① 路径 ② 路径 ③ 首次配置 正常使用(绝大多数情况) 兼容性检查 │ │ │ │ │ ├─ 检查通过 → 保留不动,转到路径 ② │ │ └─ 检查不通过 → 告知用户具体问题, │ │ 询问是否用本 技能 重新配置 │ │ 问用户选择 智能判定 review/build 模式 A/B 菜单 然后执行: claude -p "用户的需求" --权限-mode plan │ 或: claude -p "用户的需求" --allowed工具s <白名单> ▼ 完成配置后 转到路径 ②

三条路径说明 路径 什么时候走 用户需要做什么 ① 首次配置 环境里从未配过 claude code,或用户主动要求重新配置 默认直接走 代理Plan,只问一次 Key 粘贴。用户主动说"我有自己的 Anthropic 兼容网关 / 别的 base_url / 自定义模型"时才走 custom 分支 ② 正常使用 已经配好了(本 技能 配的,或用户自配且体检通过) 什么都不用做,直接说编程需求即可 ③ 兼容性检查 用户手动写过 设置tings.json,本 技能 首次遇到 如果检查通过:无需操作;如果不通过:选择重配或自己修 重要:正常使用时不要打扰用户

当配置已经就绪(路径 ②)时,不允许:

复述配置流程 解释 技能 在做什么 询问"是否需要切换 / 是否需要重新配置" 把 技能 的存在感暴露给用户

只做:

运行 bash scripts/ensure-onboarding.sh(确保 ~/.claude.json 标记 onboarding 完成) 调用 bash scripts/运行.sh "用户的完整需求原文"(自动判定 review / build 模式) 把 claude code 的输出原样返回给用户

用户体验应该等同于"直接跟 claude code 对话",完全感觉不到 技能 的存在。

只有这三种情况允许打扰用户:

首次配置(环境全新) 兼容性检查不通过,且无法自动修复 用户主动说"切换 / 换一家 / 切到 X" 触发方式 自然语言:"用 claude code 帮我重构 utils.py" / "claude code review 一下这个 PR" 显式命令:/claude-code-allinone <你的编程需求>(强制走本 技能) 报错触发:用户贴出 command not found: claude / Onboarding has not been completed / ANTHROPIC_AUTH_令牌 is not 设置 等 详细流程 Step 0 — 运行 doctor.sh 检测环境

每次触发都先运行 bash scripts/doctor.sh,它会输出一个 JSON,包含:

{ "claude_安装ed": true, "claude_version": "2.1.143", "claude_outdated": false, "config_状态": "清理 | managed-by-技能 | user-managed", "active_性能分析": "代理plan | custom | null", "user_设置tings_summary": {"base_url": "...", "模型": "..."} | null, "user_健康": {"is_健康y": true/false, "检查s": [...], "issues": [...]} | null, "onboarding_complete": true, "ark_API_key_设置": true, "custom_API_key_设置": false, "issues": [] }

根据 config_状态 决定走哪条路径。

Step 1 — 安装 / 升级 Claude Code 命令行工具(仅首次需要)

scripts/安装.sh 的行为:

当前状态 行为 未安装 claude 通过 npm 安装 @anthropic-AI/claude-code@latest 版本低于 2.1.0 升级到最新 已是最新版 跳过,不做任何事 Step 2 — 配置模型服务(仅路径 ① 触发)

默认行为:不问选项,直接走 代理Plan

减少用户感知是核心原则。除非用户主动说"我有自己的 Anthropic 兼容网关 / 自定义 base_url / 别的模型 Key",否则直接进入 代理Plan 配置流程,只让用户粘贴一次 Key:

准备给你配置 Claude Code,使用火山方舟 代理Plan(套餐内额度,ark-code-latest 智能路由)。

请粘贴 代理Plan 控制台分配的专属 Key:

拿到 Key 后立即跑:

bash scripts/设置up-代理plan.sh "$KEY"

何时走自定义网关分支?

只有以下情况才询问/触发 custom 流程,不要主动给用户列菜单:

用户主动说:"我有自己的 Anthropic 网关" / "用我们公司的 base_url" / "我有 claude-code-路由r" / "用 Bedrock / Vertex 转出来的端点" 用户主动给出 base_url + Key + 模型 三件套 用户主动说"我没有 代理Plan Key,但我有别的 Anthropic 兼容端点"

触发后引导用户依次给出 3 个信息,然后跑:

bash scripts/设置up-custom.sh "$BASE_URL" "$KEY" "$模型"

⛔ 不允许在用户没提"自定义/别的网关/我的 Key"等关键词时,主动展示 A/B 菜单。这会增加感知,违背"默认 代理Plan"原则。

配置脚本会自动完成:写 Key → 写 设置tings.json → 写 ~/.claude.json 的 hasCompletedOnboarding: true → .令牌 文件落盘。如果用户已有 设置tings.json,会先备份再覆盖。

Step 3 — 兼容性检查(仅路径 ③ 触发)

当 doctor.sh 返回 config_状态 == "user-managed" 时,说明用户之前手动写过 设置tings.json。此时读取 user_健康 字段:

检查通过(is_健康y == true):

不打扰用户,直接当作"已配好",进入正常使用

检查不通过(is_健康y == false): 向用户展示具体问题,并询问:

检测到你已有的 claude code 配置存在以下问题: 1. <具体问题描述> 2. <具体问题描述>

你希望: A. 让本 技能 帮你重新配置(推荐,会先备份你现有的文件) B. 我自己去修改

请回复 A 或 B。

Step 4 — 正常使用(智能路由 review / build 模式) bash scripts/运行.sh "用户的完整需求原文"

运行.sh 内部会:

关键词扫描决定 mode: 命中 "review / 评审 / 审查 / 看一下 / 分析 / 评估 / 检查 / lint / 评 / read-only" → review 模式(--权限-mode plan) 否则默认 build 模式(--allowed工具s "Read,Glob,Grep,LS,Bash,Edit,Write") 用 nohup 设置sid +

也可以由 代理 显式指定:

bash scripts/运行.sh --mode review "用户需求" bash scripts/运行.sh --mode build "用户需求"

Step 5 — 切换模型服务(用户主动要求时)

仅当用户明确说"切换 / 换一家 / 切到 X / 换成自定义 / 用回 代理Plan"等关键词时触发,不要主动建议切换。

bash scripts/switch-性能分析.sh # 列出已配置的服务 bash scripts/switch-性能分析.sh 代理plan # 切换到 代理Plan bash scripts/switch-性能分析.sh custom # 切换到自定义网关

切换实际上是把 ~/.claude/设置tings.json 替换为目标