第 02 期 | 五大平台安装实战 — Claude Code / Antigravity / Gemini CLI / Codex / OpenCode

🎯 学习目标

学完本期你将掌握：

1. 在 Claude Code、Antigravity、Gemini CLI、Codex、OpenCode 五大平台上安装 Caveman
2. 理解各平台的安装差异和自动激活原理
3. 安装后验证 Caveman 是否正常工作
4. 了解 Cursor、Windsurf 等更多扩展平台的安装方式

📖 前置条件

在开始安装之前，确认你的环境满足以下条件：

📖 核心内容：五大平台安装

2.1 Claude Code 安装 (Plugin 方式 — 推荐)

Claude Code 原生支持 Plugin 系统，这是安装 Caveman 最推荐的方式：

# 一行搞定：从市场添加 + 安装插件
claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman

安装完成后，Plugin 系统会自动为你完成以下配置：

graph TD
    A["claude plugin install"] --> B["注册 SessionStart Hook
caveman-activate.js"]
    A --> C["注册 UserPromptSubmit Hook
caveman-mode-tracker.js"]
    A --> D["注册 Statusline Script
caveman-statusline.sh"]
    A --> E["安装 5 个 Skills
caveman / commit / review / compress / help"]
    
    B --> F["✅ 每次启动自动激活"]
    C --> F
    D --> G["✅ 状态栏显示当前模式"]
    E --> H["✅ 斜杠命令可用"]

验证安装成功：

# 启动 Claude Code
claude

# 在会话中输入
> /caveman

# 你应该看到类似输出：
# 🪨 CAVEMAN MODE: FULL
# Caveman active. Technical substance preserved. Fluff eliminated.

如果你的状态栏出现了 [CAVEMAN] 徽章，说明安装成功。

Standalone 安装（不用 Plugin 系统）

如果你不想使用 Plugin 系统，可以通过脚本直接安装 Hooks：

# macOS / Linux / WSL
bash <(curl -s https://raw.githubusercontent.com/JuliusBrussee/caveman/main/hooks/install.sh)

# Windows (PowerShell)
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/hooks/install.ps1 | iex

或者从本地克隆仓库安装：

git clone https://github.com/JuliusBrussee/caveman.git
cd caveman
bash hooks/install.sh

卸载也很简单：

bash hooks/uninstall.sh

2.2 Antigravity 安装

Antigravity (Google DeepMind 的 Agentic Coding 助手) 支持通过 GEMINI.md 规则文件和 Skills 系统来集成 Caveman。

方式一：通过 npx skills 安装

npx skills add JuliusBrussee/caveman

这会在你的项目目录下安装 Caveman 的 Skill 文件。

方式二：手动配置规则文件

在你的项目根目录 GEMINI.md 中，添加以下片段即可让 Caveman 在 Antigravity 会话中始终生效：

## Caveman Mode

Terse like caveman. Technical substance exact. Only fluff die.
Drop: articles, filler (just/really/basically), pleasantries, hedging.
Fragments OK. Short synonyms. Code unchanged.
Pattern: [thing] [action] [reason]. [next step].
ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift.
Code/commits/PRs: normal.
Off: "stop caveman" / "normal mode".

方式三：项目级 .agent/skills 安装

# 在项目根目录创建 skills 目录
mkdir -p .agent/skills/caveman

# 下载 Caveman skill 文件
curl -o .agent/skills/caveman/SKILL.md \
  https://raw.githubusercontent.com/JuliusBrussee/caveman/main/skills/caveman/SKILL.md

验证：

# 在 Antigravity 会话中输入
> 请用 caveman 模式回答：React useEffect 的清理函数什么时候执行？

# 预期 Caveman 风格回答：
# cleanup run: before next effect + unmount. Return fn from useEffect = cleanup.

⚠️ 注意: Antigravity 没有 Claude Code 的 SessionStart Hook 机制，因此 Caveman 不会自动启动。你需要通过 GEMINI.md 规则文件让它 always-on，或者每次会话手动说 "caveman mode"。

2.3 Gemini CLI 安装

Gemini CLI 拥有原生的 Extensions 系统，一行安装：

# 安装
gemini extensions install https://github.com/JuliusBrussee/caveman

# 更新
gemini extensions update caveman

# 卸载
gemini extensions uninstall caveman

Gemini CLI 通过 GEMINI.md 上下文文件自动激活 Caveman。安装后还附带了自定义 Gemini 命令：

# 切换强度级别
/caveman          # 切换到 full 模式
/caveman lite     # 切换到 lite 模式
/caveman ultra    # 切换到 ultra 模式
/caveman wenyan   # 切换到文言文模式

# 辅助命令
/caveman-commit   # 生成精炼 commit message
/caveman-review   # 一行式代码审查

验证：

gemini

# 在会话中
> /caveman
# 应看到 Caveman 激活确认

> 什么是 TypeScript 的 discriminated union？
# 预期 Caveman 风格回答：
# Tagged union. Common prop (kind/type) + switch narrow type. 
# Each branch: TS knows exact shape. Pattern: type Result = 
# {ok: true, data: T} | {ok: false, error: E}

2.4 Codex (OpenAI) 安装

OpenAI 的 Codex 编程代理支持通过 Plugin 市场和 .codex/hooks.json 来集成 Caveman。

方式一：通过 Plugin 市场安装

# macOS / Linux:
# 1. 克隆 caveman 仓库
git clone https://github.com/JuliusBrussee/caveman.git

# 2. 进入仓库目录，启动 Codex
cd caveman
codex

# 3. 在 Codex 中：/plugins → 搜索 "Caveman" → Install

方式二：通过 npx skills 安装

npx skills add JuliusBrussee/caveman -a codex

配置 SessionStart 自动激活：

Caveman 仓库自带了 .codex/hooks.json 和 .codex/config.toml，可以在 Codex 内自动激活。如果你要在其他项目中也启用 always-on，需要复制这两个文件：

// .codex/hooks.json
{
  "hooks": [
    {
      "event": "SessionStart",
      "command": "echo 'Terse like caveman. Technical substance exact. Only fluff die. Drop: articles, filler, pleasantries. Fragments OK. Code unchanged. Pattern: [thing] [action] [reason]. [next step]. ACTIVE EVERY RESPONSE.'"
    }
  ]
}

# .codex/config.toml
[features]
codex_hooks = true

⚠️ Codex 特殊语法：Codex 使用 $caveman 触发（$ 前缀），而非 /caveman。/ 在 Codex 中保留给内置命令。

⚠️ Windows 注意：Codex hooks 目前在 Windows 上被禁用，需要手动使用 $caveman 启动。

验证：

codex

# 在会话中输入
> $caveman

# 应看到 Caveman 激活确认
> 解释什么是 Kubernetes Pod
# 预期 Caveman 回答：
# Pod = smallest deployable unit in K8s. Wraps 1+ containers,
# shared network + storage. Ephemeral — dies, gets replaced.

2.5 OpenCode 安装

OpenCode 是一个开源终端 AI 编码工具，通过 AGENTS.md 规则文件集成 Caveman。

方式一：通过 npx skills 安装

npx skills add JuliusBrussee/caveman
# Skill 文件会安装到项目目录

方式二：手动配置 AGENTS.md 规则文件 (推荐)

在项目根目录创建或编辑 .config/opencode/AGENTS.md：

## Caveman Mode (Always-On)

Terse like caveman. Technical substance exact. Only fluff die.
Drop: articles, filler (just/really/basically), pleasantries, hedging.
Fragments OK. Short synonyms. Code unchanged.
Pattern: [thing] [action] [reason]. [next step].
ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift.
Code/commits/PRs: normal.
Off: "stop caveman" / "normal mode".

验证：

opencode

# 在会话中输入
> caveman mode

# 应看到回答风格变为精简
> 解释 Go 的 goroutine
# 预期 Caveman 回答：
# Lightweight thread managed by Go runtime. `go func()` spawns.
# Cheap — thousands OK. Communicate via channels, not shared mem.

💡 注意：OpenCode 没有斜杠命令系统，始终使用自然语言触发 Caveman（如 "caveman mode" / "talk like caveman"）。Always-On 必须通过 AGENTS.md 规则文件实现。

📊 五大平台安装对比总表

graph TB
    subgraph CC["Claude Code"]
        CC1["Plugin 安装
claude plugin install"] --> CC2["✅ SessionStart Hook 自动激活"]
        CC2 --> CC3["✅ 状态栏徽章"]
        CC3 --> CC4["✅ /caveman 斜杠命令"]
    end
    
    subgraph AG["Antigravity"]
        AG1["npx skills add
或 GEMINI.md 规则"] --> AG2["⚠️ 需 GEMINI.md always-on"]
        AG2 --> AG3["❌ 无状态栏徽章"]
        AG3 --> AG4["✅ 自然语言触发"]
    end
    
    subgraph GC["Gemini CLI"]
        GC1["gemini extensions install"] --> GC2["✅ GEMINI.md 自动激活"]
        GC2 --> GC3["❌ 无状态栏徽章"]
        GC3 --> GC4["✅ /caveman 斜杠命令"]
    end
    
    subgraph CX["Codex"]
        CX1["Plugin 市场
或 npx skills"] --> CX2["⚠️ 需 hooks.json 配置"]
        CX2 --> CX3["❌ 无状态栏徽章"]
        CX3 --> CX4["✅ $caveman 命令"]
    end
    
    subgraph OC["OpenCode"]
        OC1["AGENTS.md 规则
手动配置"] --> OC2["⚠️ 需 AGENTS.md always-on"]
        OC2 --> OC3["❌ 无状态栏徽章"]
        OC3 --> OC4["✅ 自然语言触发"]
    end

📖 更多 Agent 扩展安装速查

除了五大平台之外，Caveman 通过 npx skills 还支持 40+ 个 Agent：

# Cursor
npx skills add JuliusBrussee/caveman -a cursor
# → 安装到 .cursor/rules/caveman.mdc

# Windsurf
npx skills add JuliusBrussee/caveman -a windsurf
# → 安装到 .windsurf/rules/caveman.md

# Cline
npx skills add JuliusBrussee/caveman -a cline
# → 安装到 .clinerules/caveman.md

# GitHub Copilot
npx skills add JuliusBrussee/caveman -a github-copilot
# → 安装到 .github/copilot-instructions.md + AGENTS.md

# AMP / Augment / Goose / Kiro / Roo 等
npx skills add JuliusBrussee/caveman -a <agent-name>

# 卸载
npx skills remove caveman

⚠️ 重要提示: npx skills add 只安装 Skill 文件，不会安装 Hook 或规则文件。因此 Caveman 不会自动启动。你需要每次说 /caveman 或 "caveman mode" 来手动激活，或者将 always-on 片段粘贴到对应的规则文件中。

⚠️ Windows 注意: npx skills 默认使用符号链接。如果符号链接失败，加 --copy 参数：npx skills add JuliusBrussee/caveman --copy

📝 本期要点回顾

1. Claude Code 安装最完善：Plugin 系统 + Hook 自动激活 + 状态栏徽章，一条命令搞定
2. Antigravity 需要手动配置 GEMINI.md 规则文件实现 always-on，无原生 Hook 支持
3. Gemini CLI 拥有原生 Extensions 支持，通过 GEMINI.md 上下文自动激活
4. Codex 通过 Plugin 市场 + .codex/hooks.json 配置，使用 $caveman 触发（注意 $ 前缀）
5. OpenCode 通过 .config/opencode/AGENTS.md 规则文件配置，使用自然语言触发
6. 所有平台都支持 "stop caveman" 停用和 "caveman mode" 重新启用

🔗 参考资料

• Caveman 安装文档
• npx skills 工具
• Caveman Hooks README
• Claude Code Plugin 文档
• Codex Hooks 配置
• OpenCode 文档