[Claude Code] コーディング方法

Claude Codeはコーディングに利用できるAIエージェントです。
この記事では、Claude Codeによるコーディング方法を紹介します。

やすひら

Claude Codeでのコーディング方法を紹介します

Claude Codeとは何か

Claude Codeとは、AIエージェントの1種です。
AIエージェントとは、AIがヒトの代わりにタスクを実行してくれるアプリケーションのことです。
Claude Codeは、コーディングが得意なAIエージェントなので、エンジニアが利用したいAIエージェントの1つです。

Claude Code利用の重要ポイント

Claude Codeと一緒に作業することで、エンジニアの生産性を向上させることができます。
Claude Codeと一緒にコーディングするにあたって、重要となるポイントを紹介します。

仕様やソースコードを読み込ませる

Claude Codeは、立ち上げ直後はリポジトリ内の情報を知らないので、リポジトリ内の情報を読み込ませると、品質の高い仕事をしてくれるようになります。

大雑把な依頼をしない

Claude Codeは、詳細なタスク情報を渡すと、品質の高い仕事をしてくれます。
必要な情報を渡さずに、タスクを依頼しても、思い通りのアウトプットが出てこないので注意が必要です。

仕様を決めてからコーディングする

Claude Codeは、いきなりコーディングすると、思い通りの動作ではないプログラムができやすいので、まずは仕様を整理する必要があります。
Claude Codeが、実装に進もうとしても、仕様が固まるまではグッとこらえて、仕様が完成してからClaude Codeにコーディングを依頼するようにします。
仕様を決めてからコーディングすることで、思い通りのプログラムに近いものを作ることができます。

定期的にリファクタリングする

Claude Codeに頻繁にコーディングを依頼していると、思わぬ場所でバグがあったり、同じコードが複数あることがあります。
繰り返しClaude Codeを利用していると、スパゲッティコードに陥りやすいので、定期的にリファクタリングを行うことで、スッキリとしたソースコードにしていきます。
リファクタリングすることで、可読性も向上します。
リファクタリングは、Claude Codeでも行うことができます。

Claude Codeの設定

最初にClaude Codeの設定を入れておくと、先の手順でユーザーが指示する必要がなくなります。

CLAUDE.md

CLAUDE.mdで、Claude Codeに実行してほしい指示を与えます。

設定ファイル

## 言語設定
- 常に日本語で会話する

## コミットメッセージ
- Conventional Commits 形式で書く
- 説明部分は日本語で書く
- Issue番号がある場合はスコープに含める
- 例: `feat(#1): ユーザー認証機能を追加`, `fix(#2): ログイン時のバグを修正`, `docs: READMEを更新`

## プルリクエスト
- タイトルは Conventional Commits 形式で書く
- 説明部分は日本語で書く
- Issue番号がある場合はスコープに含める
- 例: `feat(#1): ユーザー認証機能を追加`, `fix(#2): ログイン時のバグを修正`, `docs: READMEを更新`
- 本文の最後に `Closes #<Issue番号>` を記載する

CLAUDE.mdを設定しておくことで、Claude Codeの動作を制御することができます。

あわせて読みたい

[Claude Code] CLAUDE.mdの使い方

gitコマンドとghコマンドの設定

GitHubでソースコード管理している場合は、gitコマンドとghコマンドの設定を事前に行う必要があります。

• gitコマンドのユーザー設定
• ghコマンドのユーザー認証

あわせて読みたい

[Linuxコマンド]gitコマンドの概要と使い方

あわせて読みたい

[Linuxコマンド] ghコマンドの概要と使い方

Claude Codeとアイデアについて議論

Claude Codeによるコーディング前に、思いついたアイデアをAIと壁打ちしてアイデアを熟成させていきます。

アイデアを磨き上げる

AIとアイデアについて議論して、アイデアを磨き上げていきます。
AIと思いついたアイデアについて対話や議論を重ねることで、アイデアが整理されていきます。

アイデアの評価

アイデアについてAIに評価してもらうことができます。
思いついたアイデアが、ユーザーに対して有効なのかを評価できます。
新規機能を入れる場合に、メリットやデメリットをAIに分析してもらうこともできます。

アイデアの技術的実現性

思いついたアイデアが、現存する技術で実現可能なのかをAIに分析してもらうこともできます。
技術的な課題や、どの技術を活用すれば実現できるのかを、AIと議論することで整理できます。

アイデアをメモする

AIと議論して整理した内容を、テキストやMarkdown形式でメモしておくと便利です。
メモをClaude Codeに読ませることで、文脈を理解してアイデアについて議論することができます。

Claude Codeと仕様を検討

Claude Codeによるコーディング前に、Claude Codeと仕様を検討します。
仕様を明確にしておくと、コーディングの性能も向上します。
コーディング前に仕様を整理しておくことを推奨します。

実現方式

AIと議論して実現方式を決定します。
エンジニアが想定している実現方式案をAIに提案して、分析や評価をしてもらうことができます。
AIに実現方式案を複数提案してもらって、エンジニアが採用することもできます。

利用技術の決定

AIと議論して、利用する技術を選択することができます。

• プログラミング言語
• ライブラリ
• フレームワーク
• データベース

Claude Codeによるコーディング

Claude Codeによるコーディング方法の例を紹介します。

Issueを登録

Issueを登録します。

プロンプト

Issueを登録したいです。
Issue案を提案してください。

Issueを登録してください。

最初にIssueのタイトルと本文の案を、Claude Codeに提案してもらいます。
Issue案の内容がユーザーの考えと合致するまで、議論します。
Issue案の内容がユーザーの考えと合致したら、Issueを登録してもらいます。

Issueを確認

Issueを確認します。

プロンプト

本リポジトリのIssueを収集して、優先度をつけて表示してください。

リポジトリに紐づくIssueを収集します。
優先度をつけて表示させることで、タスクの実行順序が整理されるので便利です。

Issueを選択してブランチを切る

Issueを選択してブランチを切ります

プロンプト

Issue#1に着手します。ブランチを切ってください。 

Issueの内容にあった名称のブランチを作成して、ブランチを切り替えてくれます。

変更内容をClaude Codeに読み込ませる

Issueや変更内容をClaude Codeに読み込ませます。

プロンプト

Issue#1の修正案を提案してください。

Issueとソースコードを読み込んで、Claude Codeが修正案を提案してくれます。

修正案について質疑応答

修正案について質疑応答して、修正案を磨き上げていきます。

プロンプト

XXXはYYYでしょうか？

XXXをYYYにしてください。

修正案について質疑応答して、修正案を磨き上げていきます。

修正案を改めて表示

修正案を改めて表示して整理します。

プロンプト

修正案を改めて表示してください。

修正案を改めて表示することで、修正内容を整理します。
修正内容を変更したい場合は、Claude Codeと議論して変更してもらいます。

実装(コーディング)

修正案を実装(コーディング)します。

プロンプト

実装してください。

実装を依頼して、修正案を実装していきます。
変更内容を確認しながら、修正を許可していきます。
全て許可することも可能です。

実装確認

ソースコードを確認して、実装を確認します。

プロンプト

XXXはYYYでしょうか？

実装確認は、エディターを利用して手動で確認できます。
Claude Codeに確認することも可能です。
追加修正が必要な場合は、修正を依頼します。

README.mdとCLAUDE.mdを修正

README.mdとCLAUDE.mdを修正します。

プロンプト

README.mdとCLAUDE.mdに変更内容を修正してください。 

修正した内容をREADME.mdとCLAUDE.mdに反映します。

Claude Codeによるデバッグ/リファクタリング

Claude Codeによるデバッグ/リファクタリング方法の例を紹介します。

デバッグ

Claude Codeにバグ分析を依頼してデバッグします。

プロンプト

ソースコードを分析して、バグを報告してください。

XXXをYYYに修正したいです。修正案を提案してください。

AIエージェントを利用したバグ修正は様々な方法で実行できます。
– AIにソースコード分析してもらう方法
– 既知のバグを内容を指定して修正する方法

リファクタリング

Claude Codeに改善点の分析を依頼してリファクタリングします。

プロンプト

ソースコードを分析して、改善点を報告してください。

XXXをYYYに変更したいです。修正案を提案してください。

AIエージェントを利用したリファクタリングは様々な方法で実行できます。
– AIにソースコード分析してもらう方法
– 既知の改善箇所を内容を指定して修正する方法

Claude CodeのGit/GitHub操作

Claude CodeでGit/GitHub操作を行います。

コミット

Claude Codeにコミットを依頼します。

プロンプト

コミットします。コミットのタイトルと本文を提案してください。

コミットしてください。

Claude Codeにコミット文を生成してもらって、コミットします。

プッシュ

Claude Codeにプッシュを依頼します。

プロンプト

pushしてください。

Claude Codeにプッシュを依頼します。

プルリクエスト(PR)

Claude Codeにプルリクエストを依頼します。

プロンプト

プルリクエストします。プルリクエストのタイトルと本文を提案してください。

プルリクエストしてください。

Claude Codeにプルリクエストを依頼します。

プル

Claude Codeにプルを依頼します。

プロンプト

マージしました。mainブランチに切り替えてpullしてください。

mainブランチに切り替えて、マージ後のソースコードをpullします。

マージ済みブランチを削除

Claude Codeにをマージ済みのブランチ削除を依頼します。

プロンプト

マージ済みのブランチを削除してください。

マージ済みのブランチを削除します。

Claude Codeを利用したコーディングの注意事項

Claude Codeを利用したコーディングの注意事項を紹介します。

Claude Codeが全て解決してくれると思わない

Claude Codeは便利なツールで、自然言語で依頼したタスクを実行してくれますが、Claude Codeが自分のタスクや課題を全て解決してくれるわけではありません。
いずれは全て解決するAIが登場する可能性もありますが、Claude Codeが現状でできることを理解した上で利用すると良いと思います。

Claude Codeが生成したコードをチェックする

Claude Codeはコーディングが得意なAIエージェントですが、Claude Codeが生成したコードが誤っている可能性もあります。
生成されたコードは、エンジニアが必ずレビューやテストを行って、コードが正しいかをチェックする必要があります。
AIエージェントでレビューやテストを行うこともできるため、ヒトとAIエージェントで一緒にチェックすると、品質の高いコードが生成できると思います。

Claude Codeの提案が全て正しいと思わない

Claude Codeは、アイデアやコード修正案を提案してくれますが、Claude Codeが全て正しいわけではありません。
ある特定の条件によっては、Claude Codeの提案が誤っていることもあるため、Claude Codeの提案を受ける側が提案内容について、チェックする必要があります。

定期的にリファクタリングを行う

Claude Codeを利用してコーディングを続けていくと、重複した処理が複数箇所に生成されたり、処理効率が悪いロジック担ってしまう場合があります。
定期的にリファクタリングを行うことで、スパゲッティコードになってしまうことを防止します。
リファクタリングもClaude Codeに依頼できるので、定期的にコードを改善していくと良いです。

判断はヒトが行い責任を持つ

Claude Codeはコーディングに有用なツールですが、生成したコードに責任を持ってくれるわけではありません。
最終的な判断や責任を持つことは、今のところヒトに残された権限の1つです。

まとめ

Claude Codeを利用したコーディング方法について紹介しました。

Claude Codeを利用したコーディングは、自然言語で対話しながらコーディングができます。
コーディングの前に、仕様を整理して、具体的な処理をClaude Codeに伝えることで、高品質なコードを高速で生成することができます。
Git/GitHubの作業もClaude Codeに依頼でき、コミットやプルリクエストのコメントも生成できるので便利です。
Claude Codeを利用してコーディングすることで、高品質なプロダクトをたくさん作成して、より多くの課題を解決していきましょう。