OMC Setup：oh-my-claudecode 一键配置工具，自动化 Claude Code 开发环境设置

omc-setup by yeachan-heo/oh-my-claudecode

152 周安装量

11,200 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill omc-setup

开发自动化命令行工具

🇨🇳中文介绍

OMC 设置

这是你唯一需要学习的命令。运行此命令后，其他所有操作都将自动进行。

当此技能被调用时，立即执行以下工作流程。不要仅仅向用户复述或总结这些说明。

注意：本指南中所有 ~/.claude/... 路径在设置了 CLAUDE_CONFIG_DIR 环境变量时，会遵循该变量。

标志解析

检查用户调用中的标志：

--help → 显示帮助文本（见下文）并停止
--local → 仅执行阶段 1（目标=本地），然后停止
--global → 仅执行阶段 1（目标=全局），然后停止
--force → 跳过预设置检查，运行完整设置（阶段 1 → 2 → 3 → 4）
无标志 → 运行预设置检查，然后根据需要运行完整设置

帮助文本

当用户使用 --help 运行时，显示此内容并停止：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

855,400 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

281,000 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

226,800 周安装

OMC 设置 - 配置 oh-my-claudecode

用法：
  /oh-my-claudecode:omc-setup           运行初始设置向导（如果已配置则更新）
  /oh-my-claudecode:omc-setup --local   配置本地项目 (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  配置全局设置 (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   强制运行完整设置向导，即使已配置
  /oh-my-claudecode:omc-setup --help    显示此帮助

模式：
  初始设置（无标志）
    - 首次设置的交互式向导
    - 配置 CLAUDE.md（本地或全局）
    - 设置 HUD 状态行
    - 检查更新
    - 提供 MCP 服务器配置
    - 配置团队模式默认值（代理数量、类型、模型）
    - 如果已配置，提供快速更新选项

  本地配置 (--local)
    - 下载新的 CLAUDE.md 到 ./.claude/
    - 备份现有的 CLAUDE.md 到 .claude/CLAUDE.md.backup.YYYY-MM-DD
    - 项目特定设置
    - 在 OMC 升级后使用此选项更新项目配置

  全局配置 (--global)
    - 下载新的 CLAUDE.md 到 ~/.claude/
    - 备份现有的 CLAUDE.md 到 ~/.claude/CLAUDE.md.backup.YYYY-MM-DD
    - 适用于所有 Claude Code 会话
    - 清理遗留的钩子
    - 在 OMC 升级后使用此选项更新全局配置

  强制完整设置 (--force)
    - 绕过“已配置”检查
    - 从头开始运行完整的设置向导
    - 当你想重新配置偏好时使用

示例：
  /oh-my-claudecode:omc-setup           # 首次设置（或如果已配置则更新 CLAUDE.md）
  /oh-my-claudecode:omc-setup --local   # 更新此项目
  /oh-my-claudecode:omc-setup --global  # 更新所有项目
  /oh-my-claudecode:omc-setup --force   # 重新运行完整设置向导

更多信息：https://github.com/Yeachan-Heo/oh-my-claudecode

# 检查设置是否已完成
CONFIG_FILE="$HOME/.claude/.omc-config.json"

if [ -f "$CONFIG_FILE" ]; then
  SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null)
  SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null)

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "OMC 设置已于以下时间完成：$SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "设置版本：$SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

阶段 1 - 安装 CLAUDE.md：读取 ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/01-install-claude-md.md 并遵循其说明。
阶段 2 - 环境配置：读取 ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/02-configure.md 并遵循其说明。阶段 2 必须将 HUD/statusLine 设置委托给 hud 技能；不要在此处内联生成或修补 statusLine 路径。
阶段 3 - 集成设置：读取 ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/03-integrations.md 并遵循其说明。
阶段 4 - 完成：读取 ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/04-welcome.md 并遵循其说明。

🇺🇸English

OMC Setup

This is the only command you need to learn. After running this, everything else is automatic.

When this skill is invoked, immediately execute the workflow below. Do not only restate or summarize these instructions back to the user.

Note: All ~/.claude/... paths in this guide respect CLAUDE_CONFIG_DIR when that environment variable is set.

Flag Parsing

Check for flags in the user's invocation:

--help → Show Help Text (below) and stop
--local → Phase 1 only (target=local), then stop
--global → Phase 1 only (target=global), then stop
--force → Skip Pre-Setup Check, run full setup (Phase 1 → 2 → 3 → 4)
No flags → Run Pre-Setup Check, then full setup if needed

Help Text

When user runs with --help, display this and stop:

OMC Setup - Configure oh-my-claudecode

USAGE:
  /oh-my-claudecode:omc-setup           Run initial setup wizard (or update if already configured)
  /oh-my-claudecode:omc-setup --local   Configure local project (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  Configure global settings (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   Force full setup wizard even if already configured
  /oh-my-claudecode:omc-setup --help    Show this help

MODES:
  Initial Setup (no flags)
    - Interactive wizard for first-time setup
    - Configures CLAUDE.md (local or global)
    - Sets up HUD statusline
    - Checks for updates
    - Offers MCP server configuration
    - Configures team mode defaults (agent count, type, model)
    - If already configured, offers quick update option

  Local Configuration (--local)
    - Downloads fresh CLAUDE.md to ./.claude/
    - Backs up existing CLAUDE.md to .claude/CLAUDE.md.backup.YYYY-MM-DD
    - Project-specific settings
    - Use this to update project config after OMC upgrades

  Global Configuration (--global)
    - Downloads fresh CLAUDE.md to ~/.claude/
    - Backs up existing CLAUDE.md to ~/.claude/CLAUDE.md.backup.YYYY-MM-DD
    - Applies to all Claude Code sessions
    - Cleans up legacy hooks
    - Use this to update global config after OMC upgrades

  Force Full Setup (--force)
    - Bypasses the "already configured" check
    - Runs the complete setup wizard from scratch
    - Use when you want to reconfigure preferences

EXAMPLES:
  /oh-my-claudecode:omc-setup           # First time setup (or update CLAUDE.md if configured)
  /oh-my-claudecode:omc-setup --local   # Update this project
  /oh-my-claudecode:omc-setup --global  # Update all projects
  /oh-my-claudecode:omc-setup --force   # Re-run full setup wizard

For more info: https://github.com/Yeachan-Heo/oh-my-claudecode

Pre-Setup Check: Already Configured?

CRITICAL : Before doing anything else, check if setup has already been completed. This prevents users from having to re-run the full setup wizard after every update.

# Check if setup was already completed
CONFIG_FILE="$HOME/.claude/.omc-config.json"

if [ -f "$CONFIG_FILE" ]; then
  SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null)
  SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null)

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "OMC setup was already completed on: $SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "Setup version: $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

If Already Configured (and no --force flag)

If ALREADY_CONFIGURED is true AND the user did NOT pass --force, --local, or --global flags:

Use AskUserQuestion to prompt:

Question: "OMC is already configured. What would you like to do?"

Options:

Update CLAUDE.md only - Download latest CLAUDE.md without re-running full setup
Run full setup again - Go through the complete setup wizard
Cancel - Exit without changes

If user chooses "Update CLAUDE.md only":

Detect if local (.claude/CLAUDE.md) or global (~/.claude/CLAUDE.md) config exists
If local exists, run: bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-claude-md.sh" local
If only global exists, run: bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-claude-md.sh" global
Skip all other steps
Report success and exit

If user chooses "Run full setup again":

Continue with Resume Detection below

If user chooses "Cancel":

Exit without any changes

Force Flag Override

If user passes --force flag, skip this check and proceed directly to setup.

Resume Detection

Before starting any phase, check for existing state:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-progress.sh" resume

If state exists (output is not "fresh"), use AskUserQuestion to prompt:

Question: "Found a previous setup session. Would you like to resume or start fresh?"

Options:

Resume from step $LAST_STEP - Continue where you left off
Start fresh - Begin from the beginning (clears saved state)

If user chooses "Start fresh":

bash "${CLAUDE_PLUGIN_ROOT}/scripts/setup-progress.sh" clear

Phase Execution

For `--local` or `--global` flags:

Read the file at ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/01-install-claude-md.md and follow its instructions. (The phase file handles early exit for flag mode.)

For full setup (default or --force):

Execute phases sequentially. For each phase, read the corresponding file and follow its instructions:

Phase 1 - Install CLAUDE.md : Read ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/01-install-claude-md.md and follow its instructions.
Phase 2 - Environment Configuration : Read ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/02-configure.md and follow its instructions. Phase 2 must delegate HUD/statusLine setup to the hud skill; do not generate or patch statusLine paths inline here.
Phase 3 - Integration Setup : Read ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/03-integrations.md and follow its instructions.
Phase 4 - Completion : Read ${CLAUDE_PLUGIN_ROOT}/skills/omc-setup/phases/04-welcome.md and follow its instructions.

Graceful Interrupt Handling

IMPORTANT : This setup process saves progress after each phase via ${CLAUDE_PLUGIN_ROOT}/scripts/setup-progress.sh. If interrupted (Ctrl+C or connection loss), the setup can resume from where it left off.

Keeping Up to Date

After installing oh-my-claudecode updates (via npm or plugin update):

Automatic : Just run /oh-my-claudecode:omc-setup - it will detect you've already configured and offer a quick "Update CLAUDE.md only" option that skips the full wizard.

Manual options :

/oh-my-claudecode:omc-setup --local to update project config only
/oh-my-claudecode:omc-setup --global to update global config only
/oh-my-claudecode:omc-setup --force to re-run the full wizard (reconfigure preferences)

This ensures you have the newest features and agent configurations without the token cost of repeating the full setup.

Weekly Installs

152

Repository

yeachan-heo/oh-…audecode

GitHub Stars

11.2K

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

claude-code142

opencode141

cursor136

gemini-cli134

codex134

github-copilot124

OMC Setup：oh-my-claudecode 一键配置工具，自动化 Claude Code 开发环境设置

🇨🇳中文介绍

OMC 设置

标志解析

帮助文本

相关 Skills

预设置检查：是否已配置？

如果已配置（且没有 --force 标志）

强制标志覆盖

恢复检测

阶段执行

对于 `--local` 或 `--global` 标志：

对于完整设置（默认或 --force）：

优雅的中断处理

保持最新

🇺🇸English

OMC Setup

Flag Parsing

Help Text

Pre-Setup Check: Already Configured?

If Already Configured (and no --force flag)

Force Flag Override

Resume Detection

Phase Execution

For `--local` or `--global` flags:

For full setup (default or --force):

Graceful Interrupt Handling

Keeping Up to Date

最新 Skills

OMC Setup：oh-my-claudecode 一键配置工具，自动化 Claude Code 开发环境设置

🇨🇳中文介绍

OMC 设置

标志解析

帮助文本

相关 Skills

预设置检查：是否已配置？

如果已配置（且没有 --force 标志）

强制标志覆盖

恢复检测

阶段执行

对于 --local 或 --global 标志：

对于完整设置（默认或 --force）：

优雅的中断处理

保持最新

🇺🇸English

OMC Setup

Flag Parsing

Help Text

Pre-Setup Check: Already Configured?

If Already Configured (and no --force flag)

Force Flag Override

Resume Detection

Phase Execution

For --local or --global flags:

For full setup (default or --force):

Graceful Interrupt Handling

Keeping Up to Date

最新 Skills

对于 `--local` 或 `--global` 标志：

For `--local` or `--global` flags: