Slide 1

Slide 1 text

Claude Codeの 設定共有について考える 【ORION】エンジニアLT会#7 https://orion.connpass.com/event/366310/ 2025/9/11

Slide 2

Slide 2 text

自己紹介 ● 福田 龍(ふくだ りゅう) ○ Qiita:@rf_p X:@ryu_f_web ● 仕事 ○ 株式会社カンリー ■ Webエンジニア&エンジニアリングオフィス ● コード書きつつ、エンジニア採用や組織開発等を担当 ● 最近のできごと ○ 8月に転職し、長年住んだ名古屋から東京に引っ越してきました

Slide 3

Slide 3 text

本日のLTテーマ Claude Codeの設定共有について考える ※今回の「設定」とは、 『カスタムスラッシュコマンド』と『サブエージェント』の定義を指す

Slide 4

Slide 4 text

発表の目的 Claude Codeに限らず、AIツールのナレッジを チーム内でどう共有していくか、考えるきっかけとする

Slide 5

Slide 5 text

皆さん、Claude Code使っていますか?

Slide 6

Slide 6 text

Claude Code ● Anthropicが提供するエージェンティックコーディングツール ● 拡張性やカスタマイズ性に優れる ● 定額利用できる点も特長 ○ Proプラン $20/月 ○ Maxプラン $100/月 or $200/月 参考:https://support.anthropic.com/ja/articles/11145838

Slide 7

Slide 7 text

皆さん、カスタムスラッシュコマンド使っていますか?

Slide 8

Slide 8 text

カスタムスラッシュコマンド / Claude Code ● 独自のスラッシュコマンドを定義できる ○ 頻繁に利用するプロンプトを定義することで効率化が図れる 参考:https://docs.anthropic.com/ja/docs/claude-code/slash-commands

Slide 9

Slide 9 text

皆さん、サブエージェントは使っていますか?

Slide 10

Slide 10 text

サブエージェント / Claude Code ● 専門のエージェントを定義できる ○ メインと独立したコンテキスト、並列処理、専門特化 参考:https://docs.anthropic.com/ja/docs/claude-code/sub-agents

Slide 11

Slide 11 text

配置による設定の違い / Claude Code ● プロジェクトに配置 .claude/commands/, .claude/agents/ ○ 適用範囲:プロジェクト ○ 共有:git等で簡単にチーム共有可 ● ホームディレクトリに配置  ~/.claude/commands/, ~/.claude/agents/ ○ 適用範囲:個人、プロジェクト横断 ○ 共有:基本的にチーム共有されない 参考:https://docs.anthropic.com/ja/docs/claude-code/slash-commands

Slide 12

Slide 12 text

配置による設定の違い / Claude Code ● プロジェクトに配置 .claude/commands/, .claude/agents/ ○ 適用範囲:プロジェクト ○ 共有:git等で簡単にチーム共有可 ● ホームディレクトリに配置  ~/.claude/commands/, ~/.claude/agents/ ○ 適用範囲:個人、プロジェクト横断 ○ 共有:基本的にチーム共有されない 参考:https://docs.anthropic.com/ja/docs/claude-code/slash-commands 簡単に共有できる反面、 各自の創意工夫が生まれにくい  ⇒ベストプラクティス模索中の   状況下では、もったいない

Slide 13

Slide 13 text

配置による設定の違い / Claude Code ● プロジェクトに配置 .claude/commands/, .claude/agents/ ○ 適用範囲:プロジェクト ○ 共有:git等で簡単にチーム共有可 ● ホームディレクトリに配置  ~/.claude/commands/, ~/.claude/agents/ ○ 適用範囲:個人、プロジェクト横断 ○ 共有:基本的にチーム共有されない 参考:https://docs.anthropic.com/ja/docs/claude-code/slash-commands 自由に試行錯誤して ブラッシュアップしやすい反面、 ナレッジがチームに蓄積されづらい  ⇒品質・生産性に差が生まれる

Slide 14

Slide 14 text

SuperClaudeを利用した場合 / Claude Code ● SuperClaude ○ コマンド、エージェント、 MCP等がパッケージされた Claude Codeのフレームワーク ○ 導入してしまえば、用意されたコマンドを使ってレールに乗ったチーム開発が可能 ● 現時点での所感 ○ メリット ■ 導入が楽で、便利 ■ 汎用的で、質の高いアウトプットが期待できる ○ デメリット ■ やや機能が過剰 ■ Claude Codeのユーザー設定がごちゃごちゃする ■ ⇒プロジェクト固有の設定に不向き ○ よって、今回はSuperClaudeを使わないで解決策を探る ■ コマンド、エージェント、 MCP等の参考に留める

Slide 15

Slide 15 text

解決策

Slide 16

Slide 16 text

設定共有 / Claude Code ● /agents, /commandsディレクトリの共有用リポジトリを作る ○ makeコマンドやshellスクリプトで、以下のようなコマンドを実装 ■ claude-push:自身の設定をgit管理化に配置する ■ claude-pull: 他者の設定にシンボリックリンクを張る ● 各自が自身のディレクトリに push ○ バージョン管理のメリットを享受できる ● 他者の設定を閲覧したり、コマンドで一発導入 ⇒それぞれ試行錯誤しつつ、 ナレッジが蓄積・共有される

Slide 17

Slide 17 text

● 注意点 ○ pushを先に実行してもらう必要あり ■ 先に設定pullすると、自身の設定ファイルが消える可能性あり ○ jsonファイルの共有は要注意 ■ MCP設定等、credentialな情報が含まれる可能性あり 設定共有 / Claude Code

Slide 18

Slide 18 text

まとめ

Slide 19

Slide 19 text

まとめ ● Claude Codeはカスタマイズ性に優れる ● 設定ファイルは配置場所によって特性が異なる ○ プロジェクト配下=共有しやすいが故に、各自の試行錯誤が難しい ○ ホームディレクトリ配下=共有しづらいが、各自の試行錯誤がしやすい ● ホームディレクトリ配下の一部を共有化してみる ○ 自身の変更がgit管理になる=簡単に遡ったり戻せる ○ 各自の試行錯誤が簡単に共有できる

Slide 20

Slide 20 text

日程: 2025/10/09(木) 18:30 ~ (開場18:00~) 参加費: 無料 https://canly.connpass.com/event/365017/ お気軽にお越しください! 当社で開催するLTの宣伝