Claude Codeの設定共有について考える

【ORION】エンジニアLT会#7
https://orion.connpass.com/event/366310/
2025/9/11
に登壇した際の資料です

Transcript

1. Claude Codeの 設定共有について考える 【ORION】エンジニアLT会#7 https://orion.connpass.com/event/366310/ 2025/9/11
2. 自己紹介 • 福田 龍（ふくだ りゅう） ◦ Qiita：@rf_p　X：@ryu_f_web • 仕事 ◦ 株式会社カンリー ▪ Webエンジニア＆エンジニアリングオフィス • コード書きつつ、エンジニア採用や組織開発等を担当 • 最近のできごと ◦ 8月に転職し、長年住んだ名古屋から東京に引っ越してきました
3. 本日のLTテーマ Claude Codeの設定共有について考える ※今回の「設定」とは、 『カスタムスラッシュコマンド』と『サブエージェント』の定義を指す
4. 発表の目的 Claude Codeに限らず、AIツールのナレッジを チーム内でどう共有していくか、考えるきっかけとする
5. 皆さん、Claude Code使っていますか？
6. Claude Code • Anthropicが提供するエージェンティックコーディングツール • 拡張性やカスタマイズ性に優れる • 定額利用できる点も特長 ◦ Proプラン $20/月 ◦ Maxプラン $100/月 or $200/月 参考：https://support.anthropic.com/ja/articles/11145838
7. 皆さん、カスタムスラッシュコマンド使っていますか？
8. カスタムスラッシュコマンド　/　Claude Code • 独自のスラッシュコマンドを定義できる ◦ 頻繁に利用するプロンプトを定義することで効率化が図れる 参考：https://docs.anthropic.com/ja/docs/claude-code/slash-commands
9. 皆さん、サブエージェントは使っていますか？
10. サブエージェント　/　Claude Code • 専門のエージェントを定義できる ◦ メインと独立したコンテキスト、並列処理、専門特化 参考：https://docs.anthropic.com/ja/docs/claude-code/sub-agents
11. 配置による設定の違い　/　Claude Code • プロジェクトに配置　.claude/commands/, .claude/agents/ ◦ 適用範囲：プロジェクト ◦ 共有：git等で簡単にチーム共有可 • ホームディレクトリに配置　　~/.claude/commands/, ~/.claude/agents/ ◦ 適用範囲：個人、プロジェクト横断 ◦ 共有：基本的にチーム共有されない 参考：https://docs.anthropic.com/ja/docs/claude-code/slash-commands
12. 配置による設定の違い　/　Claude Code • プロジェクトに配置　.claude/commands/, .claude/agents/ ◦ 適用範囲：プロジェクト ◦ 共有：git等で簡単にチーム共有可 • ホームディレクトリに配置　　~/.claude/commands/, ~/.claude/agents/ ◦ 適用範囲：個人、プロジェクト横断 ◦ 共有：基本的にチーム共有されない 参考：https://docs.anthropic.com/ja/docs/claude-code/slash-commands 簡単に共有できる反面、 各自の創意工夫が生まれにくい 　⇒ベストプラクティス模索中の 　　状況下では、もったいない
13. 配置による設定の違い　/　Claude Code • プロジェクトに配置　.claude/commands/, .claude/agents/ ◦ 適用範囲：プロジェクト ◦ 共有：git等で簡単にチーム共有可 • ホームディレクトリに配置　　~/.claude/commands/, ~/.claude/agents/ ◦ 適用範囲：個人、プロジェクト横断 ◦ 共有：基本的にチーム共有されない 参考：https://docs.anthropic.com/ja/docs/claude-code/slash-commands 自由に試行錯誤して ブラッシュアップしやすい反面、 ナレッジがチームに蓄積されづらい 　⇒品質・生産性に差が生まれる
14. SuperClaudeを利用した場合　/　Claude Code • SuperClaude ◦ コマンド、エージェント、 MCP等がパッケージされた Claude Codeのフレームワーク ◦ 導入してしまえば、用意されたコマンドを使ってレールに乗ったチーム開発が可能 • 現時点での所感 ◦ メリット ▪ 導入が楽で、便利 ▪ 汎用的で、質の高いアウトプットが期待できる ◦ デメリット ▪ やや機能が過剰 ▪ Claude Codeのユーザー設定がごちゃごちゃする ▪ ⇒プロジェクト固有の設定に不向き ◦ よって、今回はSuperClaudeを使わないで解決策を探る ▪ コマンド、エージェント、 MCP等の参考に留める
15. 解決策
16. 設定共有　/　Claude Code • /agents, /commandsディレクトリの共有用リポジトリを作る ◦ makeコマンドやshellスクリプトで、以下のようなコマンドを実装 ▪ claude-push：自身の設定をgit管理化に配置する ▪ claude-pull： 他者の設定にシンボリックリンクを張る • 各自が自身のディレクトリに push ◦ バージョン管理のメリットを享受できる • 他者の設定を閲覧したり、コマンドで一発導入 ⇒それぞれ試行錯誤しつつ、 ナレッジが蓄積・共有される
17. • 注意点 ◦ pushを先に実行してもらう必要あり ▪ 先に設定pullすると、自身の設定ファイルが消える可能性あり ◦ jsonファイルの共有は要注意 ▪ MCP設定等、credentialな情報が含まれる可能性あり 設定共有　/　Claude Code
18. まとめ
19. まとめ • Claude Codeはカスタマイズ性に優れる • 設定ファイルは配置場所によって特性が異なる ◦ プロジェクト配下＝共有しやすいが故に、各自の試行錯誤が難しい ◦ ホームディレクトリ配下＝共有しづらいが、各自の試行錯誤がしやすい • ホームディレクトリ配下の一部を共有化してみる ◦ 自身の変更がgit管理になる＝簡単に遡ったり戻せる ◦ 各自の試行錯誤が簡単に共有できる
20. 日程: 2025/10/09(木) 18:30 ~ (開場18:00~) 参加費: 無料 https://canly.connpass.com/event/365017/ お気軽にお越しください！ 当社で開催するLTの宣伝