Claude CodeでAIエージェント型CRMを設計する方法

Claude CodeでCRM業務を効率化する際に重要なのは、AIへ顧客管理を丸ごと任せることではありません。まず顧客情報の正本を決め、Claude Codeが安全に参照できる操作経路を用意することです。

Claude Codeは、Anthropicが提供するエージェント型コーディングツールです。ターミナルや開発環境からファイル編集、コマンド実行、コード調査などを行えます。この性質を利用すると、CRM APIや社内CLIと接続し、情報検索、要約、タスク候補の抽出、レポート作成を支援できます。

一方で、顧客情報には個人情報、商談内容、契約情報などが含まれます。設計を誤ると、過剰なデータ取得や意図しない更新につながります。本記事では、特定企業の顧客データや非公開運用を使わず、一般的な企業システムを前提に安全な設計手順を解説します。

Claude Code CRMとは

「Claude Code CRM」は特定の製品名ではありません。本記事では、既存のCRMやデータベースに対して、Claude Codeから自然言語で検索・分析・更新支援を行う仕組みを指します。

構成は大きく4層に分けると整理しやすくなります。

層	主な役割	例
データソース層	顧客・商談・活動情報を保持	CRM、SFA、メール、カレンダー
統合・API層	データ形式と権限を統一	REST API、社内CLI、ETL
エージェント層	検索、要約、判断支援	Claude Code、専用コマンド
人間の承認層	重要操作を確認・承認	更新確認、監査ログ、管理画面

この構造のポイントは、Claude Codeが各サービスへ無制限に直接接続しないことです。操作をAPIや社内CLIへ集約すれば、許可する処理、取得する項目、記録するログを制御できます。

実務でのポイント最初から自動更新を目指さず、「検索と要約だけ」に限定した読み取り専用の試験導入から始めてください。

最初に決めるべき「顧客情報の正本」

AIエージェントを導入する前に、顧客情報の正本、つまりSSoT（Single Source of Truth）を決めます。同じ会社名や担当者情報が複数ツールに存在すると、AIはどれを信頼すべきか判断できません。

最低限、次の項目ごとに正本を指定します。

情報	正本の例	更新責任者の例
企業・担当者	CRM	営業担当
商談ステージ	SFA	案件オーナー
次回アクション	タスク管理	担当者本人
契約状態	契約管理	管理部門
請求状態	会計システム	経理担当
対応履歴	CRMの活動ログ	対応した担当者

メールやチャットをすべてCRMへ複製する必要はありません。CRM側には日時、担当者、要約、元データへの参照IDなど、業務判断に必要な最小限の情報だけを保存する方法があります。

本文データを必要以上に複製しなければ、アクセス権の管理対象を減らせます。また、元サービス側の保持期間や削除ルールも適用しやすくなります。

データモデルは顧客・商談・活動・タスクを分ける

AIが扱いやすいCRMにするには、1つの巨大な顧客テーブルへすべてを詰め込まないことが重要です。基本的には、次のように役割を分離します。

エンティティ	保持する情報
companies	企業名、業種、企業属性
contacts	担当者、所属、連絡先
deals	商談金額、ステージ、予定日、案件責任者
activities	面談、メール、電話などの活動記録
tasks	次回対応、期限、担当者、完了状態
documents	提案書や契約書の参照情報

商談ステージと契約後の支援ステータスも分けるべきです。「提案中」「受注」「支援中」「請求済み」を1つの列で管理すると、営業と提供業務の意味が混在します。

たとえば、営業パイプラインは「新規→商談設定→提案→受注・失注」、契約後は「準備中→進行中→完了」のように別々に管理します。Claude Codeへ質問するときも、「提案が止まっている案件」と「支援の次回予定が未登録の顧客」を区別できます。

Claude Codeからは社内CLIを経由させる

Claude CodeとCRMを接続する方法として、用途を限定した社内CLIを用意する設計があります。CLIは、ターミナル上のコマンドでシステムを操作する仕組みです。

たとえば、次のような読み取りコマンドを用意します。

crm company show <company_id>crm deal list --stage proposalcrm task list --due todaycrm activity summarize <company_id> --days 30

Claude Codeには「今日が期限のタスクを整理し、対応順の案を作る」と依頼できます。Claude CodeはCLIの結果を読み、優先順位の案や確認事項を文章にまとめます。

更新コマンドは分離し、明示的な確認を必須にします。

crm task create --company <company_id> --due <date> --dry-runcrm task create --company <company_id> --due <date> --confirm

--dry-runでは変更予定だけを表示し、--confirmがある場合のみ反映する設計です。生成AIが誤った対象や日付を選んでも、人間が実行前に確認できます。

---

Claude Codeを含むAIエージェントの導入範囲や権限設計を整理したい方は、株式会社NexaのAI顧問サービスへご相談ください。

AI活用の無料相談はこちら →

---

権限管理は「最小権限」と「行単位制御」で設計する

CRM連携では、APIキーを設定して終わりにしてはいけません。営業担当、管理者、経理担当では、閲覧・更新できる範囲が異なります。

PostgreSQL系の基盤では、RLS（Row Level Security）を使って、行単位でアクセスを制御できます。たとえば「担当案件だけ閲覧可能」「管理者だけ契約情報を閲覧可能」といったポリシーを設定します。

Claude Code側でも、用途ごとに認証情報を分けます。

• 検索・要約用: 読み取り専用
• タスク候補作成用: 下書き作成のみ
• 確定更新用: 人間の承認を要求
• 管理操作用: AIエージェントへ付与しない

また、取得対象の列も絞ります。分析に不要な個人情報や機密項目は、APIレスポンスへ含めない設計が望まれます。

プロンプトより先に監査ログを整える

AIエージェントの品質はプロンプトだけでは管理できません。誰が、いつ、何を読み、どの操作を提案し、何が実行されたかを追跡できるようにします。

最低限、次の情報を記録します。

• 実行ユーザー
• 実行日時
• 使用したコマンド
• 参照した企業ID・案件ID
• 変更前後の値
• 承認者
• 成功・失敗の結果

監査ログには、顧客情報の本文をそのまま残さないことも重要です。対象ID、操作種別、結果など、検証に必要なメタデータを中心に記録します。

失敗時の動作も決めます。APIエラーや曖昧な顧客名が発生した場合は、推測で処理せず停止し、人間へ候補を提示する設計にします。

4段階で導入すればリスクを抑えられる

Claude Code CRMは段階的に導入します。

フェーズ1：読み取り専用で検索する

顧客、商談、タスクを検索し、一覧や要約を作ります。既存データは変更しません。

評価指標は、検索時間の短縮、回答の正確性、権限外データが表示されないことです。

フェーズ2：レポートを下書きする

週次の商談状況、期限超過タスク、更新が止まっている案件などを抽出します。出力は下書きに留め、人間が確認します。

フェーズ3：更新候補を作る

タスク、活動要約、次回アクションなどの更新案を作成します。必ず差分と根拠を表示し、承認後に反映します。

フェーズ4：限定的に自動実行する

対象と条件が明確な処理だけを自動化します。たとえば「期限超過タスクを毎朝一覧化する」のような、可逆性が高く影響範囲が限定された処理です。

契約変更、顧客への連絡、削除、金額更新などの高リスク操作は、人間の承認を残します。

導入前に確認するチェックリスト

確認項目	完了条件
正本	情報項目ごとの正本が決まっている
データ構造	顧客・商談・活動・タスクが分離されている
権限	読み取りと更新の権限が分かれている
個人情報	不要な項目をAPIから除外している
承認	重要更新にdry-runと人間承認がある
監査	実行者・対象・変更内容を追跡できる
障害対応	曖昧な入力やAPIエラー時に停止する
評価	正確性、時間削減、誤更新件数を測定する

このチェックリストを満たさない状態で、書き込み権限を持つAIエージェントを本番導入するのは避けてください。

よくある質問

Q. Claude Codeは既存CRMを置き換えますか？

置き換える必要はありません。既存CRMを正本として残し、Claude Codeを検索、要約、更新支援のインターフェースとして利用できます。既存製品のAPIや社内CLIを経由させる構成が現実的です。

Q. 顧客情報をClaude Codeに扱わせても安全ですか？

安全性は設計と運用に依存します。読み取り専用から始め、最小権限、列・行単位のアクセス制御、監査ログ、人間承認を組み合わせてください。機密情報を必要以上に取得しないことも重要です。

Q. 最初に自動化しやすい業務は何ですか？

期限タスクの一覧化、商談情報の要約、更新が止まっている案件の検出など、読み取り中心で結果を人間が確認できる業務です。外部送信や削除は後回しにします。

まとめ

Claude Code CRMを設計するときは、AIの性能よりも先に、顧客情報の正本、データモデル、操作経路、権限、監査を整える必要があります。

実務では、既存CRMを維持し、社内CLIやAPIを介してClaude Codeへ必要最小限の情報だけを渡します。導入は読み取り、レポート下書き、承認付き更新、限定的な自動実行の順で進めると、誤更新や情報漏えいのリスクを抑えられます。

まずは、自社の顧客情報がどこに保存され、誰が更新し、どの業務で参照されているかを一覧化してください。それがAIエージェント型CRMの設計を始める第一歩です。

---

AIエージェント型CRMの導入設計を相談できます

株式会社Nexaでは、既存のCRMや業務システムを活かしたAIエージェント導入を支援しています。データ整理、権限設計、段階的な検証計画からご相談いただけます。

AI活用の無料相談はこちら →

---

参考ソース

• Anthropic公式：Claude Code overview
• Supabase公式：Row Level Security