【事例】サポートナレッジをGitで管理しClaude Codeで更新するまで

カスタマーサポートの現場において、情報の鮮度を保つことは最大の課題です。新機能のリリースや仕様変更のたびに、Notionやesa、Zendesk内の記事を手作業で修正する運用は、サービスが成長するほど限界を迎えます。そこで今、エンジニアリングのベストプラクティスをドキュメント管理に持ち込む「Document as Code（コードとしてのドキュメント）」と、最新のAIエージェント「Claude Code」を組み合わせた運用が注目されています。

本記事では、サポートナレッジをGitレポジトリで管理し、Claude Codeを用いて半自動で更新・メンテナンスする仕組みの構築方法を、実務レベルで具体的に解説します。

なぜサポートナレッジをGitで管理するのか？

多くの企業がWikiツールや専用のSaaSを利用する中で、あえてGit（GitHubやGitLabなど）でナレッジを管理する理由は、AIとの親和性にあります。

Wikiツールの限界と「Document as Code」の親和性

一般的なWikiツールは、人間がUI上で編集するには適していますが、以下の点で課題が生じます。

• 変更履歴の追跡性: 「誰が」「いつ」「どの箇所の文言を」変えたのかの厳密な差分（diff）が見にくい。
• 一括変換の難しさ: サービス名や用語が変更になった際、100記事を一度に置換するような操作が困難。
• AIエージェントのアクセス: API経由での取得が必要になり、AIがファイルシステムとして直接読み書きするのに不向き。

これに対し、Markdown形式でGit管理（Document as Code）を行うことで、ドキュメントは「構造化されたテキストデータ」となり、プログラムやAIによる高速な処理が可能になります。

Claude Codeによる爆速更新が可能になる理由

Anthropicが提供を開始した「Claude Code」は、端末のローカル環境やレポジトリを直接理解するCLIツールです。従来のWeb型AIと異なり、ファイル構造を自ら探索し、複数のファイルを横断して修正案を提示・適用できます。これにより、「仕様書のMarkdownを読み取り、関連するFAQページをすべて最新化する」といった高度なタスクがコマンド一つで完結します。

社内のインフラ管理についても同様の考え方が適用できます。例えば、SaaSコストとオンプレ負債を断つ。バックオフィス＆インフラの「標的」と現実的剥がし方で述べられているような複雑なシステム構成図や運用手順も、コードに近い形式で管理することで、AIによる改善提案を受けやすくなります。

ナレッジベースをGit×Markdownで構築する設計

Claude Codeの性能を最大限に引き出すためには、AIが読みやすい「整理されたレポジトリ構成」が不可欠です。

推奨されるディレクトリ構成とファイル命名規則

サポートナレッジの場合、以下のような構成が実務的です。

knowledge-base/
├── .claudeignore        # Claude Codeに読み込ませないファイルを指定
├── docs/
│   ├── internal/        # 社内向け運用手順
│   └── public/          # 公開用FAQ（最終的にZendesk等へ同期）
├── templates/           # 記事作成用のテンプレート
└── metadata/            # カテゴリー定義や用語集（JSON/YAML）

ファイル名は how-to-reset-password.md のように、中身が推測できるケバブケースを推奨します。AIはファイル名からも文脈を読み取るためです。

メタデータ（Front Matter）の活用による管理の高度化

Markdownファイルの冒頭に、YAML形式でメタデータを記述します。

title: パスワードのリセット方法 last_updated: 2026-04-15 status: published target_audience: user

このメタデータがあることで、Claude Codeに対して「statusがpublishedのファイルの中から、特定の内容を修正して」といった条件付きの命令が出しやすくなります。

Claude Codeの導入と初期設定

Claude Codeを利用するには、Node.js環境とAnthropicのAPIキーが必要です。なお、仕様や料金については、必ずAnthropic公式ドキュメントを確認してください。

インストールと認証の手順

ターミナルで以下のコマンドを実行し、インストールを行います。

npm install -g @anthropic-ai/claude-code

初回起動時に claude コマンドを叩くと、ブラウザ経由での認証を求められます。API使用料は、通常のClaude API（Claude 3.5 Sonnet等）の利用枠に基づいて従量課金されます。

セキュリティを担保する「.claudeignore」の設定

AIに機密情報を送信しないよう、レポジトリのルートに .claudeignore を作成します。ここには .env ファイルや、個人情報が含まれる可能性のあるログファイル、一時フォルダを指定します。これは .gitignore と同様の書式で記述可能です。

【実践】Claude Codeでナレッジを更新する具体的フロー

それでは、実際にナレッジを更新する手順を解説します。

ステップ1：現状分析と差分の抽出

まず、元となる情報をレポジトリ内に配置します。例えば「新機能：2段階認証の導入」という仕様書（spec.md）を置いた状態で、Claude Codeを起動します。

ステップ2：Claude Codeへの自然言語による更新指示

Claude Codeのインタラクティブ・シェルで以下のように指示を出します。

「docs/public/ 内にあるログイン関連のFAQを確認して。新機能の2段階認証（spec.md参照）の影響を受ける箇所をすべて特定し、Markdownファイルを最新の仕様に合わせて修正して。変更内容は日本のユーザー向けに丁寧なですます調で記述すること。」

Claude Codeは自律的にファイルをスキャンし、影響箇所をリストアップした後、エディタを開くことなく直接ファイルを書き換えます。

ステップ3：レビューとプルリクエストの作成

AIによる修正が終わったら、人間が git diff で内容を確認します。問題なければ、そのままブランチを作成しプルリクエストを出します。

git checkout -b feature/update-2fa-docs
git add .
git commit -m "Claude Code: 2段階認証導入に伴うFAQの更新"
git push origin feature/update-2fa-docs

このようなワークフローは、非エンジニア部門でもGitHubのデスクトップアプリ等を使えば運用可能です。業務全体の自動化については、Excelと紙の限界を突破する「Google Workspace × AppSheet」業務DX完全ガイドで紹介されているような、ノーコードツールとの連携も検討の余地があります。

既存のナレッジ管理手法との比較

従来のSaaS管理と、今回紹介するGit×Claude Codeの手法を比較表にまとめました。

大規模な組織では、これらを完全に切り替えるのではなく、Gitでマスターデータ（Single Source of Truth）を管理し、そこからGitHub Actions等でZendesk等へAPI経由で同期する構成が最も効率的です。

運用上の注意点とよくあるトラブル

ハルシネーション（誤情報）への対処

Claude Codeは非常に優秀ですが、存在しないUIの操作手順を「もっともらしく」生成することがあります。これを防ぐためには、指示を出す際に「不明な点は推測せず、質問すること」という制約を明示するか、社内の用語集を常に参照させる設定が必要です。

Git操作に不慣れなメンバーへのフォロー

カスタマーサポートのメンバー全員にGitを強いるのは現実的ではありません。AIが作成したプルリクエストをエンジニアやリーダーが確認し、マージされたら自動的にWebツールへ反映される「一方通行の同期システム」を構築することで、現場の負荷を抑えつつ品質を高めることができます。

特に経理や人事など、他部署とのデータ連携を伴う場合は、楽楽精算×freee会計の「CSV手作業」を滅ぼす。経理の完全自動化とアーキテクチャで解説しているような、ツール間のデータ責務の明確化が成功の鍵となります。

まとめ：AI時代のナレッジマネジメントへ

サポートナレッジを「ドキュメント」ではなく「コード」として扱うことで、AIのポテンシャルを最大限に活用できるようになります。Claude Codeという強力なエージェントを仲間に加えることで、情報のメンテナンスに追われる日々から解放され、よりクリエイティブな顧客体験の設計に時間を割くことが可能になるでしょう。

まずは、一部の技術的なFAQからMarkdown化とGit管理を試し、Claude Codeによる更新のスピード感を体感してみてください。