syui/claude

Fork 0

Files

syui 9758126225

add

2025-07-05 13:48:50 +09:00

3.5 KiB

Raw Permalink Blame History

Claude Code カスタムヘルプ機能のセットアップ

概要

Claude Codeの標準ヘルプを拡張し、ショートカットキー、公式ドキュメントへのリンク、便利なTipsを統合したカスタムヘルプシステムです。

インストール

1. zshrcへの追加

.zshrcに以下を追加：

# Claude Code ヘルパー関数の読み込み
source "$HOME/git/claude/scripts/claude-zsh-functions.sh"

または、直接関数を.zshrcに追加：

# Claude Code拡張ヘルプ
function claude-help() {
    bash "$HOME/git/claude/scripts/claude-help.sh" "$@"
}

# エイリアス
alias ch='claude-help'
alias cr='claude-readme'

2. スクリプトの配置

# スクリプトディレクトリの作成
mkdir -p ~/git/claude/scripts

# 実行権限の付与
chmod +x ~/git/claude/scripts/claude-help.sh
chmod +x ~/git/claude/scripts/claude-zsh-functions.sh

使用方法

基本コマンド

# 全体のヘルプを表示
claude-help

# カテゴリ別ヘルプ
claude-help shortcuts   # ショートカットキー詳細
claude-help options     # 起動オプション詳細
claude-help docs        # 公式ドキュメントリンク

# エイリアス使用
ch          # claude-helpの短縮形
cr          # クイックリファレンス表示
cs          # 安全モードでClaude Code起動

利用可能な関数

関数名	説明	使用例
`claude-help`	拡張ヘルプを表示	`claude-help [カテゴリ]`
`claude-readme`	クイックリファレンス	`claude-readme`
`claude-safe`	安全チェック付き起動	`claude-safe`
`claude-session`	セッション管理	`claude-session list`
`claude-edit-config`	CLAUDE.md編集	`claude-edit-config`
`claude-docs`	公式ドキュメントを開く	`claude-docs settings`

Claude Code内でのカスタムコマンド化

方法1: エイリアスとして設定

~/.claude/settings.jsonに追加：

{
  "aliases": {
    "help+": "!bash ~/git/claude/scripts/claude-help.sh",
    "shortcuts": "!bash ~/git/claude/scripts/claude-help.sh shortcuts"
  }
}

方法2: スラッシュコマンドとして実装

Claude Code内で以下のように使用：

/help+

※ 現在のClaude Codeではカスタムスラッシュコマンドの追加は制限されている可能性があります。

カスタマイズ

ヘルプ内容の編集

scripts/claude-help.shを編集して、独自の内容を追加：

show_category "🔧 カスタムセクション"
cat << 'EOF'
独自の内容をここに追加
EOF

新しいカテゴリの追加

case "$1" in
    "custom"|"c")
        show_category "カスタムカテゴリ"
        # 内容を追加
        ;;
esac

トラブルシューティング

スクリプトが見つからない

パスを確認：

which claude-help
echo $HOME/git/claude/scripts/claude-help.sh

実行権限エラー

chmod +x ~/git/claude/scripts/*.sh

zsh関数が読み込まれない

# .zshrcを再読み込み
source ~/.zshrc

今後の拡張案

インタラクティブメニュー
- fzfを使った選択式ヘルプ
- カテゴリの動的選択
オンラインヘルプの統合
- 最新のドキュメントを自動取得
- コミュニティTipsの表示
パーソナライズ
- 使用頻度に基づくヘルプの最適化
- ユーザー独自のTips追加機能

3.5 KiB Raw Permalink Blame History Unescape Escape