記事一覧へ
## Claude Codeパワーユーザーへの道(フルコース)
ほとんどのユーザーはClaude Codeを「高機能なオートコンプリート」として使っている。保存しておこう。
バグをペーストして修正をもらう。機能リクエストをペーストしてコードをもらう。一問一答を繰り返すだけで、何も積み上げない。
フェラーリを買って1速でしか走らないようなものだ。
Claude Codeはコード提案ツールではない。コードベース全体を読み、アーキテクチャを理解し、マルチステップのプランを実行し、テストを走らせ、失敗をデバッグし、機能をエンドツーエンドで出荷できる自律型エンジニアリングパートナーだ。
ただし、正しい使い方を知っていれば、の話だ。
CasualなClaude Codeユーザーとパワーユーザーの差は才能ではない。設定だ。ワークフローだ。80%の成果をもたらす20%の機能を知っているかどうかだ。
これがそのフルコースだ。毎日Claude Codeを使い続けた数ヶ月で学んだすべてを詰め込んだ。余分なものはない。機能することだけを書いた。
---
## Level 1:ほとんどの人が飛ばす基礎
### CLAUDE.mdというシークレットウェポン
プロジェクト全体で最も重要なファイルは、ほとんどの人が一度も作ったことのないファイルだ。
CLAUDE.mdはプロジェクトのルートに置き、Claude Codeにコードベースの仕組みを正確に伝える。チームのコンベンション。パターン。ルール。好み。
CLAUDE.mdがなければ、Claude Codeは推測するしかない。チームがcamelCaseを使っていることを知らない。クラスコンポーネントよりfunctionalコンポーネントを好むことを知らない。APIの命名規則が動詞先頭であることを知らない。any型の変数を使わないことを知らない。
良いCLAUDE.mdがあれば、Claude Codeはチームの標準に自動的に従う。触れるファイルすべてで。書く関数すべてで。生成するテストすべてで。
CLAUDE.mdに書くべき内容:
- 技術スタックとバージョン
- コーディングコンベンションと命名パターン
- ファイル構造とどこに何を置くか
- テスト要件と良いテストの定義
- 好むエラーハンドリングパターン
- コードベース固有のよくある落とし穴
- このプロジェクトでClaude Codeが絶対にやってはいけないこと
このファイルを書くのに30分かければいい。その投資は来年の数千回の修正を省いてくれる。
### CLAUDE.mdの階層構造
3つのレベルがあり、違いを理解することが重要だ。
**ユーザーレベル** は `~/.claude/CLAUDE.md` に置く。自分個人のもの。個人の好み、ショートカット、スタイル。バージョン管理されないし、チームメンバーが見ることもない。
**プロジェクトレベル** はリポジトリルートの `.claude/CLAUDE.md` に置く。gitを通じてチーム全体で共有される。チームの標準、アーキテクチャの意思決定、全体ルールはここに置く。
**ディレクトリレベル** は特定のディレクトリ内に置く。そのディレクトリ内のファイルをClaude Codeが操作するときだけ適用される。異なるコンベンションを持つサブプロジェクトやモジュールに最適だ。
よくあるミス:チーム全体のルールをユーザーレベルの設定に書いてしまうこと。そして新しい開発者のClaude Codeが同じ標準に従わない理由を疑問に思う。解決策は常に同じだ。共有ルールをプロジェクトレベルに移動する。
---
## Level 2:メッセージではなくモードで考える
### プランモードと直接実行の使い分け
この区別を理解すれば、Claude Codeの使い方が一夜にして変わる。
**直接実行** はスコープが明確で限定的なタスク向けだ。このバグを修正する。このバリデーションを追加する。コードベース全体でこの変数名を変更する。Claude Codeはこれらをプランなしで即時処理できる。
**プランモード** はそれ以上のすべてに使う。モジュールのリファクタリング。複数のファイルに触れる新機能の追加。あるパターンから別のパターンへのマイグレーション。テストスイートの再構成。
プランモードでは、Claude Codeはまずプランを作成する。触れるファイル、行う変更、その順序を概説する。コードが書かれる前にプランをレビューできる。
ルールはシンプルだ:タスクが2ファイル以上に触れるか、アーキテクチャの決定を要する場合はプランモードを使う。プランなしで複雑なタスクをClaude Codeに実行させると、節約した時間よりも元に戻す時間の方が多くなる。
---
## Level 3:Claude Codeを危険にする組み込みツール
### まだ使っていない組み込みツール
Claude Codeにはほとんどの人が発見しないツールが付属している。
**GrepとGlob**:Grepはファイルの内容を検索する。Globはファイルパスに一致する。多くの人は間違った方を使って時間を無駄にしている。関数がどこで呼ばれているか調べるならGrep。テストファイルをすべて探すならGlob。Claude Certified Architect試験がこの違いを実際にテストする。それほど重要だということだ。
**Read, Write, Edit**:Editは一意のテキストマッチを使った的を絞った修正向けだ。速くて正確だ。テキストマッチが一意でないためにEditが失敗したら、ReadとWriteにフォールバックする。ファイル全体を読み、完全な修正版を書く。どちらをいつ使うかを理解しておく。
**/memoryコマンド**:Claude Codeが読み込んでいるメモリファイルを表示する。Claude Codeの動作が不安定なら、これがデバッグツールだ。実行して、正しいコンテキストが実際に読み込まれているか確認する。
### カスタムスラッシュコマンド
繰り返し実行するタスク用のコマンドを作る。
共有チームコマンドは `.claude/commands/` に、個人コマンドは `~/.claude/commands/` に作成する。
チームのコードレビューチェックリストを実行する `/review` コマンド。特定のパターンに従ったテストを生成する `/test` コマンド。デプロイ前にすべてが準備できているか確認する `/deploy-check` コマンド。
作成に10分かかって、繰り返しのプロンプティングの数時間を省ける。
---
## Level 4:Skills とコンテキストエンジニアリング
### Skills vs CLAUDE.md — 違いを知る
CLAUDE.mdは常に読み込まれる。すべてのセッションで。すべてのタスクで。ユニバーサルな標準はここに置く。
Skillsはオンデマンドだ。呼び出したときにアクティベートされる。タスク固有のワークフローはここに置く。
ほとんどの人が犯すミス:タスク固有の手順をCLAUDE.mdに書いてしまうこと。CLAUDE.mdが肥大化し、Claude Codeは現在のタスクに関係のないコンテキストに混乱し、適用されない指示でトークンを消費する。
ルール:すべてのタスクに適用されるなら、CLAUDE.mdに書く。特定の種類の作業に適用されるなら、Skillにする。
### パス固有ルール
チームが発見すると、なぜ今まで使わなかったか不思議に思う機能だ。
`.claude/rules/` にglobパターンを指定するYAMLフロントマター付きのルールファイルを作成する。例:
```yaml
---
paths: ["**/*.test.tsx"]
---
すべてのテストは arrange-act-assert パターンを使用すること。
データベース層を直接モックしないこと。
```
これらのルールは、パターンに一致するファイルをClaude Codeが編集するときのみ読み込まれる。コードベース全体のすべてのテストファイルが、ディレクトリに関係なく、同じテストコンベンションを自動的に適用される。
これはディレクトリレベルのCLAUDE.mdより劇的に強力だ。プロジェクト構造全体で機能するからだ。
---
## Level 5:CI/CD連携
### パイプラインへのClaude Code統合
`-p` フラグはClaude Codeを非インタラクティブモードで実行する。これがないと、CIジョブは入力待ちで永遠にハングする。Claude Certified Architect試験で最も頻繁にテストされる概念の一つだ。
`--output-format json` と `--json-schema` を組み合わせると、機械解析可能な構造化出力が得られる。CIシステムはその結果をインラインPRコメントとして自動投稿できる。
**重要な知見**:コードを生成したのと同じClaude Codeセッションは、自分の変更のレビューに向いていない。自身の判断に対してバイアスをかけてしまう推論コンテキストが残っているからだ。CI内のコードレビューには常に独立したレビューインスタンスを使う。
---
## Level 6:パワーユーザーワークフロー
Claude Codeパワーユーザーの典型的な1日の様子:
**午前**:ターミナルを開く。Claude Codeが CLAUDE.md と関連するパス固有ルールを自動的に読み込む。最初の機能を平文で説明する。Claude Codeがプランを作成する。一つのステップを調整して承認する。Claude Code が8ファイルにわたって実行し、テストを書き、走らせ、2つの失敗を修正し、コミットする。
**午後**:PRをレビューする。すべての行を自分で読む代わりに、カスタム `/review` コマンドを実行する。Claude Codeがチームの標準に照らし合わせてチェックし、3つの問題にフラグを立て、それぞれの理由を説明する。本当の問題一つに対応して残りを承認する。
**夕方**:CIパイプラインがすべての新しいPRに対して `-p` フラグ付きでClaude Codeを実行する。自動セキュリティレビュー。カバーされていないパスへの自動テスト生成。自動ドキュメント更新。すべてPRコメントとして投稿される。
これは未来の話ではない。Claude Codeパワーユーザーが今まさにやっていることだ。
---
## 認定パス
この知識を正式なものにしたいなら、AnthropicはClaude Certified Architect Foundations試験を提供している。この記事で扱ったすべてをテストする:CLAUDE.mdの階層構造、ツール使用、プランモード、パス固有ルール、CI/CD連携、プロンプトエンジニアリング、MCP設定。
シナリオベースの選択式だ。誤答は良いエンジニアリングに聞こえるよう設計されている。正答はどのテクニックをどの問題に適用するかを具体的に知っている必要がある。
Claude Codeで実際のプロジェクトを構築し、この記事の概念を理解しているなら、試験に臨む準備ができている。
---
## まとめ
Claude Codeは、ほとんどの開発者がかろうじてしか使っていない最強の開発ツールだ。
カジュアルな使い方とパワーユーザーとしての使い方の差は、数ヶ月の学習ではない。意図的なセットアップと練習の数日だ。
CLAUDE.mdを設定する。プランモードを覚える。カスタムコマンドを作る。パス固有ルールを使う。CI連携する。
その5つをやれば、ほとんどの開発者が1ヶ月で出荷するより多くのコードを1週間で出荷できるようになる。
ほとんどの人はClaude Codeに一問一答を続け、一問一答の答えをもらい続けるだろう。
本物のシステムをその周りに構築した人たちは、30日以内にまったく別のレベルで動いているだろう。

claude-codeCLAUDE.mdci-cdclaude-setup
Claude Codeパワーユーザーへの道:設定・ワークフロー・CI/CD完全ガイド
♥ 230↻ 27
原文を表示 / Show original
Khairallah AL-Awady
@eng_khairallah1
How to Become a Claude Code Power User (Full Course)
41
35
243
387K
Most users are using Claude Code like a fancy autocomplete.
Save this :)
They paste in a bug. They get a fix. They paste in a feature request. They get some code. One question, one answer, over and over, never building on anything.
That is like buying a Ferrari and only driving it in first gear.
Claude Code is not a code suggestion tool. It is an autonomous engineering partner that can read your entire codebase, understand your architecture, execute multi-step plans, run tests, debug failures, and ship features end to end.
But only if you know how to use it properly.
The gap between a casual Claude Code user and a power user is not talent. It is configuration. It is workflow. It is knowing the 20% of features that deliver 80% of the results.
This is the full course. Everything I have learned from using Claude Code every single day for months. No filler. Just what works.
Level 1: The Foundation Most People Skip
CLAUDE.md Is Your Secret Weapon
The single most important file in your entire project is one that most people have never created.
CLAUDE.md sits in the root of your project and tells Claude Code exactly how your codebase works. Your conventions. Your patterns. Your rules. Your preferences.
Without it, Claude Code is guessing. It does not know that your team uses camelCase. It does not know that you prefer functional components over class components. It does not know that your API naming convention is verb-first. It does not know that you never use any-typed variables.
With a good CLAUDE.md, Claude Code follows your team's standards automatically. Every file it touches. Every function it writes. Every test it generates.
Here is what belongs in your CLAUDE.md:
Your tech stack and versions
Coding conventions and naming patterns
File structure and where things go
Testing requirements and what constitutes a good test
Error handling patterns you prefer
Common pitfalls specific to your codebase
Things Claude should never do in this project
Spend 30 minutes writing this file. That investment will save you thousands of corrections over the next year.
The CLAUDE.md Hierarchy
There are three levels and knowing the difference matters.
User-level lives at ~/.claude/CLAUDE.md. This is personal to you. Your preferences, your shortcuts, your style. It is not version controlled and your teammates will never see it.
Project-level lives at .claude/CLAUDE.md in your repo root. This is shared with your entire team through git. Team standards, architectural decisions, and universal rules live here.
Directory-level lives inside specific directories. These apply only when Claude Code is working on files in that directory. Perfect for sub-projects or modules with different conventions.
The most common mistake: Putting team-wide rules in your user-level config. Then wondering why the new developer's Claude Code is not following the same standards. The fix is always the same. Move shared rules to project-level.
Level 2: Think in Modes, Not Messages
Plan Mode vs Direct Execution
This distinction will change how you use Claude Code overnight.
Direct execution is for tasks with clear, limited scope. Fix this bug. Add this validation. Rename this variable across the codebase. Claude Code can handle these immediately without needing to plan.
Plan mode is for everything bigger. Refactoring a module. Adding a new feature that touches multiple files. Migrating from one pattern to another. Restructuring your test suite.
In plan mode, Claude Code first creates a plan. It outlines what files it will touch, what changes it will make, and in what order. You review the plan before any code is written.
The rule is simple: if the task touches more than 2 files or requires architectural decisions, use plan mode. If you let Claude Code execute complex tasks without planning first, you will spend more time undoing damage than you saved.
Level 3: Tools That Make Claude Code Dangerous
Built-in Tools You Are Not Using
Claude Code comes with tools that most people never discover.
Grep vs Glob: Grep searches file contents. Glob matches file paths. Most people use the wrong one and waste time. If you are looking for where a function is called, use Grep. If you are looking for all test files, use Glob. The exam for Claude Certified Architect literally tests this distinction. That is how important it is.
Read, Write, Edit: Edit is for targeted modifications using unique text matching. It is fast and precise. When Edit fails because the text match is not unique, fall back to Read plus Write. Read the full file, then write the complete modified version. Know when to use which.
The /memory command: This shows you which memory files Claude Code has loaded. If Claude Code is behaving inconsistently, this is your debugging tool. Run it and check whether the right context is actually loaded.
Custom Slash Commands
Build commands for tasks you run repeatedly.
Create them in .claude/commands/ for shared team commands or ~/.claude/commands/ for personal ones.
A /review command that runs your team's code review checklist. A /test command that generates tests following your specific patterns. A /deploy-check command that verifies everything is ready for deployment.
These take 10 minutes to create and save hours of repetitive prompting.
Level 4: Skills and Context Engineering
Skills vs CLAUDE.md — Know the Difference
CLAUDE.md is always loaded. Every session. Every task. Universal standards live here.
Skills are on-demand. They activate when you invoke them. Task-specific workflows live here.
The mistake most people make is putting task-specific procedures in CLAUDE.md. Your CLAUDE.md gets bloated, Claude Code gets confused by irrelevant context, and you burn tokens on instructions that do not apply to the current task.
The rule: If it applies to every task, put it in CLAUDE.md. If it applies to a specific type of work, make it a skill.
Path-Specific Rules
This is the feature that teams discover and immediately wonder how they lived without.
Create rule files in .claude/rules/ with YAML frontmatter that specifies glob patterns. For example:
yaml
---
paths: ["**/*.test.tsx"]
---
All tests must use the arrange-act-assert pattern.
Never mock the database layer directly.
These rules only load when Claude Code is editing files that match the pattern. Every test file in your entire codebase, regardless of directory, gets the same testing conventions applied automatically.
This is dramatically more powerful than directory-level CLAUDE.md because it works across your entire project structure.
Level 5: CI/CD Integration
Claude Code in Your Pipeline
The -p flag runs Claude Code in non-interactive mode. Without it, your CI job hangs forever waiting for input. This is the single most tested concept in the Claude Certified Architect exam.
Use --output-format json with --json-schema to get machine-parseable structured output. Your CI system can then post findings as inline PR comments automatically.
Critical insight: The same Claude Code session that generated code is less effective at reviewing its own changes. It retains reasoning context that makes it biased toward its own decisions. Always use an independent review instance for code review in CI.
Level 6: The Power User Workflow
Here is what a typical day looks like for a Claude Code power user:
Morning: Open terminal. Claude Code loads your CLAUDE.md and relevant path-specific rules automatically. You describe the first feature in plain language. Claude Code creates a plan. You review it, adjust one step, approve. Claude Code executes across 8 files, writes tests, runs them, fixes two failures, and commits.
Afternoon: You review a PR. Instead of reading every line yourself, you run your custom /review command. Claude Code checks against your team's standards, flags 3 issues, and explains why each matters. You address the one real issue and approve the rest.
End of day: Your CI pipeline runs Claude Code with -p flag on every new PR. Automated security review. Automated test generation for uncovered paths. Automated documentation updates. All posted as PR comments.
That is not the future. That is what Claude Code power users are doing right now.
The Certification Path
If you want to formalize this knowledge, Anthropic offers the Claude Certified Architect Foundations exam. It tests everything covered in this article: CLAUDE.md hierarchy, tool usage, plan mode, path-specific rules, CI/CD integration, prompt engineering, and MCP configuration.
It is scenario-based multiple choice. The wrong answers are designed to sound like good engineering. The right answers require knowing specifically which technique applies to which problem.
If you have built real projects with Claude Code and understand the concepts in this article, you are ready to sit the exam.
The Bottom Line
Claude Code is the most powerful developer tool most developers are barely using.
The gap between using it casually and using it like a power user is not months of learning. It is a few days of intentional setup and practice.
Configure your CLAUDE.md. Learn plan mode. Build custom commands. Use path-specific rules. Integrate it into CI.
Do those five things and you will ship more code in a week than most developers ship in a month.
Most people will keep pasting one-off questions into Claude Code and getting one-off answers.
The ones who build a real system around it will be operating at a completely different level within 30 days.
Follow me @eng_khairallah1 for more agent architecture guides, orchestration patterns, and building systems.
hope this was useful for you, Khairallah ❤️
Want to publish your own Article?
Upgrade to Premium
6:24 PM · Apr 23, 2026
·
387.4K
Views
41
35
243
648
Read 41 replies