Claude Codeで命名規則を統一する方法

Claude Codeを使うと、変数名、関数名、クラス名、ファイル名などの命名規則を効率的に統一できます。

チーム共通の命名ルールを明文化し、レビューやリファクタリングに活用することで、読みやすく保守しやすいコードベースを維持できます。

命名規則を統一する重要性

命名規則が統一されていないコードは、読み手に余計な負担を与えます。

同じ意味の値に対してuserId、userID、uid、user_idのような名前が混在すると、仕様理解や修正作業に時間がかかります。

命名規則を統一すると、コードの可読性が向上し、レビューや保守作業も効率化できます。

Claude Codeで統一できる命名対象

Claude Codeでは、さまざまな命名対象を確認できます。

・変数名
・関数名
・クラス名
・メソッド名
・ファイル名
・ディレクトリ名
・APIエンドポイント名
・DBカラム名
・コンポーネント名
・テスト名

プロジェクト全体の命名ルールを整理することで、一貫性のあるコードに近づけます。

CLAUDE.mdに命名ルールを書く

命名規則を統一するには、CLAUDE.mdにチーム共通の命名ルールを書いておく方法が効果的です。

# Naming Rules

- 変数名はcamelCaseを使用する
- クラス名はPascalCaseを使用する
- 定数名はUPPER_SNAKE_CASEを使用する
- boolean変数はis、has、can、shouldで始める
- 関数名は動詞から始める
- 配列には複数形の名前を使用する
- 略語は原則使用しない
- userIdのようにId表記へ統一する
- ファイル名はkebab-caseを使用する

ルールを明文化すると、Claude Codeが命名のばらつきを検出しやすくなります。

命名規則チェック用のプロンプト例

Claude Codeへ命名規則の確認を依頼する場合は、対象とルールを具体的に指定します。

このコードベースの命名規則を確認してください。

以下を重点的に確認してください。

- 変数名の一貫性
- 関数名の分かりやすさ
- boolean変数の命名
- クラス名の命名
- ファイル名の命名
- 略語の使用
- 同じ意味を持つ名前の表記ゆれ

命名規則に違反している箇所を一覧化してください。
修正案も提示してください。

「表記ゆれ」と「修正案」を指定すると、統一作業が進めやすくなります。

boolean変数の命名を統一する

boolean変数は、trueまたはfalseを表すため、意味が明確な名前にする必要があります。

おすすめは、is、has、can、shouldなどで始める命名です。

isActive
hasPermission
canEdit
shouldNotify

flagやcheckのような曖昧な名前は避けると、条件分岐の意味が分かりやすくなります。

関数名を動詞から始める

関数名は、何をする処理なのかが分かる名前にすることが重要です。

基本的には動詞から始めると、処理内容を理解しやすくなります。

getUser()
createOrder()
updateProfile()
deletePost()
calculateTotalPrice()
validateEmail()

process()やhandle()だけでは処理内容が曖昧になりやすいため、対象や目的まで含めることが大切です。

変数名の表記ゆれを修正する

命名規則でよく発生する問題が表記ゆれです。

たとえば、同じユーザーIDを表す名前が複数存在すると、コード理解が難しくなります。

userId
userID
uid
user_id

このような場合は、プロジェクト内で1つの表記に統一します。

userId

Claude Codeに表記ゆれを検出させることで、広範囲の修正候補を洗い出せます。

略語の使用ルールを決める

略語は便利ですが、使いすぎると可読性が低下します。

たとえば以下のような略語は、読み手によって意味が分かりにくくなる場合があります。

usr
cnt
tmp
cfg
msg

基本的には省略せず、意味が伝わる名前を使用します。

user
count
temporary
config
message

ただし、API、URL、HTML、IDなど一般的に通じる略語は、チームルールとして使用可にしておくと実用的です。

ファイル名とディレクトリ名を統一する

コード内の変数や関数だけでなく、ファイル名やディレクトリ名の統一も重要です。

フロントエンドではkebab-case、ReactコンポーネントではPascalCaseなど、技術スタックに応じたルールを決めます。

user-profile.ts
order-list.ts
payment-service.ts

コンポーネントの場合は以下のように統一できます。

UserProfile.tsx
OrderList.tsx
PaymentForm.tsx

Claude Codeにディレクトリ構成も含めて確認させると、プロジェクト全体の一貫性を保ちやすくなります。

DBカラム名やAPI名も統一する

命名規則はコード内だけでなく、DBカラム名やAPIエンドポイントにも影響します。

アプリケーションコードとDB、APIの命名がずれていると、マッピング処理が複雑になります。

たとえば、DBではsnake_case、アプリケーションコードではcamelCaseを使う場合は、変換ルールを明確にしておく必要があります。

DB: user_id
Code: userId
API: userId

Claude Codeに命名変換ルールを確認させることで、仕様のずれを発見しやすくなります。

Pull Requestで命名規則チェックを自動化する

GitHub ActionsとClaude Codeを組み合わせると、Pull Request作成時に命名規則チェックを自動化できます。

name: Naming Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  naming-review:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Claude Naming Review
        run: |
          claude review --focus naming

PR段階で命名のばらつきを検出できるため、コードベース全体の一貫性を維持しやすくなります。

一括リネーム時の注意点

命名規則を統一するために一括リネームを行う場合は、動作変更を避けることが重要です。

特に以下に注意します。

・テストを実行する
・変更範囲を小さくする
・仕様変更と同時に行わない
・DBカラム変更は影響範囲を確認する
・外部APIの互換性を確認する
・自動生成コードは対象外にする

命名変更は見た目以上に影響範囲が広くなることがあります。

命名規則を継続的に改善する

命名規則は一度決めて終わりではありません。

開発を続ける中で、分かりにくい名前や表記ゆれが見つかったら、CLAUDE.mdへルールを追加します。

よく発生する命名ミスを蓄積することで、Claude Codeによるレビュー精度も高まります。

まとめ

Claude Codeを使うと、コードベース全体の命名規則を効率的に統一できます。

CLAUDE.mdに変数名、関数名、クラス名、ファイル名などのルールを定義しておくことで、命名のばらつきを検出しやすくなります。

Pull Requestで自動チェックを行えば、命名規則の乱れを早い段階で修正できます。

命名を統一することで、コードの可読性、保守性、レビュー効率を大きく改善できます。