Claude Codeを使いこなすための実践Tips集

https://glpgs.connpass.com/event/362686/participation/#participants
での発表資料です

Transcript

1. July 30, 2025 Claude Codeを使いこなすための実践 Tips集 現場×実践 Claude Code活用交流会 @katakyo
2. はじめに
3. 片田 恭平 プロダクト開発部 データベースミッション 23卒でマイベストに新卒入社 現在は社内システムの AIワークフローの開発、社内の AI活用改善などしています kashiwa.rbによく出没します •自己紹介 @katakyo_51 開発、リサーチ / ゲーム 自作PC/映像制作/ラーメン/野球/ハンドボール/ダーツetc…. •趣味 ⾃⼰紹介 よく使う: Ruby on Rails(Ruby), Next.js(Typescript),AWS, LLM全般 最近勉強中: FastAPI(Python), Lua, GCP •触る技術
4. 株式会社マイベスト 従業員数 243名 ※2025年5月1日時点（アルバイトを除く） 創業年月日 2016年10月 代表者 代表取締役 CEO 吉川 徹 本社所在地 東京都中央区築地 7-17-1 住友不動産築地ビル
5. 人生は選択の連続でできています。 マイベストは選択をよりよくすることで、ユーザーの生活を豊かにすることに貢献 したいと考えています。 最高の選択体験を 実現する。 私たちのミッション
6. 月間利用者 数 3,000 ユーザーの “選択”を サポートするサービス 万人以 上 （2024年11月時点）
7. 各商材の「〇〇 おすすめ」検索の 3位以内割合 約 86% 月間利用回数 約 5,000万回以上 3位以内 4位以降 2016/2 2017/2 2018/2 2019/2 2020/2 2021/2 2022/2 認知獲得 ｢検索｣の領域では大きなプレゼンスを獲得 既存の選択におけるプラットフォームである「検索」において、月間利用回数 5,000万回以上使われるサービスにまで成長。 2023/06実績
8. データベース 実際に商品を購入し、専門人材がデータベースを制作 各領域で専門性を持った人材が社内に在籍。 実際に商品を購入し、社外の専門家や施設と協力しながら、相対比較や実測した情報に基づいたオリジナルな商品のデータベースを制作しています。 現在地 キャンプインストラクター・ 秘境キャンパー / マイベスト アウトドア担当 舘岡 新九郎 バリスタ・焙煎士 / マイベスト コーヒー担当 相野谷 大輔 パーソナルトレーナー・一児のママ / マイベスト フィットネス・マタニティ担当 前野 由衣 光学・皮膚計測・ 元Panasonic技術開発者 / マイベスト 検証方法設計担当 功刀 公太
9. データベース テスト環境も⾃社で整備 自社内に倉庫やラボ、撮影スタジオがあり、商品テスト環境を完備したオフィスになっています。検証機器は高価なものだと1つあたり購入価格で約1,000万円 するなど、商品のデータの精度を高めるべく、積極的に設備投資を行っています。 現在地
10. 商品の検証の様子
11. 自社倉庫
12. ⽣成AI/LLMの活⽤ 開発 全社AI活⽤ モデル エンジニア全員へのCursor / GitHub Copilotの配布、Devinの利⽤、Claude Code ActionでのPRレビューなど、積極的に開発に AIを取り⼊れています。また、プロダクトやオペレーションにも⽣成AIを組み込んでおり、RAGを⽤いたAI接客機能のPoCや、 AI/LLMを⽤いたコンテンツ制作の効率化を進めています。
13. エンジニア積極採⽤中です！
14. ・本日の発表後に皆様には、以下のような状態になっていただけることを目指します 本日のゴール 01 Claude Codeの 基本機能が わかる 02 開発での 定型作業を 自動化できる 03 企業、個人で 導入したくなる
15. アジェンダ 1 なぜ、今Claude Codeが熱いのか 2 Claude Codeの基本機能に関して 3 開発業務を効率化するための Tips集 4 使ってわかった Claude Codeの注意点 5 まとめ
16. 01 なぜ、今Claude Codeが熱いのか
17. 今日のZennのトレンド
19. 世は正に Cluade Code時代
20. CursorもAI Agent使えるのに なんでClaude Codeが選ばれているか
21. Cursorだとこんなことありませんか？
22. プロンプトで指示しているのに Cursorって途中で 終わったふりするんだよね 28歳・男性 CursorにUnitテスト実行させたら開発環境の DB 全部消されちゃった 28歳・男性 Ruleは設定できて、コマンドの指定とかが markdownに書いてるんだけど、絶対実行して 欲しいルールとかよく忘れるんだよね 28歳・男性 Cursorだと計画なくすぐにタスクを進めることが ある(最近は徐々に改善されてきているかも ) 28歳・男性
23. この課題Claude Codeなら解決できます
24. Cursorが活きる場面 リアルタイムで補完し、あくまでAI Agentをパートナーとして使うとき 応答が早いため、小タスクならCursorの方が速い Claude Codeが活きる場面 設計→実装→テスト→コミットなどコード記述以外の部分もAI Agentとして使う 場合 自走力があるので、大規模リファクタリングなど CursorとClaude Codeの比較 CursorのAgent modeをメイン使っている人は Claude Codeに乗り換えましょう
25. 02 Claude Codeの基本機能に関して
26. Node.js 18以上とnpmをPCにinstall下記のコマンドを実行すれば、 OK Claude Codeの導入方法
27. 初回ログイン時に webでOAuth認証するか、API keyを入れて起動して以下のような画面が出れば OK Claude Codeの導入方法
28. 基本的な使い方として以下のようにプロンプトを打ち込めば OKです Claude Codeでプロンプトを入力する
29. Shift+Tabを押すと以下の 3つのモードに切り替えることができます Claude Codeの便利なモード切り替え normal-mode: 通常モード 全ての操作で確認プロンプトが表示されます 実装が大方終わってリファクタリングなどの時はこのモードがおすすめです 1 auto-accept edit on: ⾃動承認モード 全ての操作を自動的に許可し進めます Vibe Codingをするなら実装はこのモードがおすすめです コマンドも自動実行する場合は--dangerously-skip-permissionsをつけると良い です(denyの設定などは適切にしたり危険なMCPサーバーを使わないこと) 2 plan mode on: 計画モード 読み取り専用で、計画立案のみします 実装する前はこのモードで実装のTODOを立てるのがおすすめです 3
30. /を入れると便利なスラッシュコマンドが出てきます 自分でカスタマイズしたカスタムスラッシュコマンド も作ることが可能！！ Claude Codeの基本的な使い方
31. 以下のコマンドは覚えておくと良いです 覚えておくべきスラッシュコマンド 重要度が高いもの • /init: プロジェクトにClaude Codeを導入するときはこのコマンドがおすすめです(CLAUDE.mdなどが作られる) • /review: コードレビューをお願いするときに使う • /clear: 会話をクリアにする(会話が長くなり、コンテキストが大きくなったら適度にリセットにするのが良い) • /agents: ClaudeCode内で動くSub Agentを管理する(作成、削除) • /memory: 参照するCLAUDE.mdの管理、編集など • /pr_comments: プルリクエストのコメントの確認など その他覚えておくと良いもの • /compact: 長い会話を要約してトークンを節約 • /config: 設定の確認・変更 • /cost: 現在の利用料金を確認 • /vim: Vimキーバインドを有効化/無効化
32. 03 開発業務を効率化するための Tips集
33. 使い方はなんとなく理解したが、 Claude Codeを効果的に使うためにどんな 準備が必要だろう ...
34. いくつかClaude Codeを使うための 準備を説明します
35. CLAUDE.mdはClaude Codeが自動的にコンテキストとして 読み込むファイルです CLAUDE.mdを整備する 書いた方が良いもの ・プロジェクトの技術スタック ・ディレクトリ構成 ・API仕様書 (RESTfulな開発ならエンドポイント含めて用意しておくといいです ) ・使用頻度の高い、コマンドとその説明 ・コーディング規約やコードスタイル ・必ず確認して欲しいことなど (Hooksで定義するのがより適切かも ) ・ユビキタス言語 (社内のドメイン知識を事前学習させて使える )
36. Claude Codeも読み込めるコンテキストの上限があるので、モノリポの構成なら各ドメインに CLAUDE.mdを配置すると効果的です リポジトリが分かれている複数プロジェクトに対して適応したい場合はホームディレクトリに設定を寄せるのがおすすめです またチーム開発時に個人で使いたいルールは CLAUDE.local.mdで管理しましょう (Git Worktreeを使う場合はうまく動作しないので注意 ) CLAUDE.mdを分割して管理する
37. ルールを書く上でのコツとして以下のようなものがあります CLAUDE.mdの書き方のコツ 重要なルールは **で囲んで AIに強く意識させる 思考の深さを制御する プロンプトのコツですが、特定のキーワードを含めることで AIの思考リソースをコントロールできます 高度な思考: 塾考、深く考えて、しっかり考えて | think harder, think intensely 中程度の思考: もっと考えて、よく考えて | think hard, think more 軽度の思考: 考えて | think |
38. .claude/commands/ディレクトリにMarkdownファイルを置くだけで、オリジナルコマンドが作れます。 よくある作業はカスタムスラッシュコマンドを作ってなるべく楽をしましょう カスタムスラッシュコマンドを整備する 例: Dependabot対応コマンド .claude/commands/review-deps.mdに右のようなコマンドを定 義 使い方：/review-depsと打つだけ！ MCPもプロンプトで定義すれば読んでもらえるのでファクト チェックとしてPlaywrght MCPなど使ってwebのソースを取りに 行くのも良さそうです
39. カスタムスラッシュコマンドの活用案 自分が考えた限りですが、こんな感じのコマンドがあると便利だなと思いました ・コードレビュー基準に沿ったレビューコマンド ・PRの自動生成コマンド ・CLAUDE.mdの差分更新用コマンド ・新メンバーの環境セットアップコマンド ・GitのStagingにある差分の中で typoや変数名の別案を考えてくれるコマンド 繰り返し使われているなという作業は積極的にカスタムスラッシュコマンド化しま しょう！
40. Sub Agentsを活用する CLAUDE.mdはかけたが全てのモジュールの CLAUDE.mdを読むと文章が多すぎてコンテキストが足り ない場合があります。今月 /agentsというコマンドで sub Agentを作成できる機能ができたのでそれを使 う と解消できる可能性があります Create new agentを使うと Manualで作ったり Agent自体をClaude Codeに生成してもらうことが可能で す
41. Sub Agentsを活用事例 Agentは.claude/agents/**.mdで定義でき 命名した名前をプロンプトとして打ち込むと SubAgentにタスクが委譲されます
42. Sub Agentsを活用事例案 例1: ドメイン特化エージェント (Frontend/Backend) • 課題: モノリポプロジェクトで、 Frontendの修正時にBackendのルールまで読み込んでしまい、コンテキストを無駄に消費。 • 解決策 : ◦ /fe-agent: Frontendのディレクトリ構成、コンポーネントライブラリの規約、 Storybookのルールのみを読み込むエージェン ト。 ◦ /be-agent: BackendのDBスキーマ、API仕様書、認証ロジックのみを読み込むエージェント。 例2: プロセス特化エージェント (実装/品質保証 ) • 課題: 実装後の品質チェック（ Lint, Test, Format）が非常に多くのコンテキストを消費し、実装時の文脈を忘れてしまう。 • 解決策 : ◦ task-executor: 実装にのみ集中するエージェント。 ◦ quality-checker: 実装コードを受け取り、品質チェックだけを専門に行うエージェント。
43. ガードレールを整備 ここまで、 Claude Codeを動かすための Tipsを紹介しましたが、 Projectと して安全に動かすためにガードレールをうまく整備しましょう (.claude/settings.jsonで定義する ) • permission: 実行可能コマンドを(allow)、禁止コマンドをdenyに置く • env: Claude Code特有の環境変数をここに置く (API key以外はGit管理しても特に問題ない ) • model: デフォルトのモデルを設定 • hooks: 実行後に何かのコマンドを必ず実行するような設定を書く • includeCoAuthoredBy: Claude CodeでコミットしたときにCo-Authorにするかの設定
44. Permissionとても大事 Permissionを正しく整備しておくと企業でも個人プランでも安心して使え るのではと思っています できること • Bash コマンドの制御 • ファイルアクセスの制御 • Web アクセスの制御
45. Hooks便利なので活用しよう Hooksとは？ HooksはClaude Codeのライフサイクル（例 : ファイル編集後）に割り込んで、ユーザー定義のシェルスクリプト を実行する機能です CLAUDE.mdでFormatterやLinterのCheckを書いていても忘れるという方は特定の拡張子を編集したらコマ ンドを実行するみたいにしておくと幸せになれるかもです セキュリティ上の注意 Hooksで設定されたコマンドはユーザーの確認なしに実行されるため、 予期せぬコマンドが実行されるリスク があるため、設定するコマンドにはユーザー自身が全責任を負う必要があるので、コードレビューなど通して 設定してください
46. Hooks活用事例案 例: ファイル変更後に必ず Biomeのチェックを実行する イベント選択 : PostToolUse (ツールの実行後 ) を選択します。 Matcher設定: Write|Edit|MultiEdit を指定し、ファイルの書き込みや編集が行われた時のみフックが発火するようにします。 コマンド入力 : 以下のコマンドを設定し、変更されたファイルのパスを取得し、 それがTypeScriptファイル（.ts, .tsx）の場合にのみbiome check --applyを実行する
47. 04 使ってわかった Claude Codeの注意点
48. 先月の個人契約の MAXプラン(100ドル)のトークン量
49. 企業導入するにあたって考えていること API modeの課題 MAXプランはエンタープライズ版がまだないので APIモードで検証していましたが、 ・デフォルトモデルの制約 : 高性能な「Opus」モデルが高額で、利用の心理的ハードルが高い。 ・コスト管理 : 従量課金制のため、利用量が増えると意図せず高額になる可能性があり、予算管理に注意が必要です。 セキュリティの課題 セキュリティに関しては、適切な設定でリスクを管理できる見込みです。 ・オプトアウト : データが AIの学習に使われないようにする「オプトアウト」は、デフォルトで有効になっています ・設定による制御 : Settings.json を適切に構成することで、意図しない危険な処理を防ぐことが可能です。 現時点では、 MAXプランを希望者に配布するのが現実的に良さそうだと思います (7万くらい使っているのに 1.5万くらいで済んでるので ) LayerXの導入事例 : https://tech.layerx.co.jp/entry/2025/06/05/161631
50. Cursorと併用して使うと PCのメモリが圧迫するので注意
51. Cursorと併用して使うと PCのメモリが圧迫するので注意 原因 この問題は、Cursorに搭載されている 「Shadow Workspace」 という機能が大きく関わっています。この機能 は、AIによるコード生成や編集が実際の開発環境に意図しない変更を加えるのを防ぐためのものですが、そ の仕組み上、大量のメモリを消費する傾向があります。 対策 Claude Codeのようにメモリ消費の大きいツールを Dockerなどと併用する際は、以下のいずれかの対策をお 勧めします。 1. 併用するなら Cursorの「Shadow Workspace」機能をオフにする 2. VS Code や Neovim など、より軽量な別のエディタで Claude Codeを利用する
52. Claude Codeとtmuxの並列化も試してみました 動画の事例は、ChatGPT研究所さんのNoteに改良+VOICEVOXMCP: https://chatgpt-lab.com/n/na59171855b1e サクッと試したい方はあきらパパさんの記事がおすすめ https://zenn.dev/akira_papa/articles/e9059bbacd0b43 Claude CodeがCLIなのでShellスクリプトで起動できたり、メッセージをやり取りするなど学ぶ点が多かった
53. Claude Codeとtmuxの並列化も試した所感 課題感 • Cluade Codeを並列で起動するので Rate Limitに引っかかりやすい • 企業で使う際に、並列でタスクをこなすという場面があまり出てこない (Sub Agentの機能が出たの でそれを選ぶ方が使いやすそう ) • 1タスクに対し時間がものすごくかかる (使い方次第ですが) • コード差分が多すぎて自分のセルフレビューがより追いつかない 結論 企業やある程度成熟したプロダクトなら並列化は現時点では不要かも (少なくとも自分には合わなかった )
54. 05 まとめ
55. まとめ 1 CLAUDE.mdは分割しつつ育てていきましょう 2 3 繰り返しのタスクはスラッシュコマンドを作りましょう 4 コンテキスト圧縮のために SubAgentを積極的に作りましょう 5 MAXプランはいいぞ Settings.jsonはセキュリティのためにしっかり整備しましょう
56. ご清聴ありがとうございました