Claude CodeのスピナーTips追加コマンドを作る

2026年3月1日 結城浩×クロコさん（Claude Code）

スピナーTipsとは

...
"spinnerTipsOverride": {
  "excludeDefault": false,
  "tips": [
    "スピナーのTipsはカスタマイズできます。クロコにお伝えください。"
  ]
},
...

コマンドの作成

エッジケースの確認

完成したスクリプト

最終的なスクリプト ~/bin/claude-add-tips の全文は次の通りです。

#!/usr/bin/env ruby
# encoding: utf-8
# claude-add-tips - ~/.claude/settings.json の spinnerTipsOverride.tips を管理する
#
# Usage:
#   claude-add-tips "ここにテキスト"
#   claude-add-tips "テキスト1" "テキスト2"   # 複数同時追加
#   claude-add-tips -l                         # 現在のtips一覧
#   claude-add-tips -d N                       # N番目を削除（1始まり）
#   claude-add-tips -h                         # ヘルプ表示

require 'json'

SETTINGS_PATH = File.expand_path('~/.claude/settings.json')

HELP = <<~HELP
  claude-add-tips - Claude Code スピナーTipsの管理

  Usage:
    claude-add-tips "テキスト"              tipsを追加
    claude-add-tips "A" "B"                複数同時追加
    claude-add-tips -l, --list             一覧表示
    claude-add-tips -d, --delete N         N番目を削除（1始まり）
    claude-add-tips -h, --help             このヘルプ

  Tips は ~/.claude/settings.json の spinnerTipsOverride.tips に保存されます。
  Claude Code 作業中にスピナー横にランダム表示されます。

  備考:
    - ~/.claude/settings.json が存在しない場合はエラー終了します。
    - spinnerTipsOverride キーが存在しない場合は自動作成されます。
    - 同じテキストの重複追加はスキップされます。
HELP

def load_settings
  unless File.exist?(SETTINGS_PATH)
    $stderr.puts "エラー: #{SETTINGS_PATH} が見つかりません"
    exit 1
  end
  JSON.parse(File.read(SETTINGS_PATH))
end

def save_settings(settings)
  File.write(SETTINGS_PATH, JSON.pretty_generate(settings) + "\n")
end

def ensure_tips_structure(settings)
  settings['spinnerTipsOverride'] ||= { 'excludeDefault' => false, 'tips' => [] }
  settings['spinnerTipsOverride']['tips'] ||= []
  settings
end

def list_tips
  settings = ensure_tips_structure(load_settings)
  tips = settings['spinnerTipsOverride']['tips']
  if tips.empty?
    puts "Tips は空です。"
  else
    tips.each_with_index do |tip, i|
      puts "  #{i + 1}. #{tip}"
    end
  end
end

def delete_tip(index)
  settings = ensure_tips_structure(load_settings)
  tips = settings['spinnerTipsOverride']['tips']
  if index < 1 || index > tips.length
    $stderr.puts "エラー: #{index} 番は範囲外です（1〜#{tips.length}）"
    exit 1
  end
  removed = tips.delete_at(index - 1)
  save_settings(settings)
  puts "削除: #{removed}"
end

def add_tips(new_tips)
  settings = ensure_tips_structure(load_settings)
  tips = settings['spinnerTipsOverride']['tips']
  new_tips.each do |tip|
    if tips.include?(tip)
      puts "スキップ（既存）: #{tip}"
    else
      tips << tip
      puts "追加: #{tip}"
    end
  end
  save_settings(settings)
end

# --- main ---
case ARGV[0]
when '-h', '--help', nil
  puts HELP
when '-l', '--list'
  list_tips
when '-d', '--delete'
  unless ARGV[1]
    $stderr.puts "エラー: 削除する番号を指定してください"
    exit 1
  end
  delete_tip(ARGV[1].to_i)
else
  add_tips(ARGV)
end

使い方まとめ

関連リンク

• Claude Code settings - Claude Code Docs

フィードバックはこちらから

• 結城浩へのフィードバック