Claude Codeで新人エンジニアのオンボーディングを劇的に短縮する実践ガイド

新人エンジニアが戦力になるまでの 立ち上がり期間 は、どの会社でも大きなコストです。巨大なコードベース、散在するドキュメント、属人化した暗黙知。Claude Code を新人の相棒にすれば、3ヶ月かかっていた習熟が2週間に短縮できます。

1. 環境構築を半日で終わらせる

最初の壁は環境構築。先輩に聞きまくる時間を Claude Code が肩代わりします。

# 新人が自分の Mac で実行
claude -p "
このリポジトリ（https://github.com/our-org/main-app）の開発環境を
macOS で立ち上げる手順を教えてください。

ステップごとに:
1. 必要なツール（バージョン指定付き）
2. インストールコマンド
3. 環境変数の設定
4. 起動確認方法
5. よくあるエラーと対処

.env.example と README を読んで具体的に。
"

先輩の Slack DM が激減します。

2. コードベースの全体像を5分で把握

巨大リポジトリの構造理解には、Claude Code の要約力が効きます。

claude -p "
このリポジトリの全体構造を説明してください:

1. ディレクトリ構成と各ディレクトリの役割
2. 主要なエントリーポイント
3. データフロー（リクエストがどう処理されるか）
4. 外部サービス連携（DB、API、キューなど）
5. 特に読むべきファイル5つ

新人が1週間でコードを触れるようになるための
読書順序も提案してください。
"

コードベースナビゲーション のテクニックと組み合わせると強力です。

3. 暗黙知を形式知化する

古株しか知らない「なぜこうなってるか」を Claude Code に聞き出させます。

claude -p "
src/services/billing/LegacyInvoiceService.ts について、
git log --follow と blame から以下を推測:

1. なぜこの設計になったか
2. 修正時の注意点（過去に起きたバグパターン）
3. 関連する他のサービス
4. 触るときに確認すべきコード

チームメンバーが読んで補足しやすい形式で
docs/onboarding/legacy-notes.md に出力。
"

出力を GitHub Discussions で叩き台にしてレビューすれば、コードレビュー駆動のドキュメント整備ができます。

4. 初PRの題材を自動でレコメンド

新人が最初に触るべき「小さくて安全なタスク」を抽出。

claude -p "
このリポジトリから新人の初PR候補を5つ提案してください:

条件:
- 変更が独立している（副作用が少ない）
- テストが既にある
- ビジネスロジックの中核ではない
- 30〜100行程度の変更で済む

good-first-issue のラベル傾向と、
TODO/FIXME コメント、軽微なリファクタ候補から探して。
各候補について見積もり工数と学べることも添えて。
"

5. コードレビュー前のセルフチェック

新人のPRが差し戻される回数を減らす工夫。

claude -p "
git diff origin/main...HEAD を確認し、
新人エンジニアが出す前にセルフレビュー:

1. CLAUDE.md のルール違反
2. 命名の違和感
3. テスト不足
4. 既存コードとのスタイル不一致
5. セキュリティ上の懸念

重要度つきで、修正すべき項目のみ列挙してください。
"

レビュー往復が激減します。コードレビュー活用 も参照。

6. 質問する前に Claude に聞く文化

「先輩を煩わせる前に Claude に聞く」を CLAUDE.md でルール化。

## 新人向け質問ガイド

### まず Claude Code に聞く
- コードの動作原理
- エラーの意味
- 設計判断の理由（git log + blame で）
- ツールの使い方

### それでも分からない時だけ Slack #dev-help に
- ビジネスルールの解釈
- 優先順位の判断
- 権限が必要な作業

### 先輩への質問の書式
1. やろうとしていること
2. 試したこと（Claude の回答含む）
3. 詰まっているポイント

これだけで 先輩の割り込み工数が30%減 します。

7. 週次ふりかえりを自動生成

メンターとの1on1用のサマリを Claude Code に書かせます。

claude -p "
直近1週間の私の活動をまとめてください:

- git log --author='新人の名前' --since='1 week ago'
- 作成したPR一覧と状態
- レビューコメントで受けた指摘の傾向
- 詰まった箇所（コミットメッセージから推測）

メンターとの1on1で話すテーマを
3つ提案してください。
"

新人自身が自分の成長を俯瞰できるようになります。

やってはいけないこと

❌ すべてを Claude に任せる

Claude Code は暗黙知を推測するだけ。ビジネスロジックの「なぜ」は、必ず人間のドメイン知識で裏付けを取ること。

❌ 新人の質問を封じる

「Claude に聞け」を徹底しすぎると、新人が孤立します。最初の2週間は積極的に1on1を入れる のが大事。

❌ ドキュメント整備を後回し

Claude Code が生成した暗黙知ノートを放置すると陳腐化します。チームで定期レビューしてメンテ。

まとめ

• 環境構築を半日で自走
• コードベースの全体像を5分で把握
• 暗黙知を形式知化
• 初PRの題材を自動レコメンド
• セルフレビューでPR差し戻しを削減
• 「まずClaudeに聞く」文化で先輩工数を削減
• 週次ふりかえりを自動生成

新人の立ち上がりが加速すれば、メンターの負担も減り、チーム全体の出荷スピードが上がります。

関連記事: コードベースナビゲーション / コードレビュー活用 / チーム開発ガイド

公式ドキュメント: Anthropic Claude Code