👋

Claude Codeで開発効率を底上げするスマートTips集

2025/07/08に公開

“あれ…設定しておけばよかった！”を防ぐ

データサイエンス領域からAIアプリ開発の世界に飛び込み、CTO／COOを経験してきた私が、
生成AI時代に改めて「どうすれば直感的かつ科学的にサービス開発できるか」を模索した結果まとめたTips群です。

この記事では、以下２本の動画と公式ドキュメントを踏まえ、

Boris Cherny 氏による「Agentic Coding（エージェント的コーディング）」入門
Matt Maher 氏の「I Went Deep on Claude Code—These Are My Top 13 Tricks」
Anthropic公式Best Practices

それぞれが語る「なぜ」「どう使うか」から、“すぐ効く”＆“運用に効く” 実践的Tipsを余すところなくご紹介します。

1. 背景と理由

Agentic Coding の提唱（Boris Cherny 動画）
Anthropicのエンジニア Boris Cherny 氏が「AIを単なる補助ではなく、自律的に動く“コーディングエージェント”として使う」概念を解説。
- コーディング体験を「対話的UX」として再定義
- ツール＋ワークフロー＋モデルの一体化が重要だと強調【cite: Lue8K2jqfKk】
深掘りTricks の共有（Matt Maher 動画）
実運用で見つけた細かな小技13個を紹介。
- Memory Bank, 手動Compact, CI統合, Think Mode, 低負荷バッチ等【cite: T_IYHx-9VGU】
公式Best Practices
- CLAUDE.md や allowlist設定など基礎から学べるが、運用ノウハウは限定的
- ここで紹介するTipsは「公式＋実践」で得た“隙間”を埋めるもの

これら３つを掛け合わせることで、「動画だけ・公式だけ」では得られない、“直感×科学的”開発体験 も不可能じゃないかもと思ってしまうくらいです。

2. 日常の「あれ、設定しておけば…」を防ぐ

何度も出る確認ダイアログの煩わしさ
長時間セッションで文脈が飛ぶストレス
思考支援が浅くて再プロンプトが必要に

小さなロスを一掃し、生産性をグッと上げるための具体策を順に解説します。

3. 環境設定の小技

3.1 `.claude/CLAUDE.md` でルール共有

効果：起動時に自動読み込み／チーム共通前提の徹底

/my-project/
├─ .claude/CLAUDE.md
└─ src/
    └─ .claude/CLAUDE.md

# コードスタイル
- シングルクォート
- セミコロン必須
- max-line-length: 100

# よく使うShell
- `npm test`
- `npm run lint`

# テスト手順
1. git checkout feature/foo
2. npm install
3. npm test

3.2 `allowlist／Permissions` の最適化

効果：毎回の確認ダイアログをスキップし、対話をシームレスに【cite: Anthropic公式】

// ~/.claude/settings.json
{
  "allowedTools": ["editFile", "gitCommit", "runShell"]
}

4. ワークフロー＆フェーズ管理

4.1 `Explore → Plan → Code → Commit` フロー

効果：文脈の肥大化を防ぎ、誤実装を大幅に削減

# 1. Explore
/read src/utils/logger.js

# 2. Plan
/project:plan-logging

# 3. Code
/edit src/utils/logger.js

# 4. Commit
/shell: git add src/utils/logger.js && git commit -m "feat: add formatDate"
/shell: gh pr create --title "feat: formatDate in logger"

4.2 フェーズ分割ドキュメント戦略

効果：長期プロジェクトも小刻みに管理可能

# Phase 1: 検証
- [ ] ログ形式調査
- [ ] テストケース洗い出し

# Phase 2: 実装
- [ ] formatDate関数追加
- [ ] 単体テスト実装

# Phase 3: リリース準備
- [ ] ドキュメント更新
- [ ] リリースノート作成

5. メモリ管理＆セッション制御

5.1 手動Compact (/compact)

効果：不要な過去コンテキストを捨て、重要情報だけを保持

/compact

5.2 Memory Bank の活用

効果：再セッション時のキャッチアップが秒速化

markdown
# docs/memory.md
- ロギング: formatDate関数
- フェーズ: Phase 1–3
- CLAUDE.md 配置場所

bash
/shell: echo "- 新項目: ユーザーID自動取得" >> docs/memory.md

6. 自動化＆CI統合

6.1 ヘッドレスモードでCI組み込み

効果：プルリク時に自動で品質チェック

yaml
# .github/workflows/claude-lint.yml
name: Auto-Lint with Claude
on: [push]
jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run Claude Lint
        run: |
          claude -p "全体のLint結果をJSONで出力して" \
                 --output-format stream-json > lint-results.json
      - name: Fail on Errors
        run: |
          jq '.errors | length' lint-results.json | grep -q '^0$'

6.2 GitHub CLI（gh）連携

効果：CLIだけでPR作成／Issue操作が完結

/shell: gh pr create \
  --title "chore: fix logger format" \
  --body "Added formatDate function and tests"

6.3 低負荷時間帯バッチ実行

効果：429エラー回避／CI負荷分散

0 23 * * * cd ~/my-project && \
  claude -p "全テスト結果をJSONで返して" \
         --output-format stream-json > results.json

7. 高度なプロンプト＆“Think Mode”

7.1 具体的指示の徹底

効果：初回から正確なコード生成を心がけるといいことあります

/edit src/utils/logger.js
# "formatDate(date: Date): string を実装し、YYYY-MM-DD形式で返す関数を追加してください"

7.2 “Think Mode” トリガー

効果：複雑課題の深い推論支援

/think: "新認証フローのアーキテクチャ設計を検討してください"

8. まとめ＆次のステップ

設定し忘れや文脈切れによる小さなロスを徹底的に防ぎ
明確なワークフローとセッション管理で品質と安定性を担保し
自動化パイプラインで日々の反復作業を削減し
高度なプロンプト技術でAIのポテンシャルを最大化する

これらを組み合わせることで、Claude Code を直感的かつ科学的に使いこなす開発体験が実現します。私自身もまだ学習中ですが、今回のTipsが皆さんの開発効率向上のヒントになれば幸いです。

事業側／元エンジニアの皆さまへ

生成AIを武器に自分で事業を起こしたい方にも、
小さな効率改善の積み重ねが「プロトタイプ開発→検証→ローンチ」のサイクルスピードを劇的にアップさせます。
この記事のTipsは、技術的理解をビジネス価値創出に直結させる設計。
ぜひ手を動かしながら、あなた自身の最適ワークフローを見つけてください！

この記事を読んだら、早速リポジトリに CLAUDE.md を置き、allowlist を設定してみましょう。そこから“Explore → Plan → Code → Commit” を一度試し、自動化やThink Modeを組み込んでみる —— その小さな一歩が、あなたのAI開発体験を大きく変えるはずです！