0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@sescore(SES Core)

Claude Code毎日使い倒して気づいた実践Tips集【2026年版】SESエンジニアのフリーランス転身にも効く

0
Posted at

Claude Code毎日使い倒して気づいた実践Tips集【2026年版】

SESで3年働いた後、フリーランスに転身して1年が経った。今では仕事の7割をClaude Codeが一緒にやっている。最初は「AIアシスタントでしょ」くらいにしか思っていなかったが、使い方を覚えるにつれて明らかに別物だとわかった。

この記事では、毎日Claude Codeを使い続けて気づいた本当に効くTipsを書く。公式ドキュメントに書いてあることは省く。実際に動かして確かめたことだけ書く。

CLAUDE.mdが全ての起点になる

最初にやるべきことはこれだ。プロジェクトルートにCLAUDE.mdを置くと、Claude Codeがそれを必ず読んでからタスクに入る。

# プロジェクト概要
Next.js 15 + Supabase + Tailwind v4のWebアプリ。
本番はVercel。ローカルはポート3000。

## 鉄則
- コミットはfeat/fix/chorセマンティクス厳守
- テストなしのPRは出さない（vitest）
- 型エラーは絶対に残さない

## よく使うコマンド
- dev: `npm run dev`
- test: `npm run test`
- build check: `npm run build`

## 触らないファイル
- `.env.local`（手動管理）
- `supabase/migrations/`（CLIで管理）

これを書いておくだけで、毎回「このプロジェクトのテストどう動かすんでしたっけ」みたいな質問をしなくなる。Claudeが勝手に文脈を持ってくれる。

グローバルの~/.claude/CLAUDE.mdにも書ける。自分の場合はここに「コメントは原則書くな」「エラーハンドリングは境界のみ」みたいな自分のコーディングスタイルを置いている。

/planモードは「やってから後悔する」を防ぐ

Claude Codeには/planモードがある。これを使うと、Claudeが実際にコードを書く前に実装計画だけを返してくれる。

実際にやってみた流れ：

ユーザー: /plan
ユーザー: Supabaseのauth.usersテーブルにcustom_claimsカラムを追加して、
         RLSポリシーも更新したい

Claude Codeが返すのはこういう計画：

## 実装計画

1. マイグレーションファイルの作成
   - supabase/migrations/YYYYMMDD_add_custom_claims.sql
   - auth.usersへのカラム追加（jsonb, nullable）

2. 既存RLSポリシーの確認
   - profiles テーブルのポリシーが影響を受ける可能性
   - 要確認: auth.jwt()を使っているポリシーがあるか

3. TypeScript型の更新
   - types/supabase.ts の再生成が必要
   - `supabase gen types typescript` を実行

4. テストの追加
   ...

承認しますか？

これで「あ、RLSポリシー全部確認しないといけないんだ」と気づいてから実装できる。無計画に実装してマイグレーション失敗、というのを何度か経験してから毎回使うようになった。

サブエージェントで並列処理する

Claude Codeはタスクによって内部的にサブエージェントを使う。これを意図的に活用できる。

以下を並行してやってほしい：
1. src/components/以下の全コンポーネントの型エラーをリストアップ
2. api/以下のエンドポイントに対するテストカバレッジを調べる
3. package.jsonの依存関係で古くなっているものを確認

こう書くと、複数のエージェントが同時に動いて結果をまとめてくれる。1つずつ聞くより明らかに速い。

自分が実際に使うのはコードレビューのとき。

このPRを以下の観点で並行レビューしてほしい：
- セキュリティ（XSS, SQLインジェクション, 認証バイパス）
- パフォーマンス（N+1クエリ, 不要なレンダリング）
- 型安全性（anyの使用, 型アサーション）
- テスト漏れ

4つを同時に調べてまとめてくれる。フリーランスで一人で開発しているとレビュアーがいないので、これが実質的なコードレビューになっている。

データ分析タスクでの使い方

データ分析の案件をいくつかやってきたが、Claude Codeが一番活きるのはここだと思っている。

CSVを読ませて探索的分析をやらせる

sales_data.csvを分析してほしい。
まず構造を確認して、欠損値・外れ値・基本統計量を出してから、
売上に影響している変数を探ってほしい。
Pythonで実行可能なコードで出してくれ。

Claude Codeはファイルを読んで、実際にPythonコードを書いて、必要なら実行して、結果を解釈するところまでやってくれる。自分で最初からPandas書くのと比べて明らかに速い。

SQLクエリの最適化

-- このクエリが遅い。EXPLAINの結果も貼る
SELECT u.name, COUNT(o.id) as order_count, SUM(o.total) as revenue
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE o.created_at >= '2026-01-01'
GROUP BY u.id
ORDER BY revenue DESC;

EXPLAINの出力と一緒に貼ると、「このSeq Scanがボトルネック、このインデックスを追加せよ」と具体的に返してくれる。自分でEXPLAIN ANALYZEを読み解くより圧倒的に速い。

データパイプラインの設計

データ分析案件ではよくETLパイプラインを求められる。Claude Codeに渡す情報：

  1. データソース（DB、API、ファイル）
  2. 変換要件（正規化、集計、フィルタリング）
  3. 出力先（Redshift、BigQuery、Postgres）
  4. 実行頻度

これを伝えると、適切なツール選定（dbt vs Airflow vs シンプルなPythonスクリプト）の提案から実装まで一気にやってくれる。

MCPサーバーで外部ツールと繋ぐ

MCP（Model Context Protocol）を使うと、Claude Codeが外部ツールと直接連携できる。

~/.claude/claude_desktop_config.json（またはClaude Codeの設定）に以下を追加：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxx"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

GitHub MCPを使うと：

open PRsを全部確認して、レビューが2日以上止まっているものをリストアップしてくれ

これで実際にGitHubのAPIを叩いてPR一覧を取ってきて、作成日時から計算して返してくれる。毎朝やるルーティンをClaude Codeに任せるようになった。

Postgres MCPを使うと：

productionのDBのスキーマを確認しながら、
月次の売上レポートを出すクエリを書いてくれ

実際のスキーマを参照しながらクエリを書いてくれるので、カラム名の間違いがなくなった。

ホック（Hooks）で自動化する

Claude Codeにはhookの仕組みがある。~/.claude/settings.jsonに設定を書くと、特定のイベントで自動的にコマンドを実行できる。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npm run typecheck 2>&1 | tail -5"
          }
        ]
      }
    ]
  }
}

これを設定すると、Claudeがファイルを編集するたびに型チェックが自動で走る。型エラーが出たらClaude Codeが即座に気づいて修正しようとする。

自分が使っているもう一つの設定：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code finished\" with title \"Done\"'"
          }
        ]
      }
    ]
  }
}

Claudeが作業を終えたらMacの通知が来る。長い処理を投げて別のことをしているときに便利。

長期プロジェクトでのコンテキスト管理

Claude Codeは会話が長くなるとコンテキストが圧縮される。これを意識した使い方が必要。

セッション開始時のリセット

/clear

新しいタスクに入るときは必ずこれ。前の会話のゴミが残ると判断がぶれる。

重要な決定はCLAUDE.mdに残す

アーキテクチャの決定や「なぜこの実装にしたか」はCLAUDE.mdに書く。

## アーキテクチャ決定記録

### 2026-07-15: キャッシュ戦略
- Redisを使わずにReact Queryのキャッシュのみにしたのはインフラコスト削減のため
- 将来的にはvercel KVを検討

### 2026-07-20: 認証
- Supabase Authを使用。JWTはcookieに保存（httpOnly）
- NextAuth.jsは選ばなかった（Supabaseとの統合が複雑になるため）

こうしておくとセッションを新しく始めても、Claudeが過去の決定を把握してくれる。

フリーランス転身後に気づいたこと

SESから離れてフリーランスになったとき、最初にしんどかったのは事務作業だった。契約書、見積書、請求書、確定申告の準備——コードを書く以外のことが山積みになる。

ここでもClaude Codeを使っている。

フリーランス契約書テンプレートの作成

以下の条件でフリーランス 契約書 テンプレートを作ってほしい。
日本法準拠、業務委託（請負型）、
知的財産権は成果物の納品後にクライアントへ移転、
報酬は月末締め翌月末払い、
途中解約の場合は既納品分の費用は支払い済みとする。

実際に使えるレベルで書いてくれ。

返ってきたテンプレートをベースに、弁護士にレビューしてもらって使っている。ゼロから書くよりはるかに速い。ただし法的文書は必ず専門家に確認すること。Claudeは叩き台を作るのが仕事で、法的判断はしない。

見積書のロジックを組む

# Claude Codeに書いてもらった見積もり計算スクリプト
def calculate_estimate(
    base_hours: float,
    hourly_rate: int,
    complexity_factor: float = 1.0,
    buffer_ratio: float = 0.2
) -> dict:
    """
    工数見積もり計算
    buffer_ratio: リスクバッファ（デフォルト20%）
    """
    base_cost = base_hours * hourly_rate
    buffered_hours = base_hours * (1 + buffer_ratio)
    total_cost = buffered_hours * hourly_rate * complexity_factor
    
    return {
        "base_hours": base_hours,
        "buffered_hours": buffered_hours,
        "hourly_rate": hourly_rate,
        "total_cost": int(total_cost),
        "tax_10": int(total_cost * 1.1)
    }

# 使用例
result = calculate_estimate(
    base_hours=40,
    hourly_rate=10000,
    complexity_factor=1.2,  # 初めての技術スタックなので20%増
    buffer_ratio=0.25
)
print(f"合計（税抜）: ¥{result['total_cost']:,}")
print(f"合計（税込）: ¥{result['tax_10']:,}")

実際に失敗したこと

正直に書く。

失敗1: Claudeを信用しすぎてレビューしなかった

Claude Codeが生成したSQLマイグレーションをそのまま本番に流した。テーブルのロック時間の見積もりが甘くて、5分くらいサービスが重くなった。Claudeが「このマイグレーションは大丈夫」と言っても、本番適用前に自分でEXPLAIN ANALYZEするのは人間の仕事。

失敗2: コンテキストが汚染された状態で続けた

会話が長くなった状態でバグ修正を頼んだら、前の話題のコードを参照して全然関係ない修正をしてきた。長い会話は/clearでリセットするのが正解。

失敗3: 曖昧な指示で時間を無駄にした

「このAPIをよくして」という指示を出したら、パフォーマンス改善をやってきた。自分はエラーハンドリングを直してほしかった。Claudeへの指示は具体的に書く。「このAPIのエラーハンドリングを改善して。特にネットワークエラーとタイムアウトの処理が漏れている」のように。

SESがつらいと感じたときの選択肢としてのAI活用

SESつらいという声をよく聞く。客先常駐で自分の技術が伸びている感覚がない、単価が上がらない、案件を選べない——これは構造的な問題だ。

AIツールを使いこなすことが、そこからの出口になりうる。具体的には：

  1. 副業案件の質が上がる: Claude Codeを使うとSES稼働中でも週末の副業でそれなりのものが作れる。ポートフォリオが充実する。

  2. 技術的な差別化ができる: AI活用スキルは今後数年で標準になる前に習得しておいた方がいい。先行者利益はまだある。

  3. フリーランスへの移行準備: データ分析、バックエンド、フロントエンドのどのスキルセットでも、Claude Codeで生産性を上げておくと独立後の単価交渉で有利になる。

自分もSES期間中にClaude Code（当時はまだ初期バージョン）で副業案件を回して実績を作り、それを元にフリーランス転身の説得材料にした。

まとめ：明日から使えるTips一覧

Tip 効果 難易度
CLAUDE.mdを書く 毎回の説明が不要になる ★☆☆
/planモードを使う 実装前に問題に気づける ★☆☆
並行タスクを明示する 処理速度が上がる ★☆☆
MCPサーバーを繋ぐ 外部ツールとシームレスに ★★☆
Hooksを設定する 型チェック等が自動化 ★★☆
セッションをこまめにリセット コンテキスト汚染を防ぐ ★☆☆
EXPLAINの結果を一緒に貼る SQLチューニングの精度UP ★☆☆

Claude Codeは使い込むほどに返ってくる投資対効果が上がるツールだ。最初の1週間は設定に時間をかけて、その後は実際のプロジェクトで毎日触るのが一番の近道だった。

関連記事

AI駆動塾 — AIを使ったスモビジの作り方を学ぶ

Claude Code、OpenClaw、AI経営OSの実践ノウハウを毎週公開中。
月額¥4,980で過去記事すべて読み放題。

noteメンバーシップに参加する →

💼 フリーランスエンジニアの案件をお探しですか？

SES解体新書 フリーランスDBでは、高単価案件を多数掲載中です。

  • ✅ マージン率公開で透明な取引
  • ✅ AI/クラウド/Web系の厳選案件
  • ✅ 専任コーディネーターが単価交渉をサポート

▶ 無料でエンジニア登録する

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?