こんにちは、Gatsbyです。Claude
やばいですね、シンギュラリティを感じます。
早く使いこなせる様にならないとやばいと焦る日々を送ってますが、キャッチアップしたくても公式ドキュメントがかなり分厚いし、Claude
の情報が散乱してるので、自分なりにまとめてみました!
この記事では、自分がキャッチアップした情報を基に Claude Code
中級者への最短距離を説明しています(各機能の詳細は別記事で説明します)。
皆さんの一助になれば幸いです 🙇
-
Claude Code
をインストールします。npm install -g @anthropic-ai/claude-code
-
claude
を起動します。セッションが開始されます。 -
まずはプロジェクトの要約をさせます。
このステップは非常に重要です。
Claude
が現状のコード、ディレクトリ構成、技術スタックなどを正確に理解することで、後続のタスクにおける回答精度が飛躍的に向上します。これはベストプラクティスです。 -
/init
コマンドでCLAUDE.md
ファイルを作成させます。先ほど要約した内容を
CLAUDE.md
に書き出してくれます。CLAUDE.md
はClaude
のセッション起動時に読み込まれるメモリです。
参照:Initialize your project – Anthropic Docs
これで初期セットアップは完了です。この状態でも Claude
は十分な力を発揮しますが、中級者としてさらに精度を向上させるには、これから紹介するチューニングやコツが必要になってきます。
誰でも今日から実践できる、Claude
の精度を上げるためのTipsを紹介します。
CLAUDE.md
でコンテキストを永続化する
Claude
のセッションはステートレスです。つまり、一度セッションを終了すると、そこでの会話内容はメモリから消えてしまいます。当然、セッションごとにプロジェクトのコードやディレクトリ構成、技術スタックなどの情報もリセットされます。
そこで、常に参照させたい、またはセッションを跨いで記憶させておきたい情報は、/init
コマンドで作成した CLAUDE.md
に記載しましょう。CLAUDE.md
は、新しいセッションが開始されるたびに自動的に読み込まれるため、Claude
は常に最新のプロジェクトコンテキストを把握できます。
しかし、コンテキストをゼロから記述するのは大変なので、公式のサンプルプロンプトを活用し効率的に CLAUDE.md
を充実させましょう。以下は、日本語で出力するように少しチューニングを加えたプロンプト例です。
> what does this project do?, and write it in Japanse in CLAUDE.md
> give me an overview of this codebase, and write it in Japanse in CLAUDE.md
> what technologies does this project use?, and write it in Japanse in CLAUDE.md
> explain the main architecture patterns used here, and write it in Japanse in CLAUDE.md
> where is the main entry point?, and write it in Japanse in CLAUDE.md
> explain the folder structure, and write it in Japanse in CLAUDE.md
> analyze the database schema, and write it in Japanse in CLAUDE.md
> what are the key data models?, and write it in Japanse in CLAUDE.md
> how does error handling work in this app?, and write it in Japanse in CLAUDE.md
> how is authentication handled?, and write it in Japanse in CLAUDE.md
参照:
プロンプトに大量のテキストを入力しない
どうやら、プロンプトに大量のテキストを直接入力すると、Claude
は処理に苦戦するようです。
これはLLMの特性によるものです。
なので、大量の指示や設定をしたい場合は、ファイルに記述し読み込ませましょう。効率的に処理し、より良い回答を生成できます。
参照:Handling large inputs – Anthropic Docs
ultrathink
Claude
には、その思考の深さを制御する概念が存在します。特定の単語を使用することで、消費トークンは増えますが、より深く思考し、回答の精度を高めることができます。
Maxプランならどれだけトークンを消費しても値段は変わらないので常に ultrathink
がおすすめです。
think
think hard
think harder
ultrathink
上記のように、思考深度は ultrathink
が最も深く、複雑な問題に対してより質の高い回答を得たい場合に有効です。
Explore, Plan, Code, Commit
Claude
は特定の Workflow
に依存することなく柔軟に指示ができる反面、フワッとした指示だと変に行間を読んで明後日の方向に進んでしまいます。
より良い精度と確実なアウトプットを得るには、いきなりタスク実装を投げるのではなく、コード理解、設計、実装、コミットの順番で命令を実行することがベストプラクティスとされています。
-
Explore
まずはコードベースや関連ファイルなどを理解させるフェーズ。> find the files that handle user authentication
-
Plan
実装の計画や設計について深く考えさせるフェーズ。
ここでultrathink
を使うと効果的です。> ultrathink how to implement Role Based User Authentication
-
Code
計画に基づき、具体的なコード実装を依頼するフェーズ。 -
Commit
実装された変更内容をコミットさせるフェーズ。
このように、段階を踏みながら命令をすることで、精度が劇的に向上します。
参照:Explore, Plan, Code, Commit – Anthropic Engineering
TDD(テスト駆動開発)
TDD
の説明は省きます。TDD Workflow
はAnthropic
お墨付きのワークフローです。
- テストの実装を命令
まずは、実装したい機能のテストコードをClaude
に実装させ、それをコミットします。
このテストは、最初は失敗するように(機能が未実装なので)なります。 - テストをパスする実装を命令
次に、テストコードを修正せずに、そのテストがパスするように実装コードを書くようClaude
に命令します。
こうすることで、アウトプットのブレが格段に少なくなります。
良さげのプロンプトがあったので貼っておきます。
/clear
セッション内での会話が長くなると、Claude
がこれまでの会話の流れに引き摺られ、文脈を誤解したり、変な回答をすることがあります。
そう感じた際は、プロンプトで /clear
コマンドを実行することでこれまでの会話をリセットできます。
claude –resume
一度閉じたけどやっぱりこのセッションを再開したい・・・ってことありませんか?
例えば、割り込みタスクのために起動中のセッションを閉じて、別ブランチに切り替えて新しくセッションを立ち上げ、割り込みタスクが終われば元のブランチに戻って・・・などなど。
その際に便利なオプションが--resume
, -r
です。
このオプションを実行すると、過去のセッション(公式ドキュメントでは conversation
と表現されています)の一覧が表示されます。戻りたいセッションを選ぶことでセッションを再開できます。
過去のセッションが何日前まで保存されるかについては、分かりませんでした。。。
参照:Resume previous conversations – Anthropic Docs
処理完了を通知させる
Claude
は複雑なタスクを実行する際に、平気で10分、20分と処理を続けたり、時には沈黙したりすることがあります。これでは「いつ終わるのか」が分からず、作業効率が落ちてしまいます。
タスク完了後に通知を受け取る設定をしておきましょう。
claude config set --global preferredNotifChannel terminal_bell
参照:Notification setup – Anthropic Docs
npx ccusage
毎日どれだけ Claude
を使い倒してるか気になりませんか?自分は気になります!
元を取りたいので、最近はどれだけ酷使できるかを日々模索しながら使ってます(本末転倒)。
このコマンドを実行することで、日々のトークン使用量や、もし従量課金だった場合の課金額を確認できます。
毎日の使用状況をチェックして、ニヤニヤしながら効率的な利用を目指しましょう!
参照:Claude Codeの使用料金を可視化するCLIツール「ccusage」を作った
その他Pro tips
その他、ここには挙げていませんが、細かいテクニック集は以下をご確認ください。
上記以外にも、Claude Code
を使いこなすための細かいテクニック集が公式ドキュメントで公開されています。ぜひこちらも確認して、Claude玄人(笑) になりましょう 💪
これで皆さんも Claude Code
中級者ですね!
今回紹介したベストプラクティスを意識し、CLAUDE.md
でのメモリ管理、段階的なワークフロー、TDDの実践、そして設定のチューニングなどを活用して、Claude玄人(笑) になりましょう 👴
P.S. 『Claude Code 玄人ガイド』作成中です笑
Views: 0