Claude Code × 経理業務｜freee会計API周りの調査下書きと人間確認の運用
目次 クリックで開く
freee会計をはじめとするクラウド会計SaaSの導入が進む一方で、実務担当者を悩ませ続けているのが「既存システムや独自スプレッドシートとのAPI連携」です。iPaaS（MakeやZapierなど）では対応しきれない複雑な配賦ロジックや、社内独自の基幹データとの突き合わせ、そして何より「AIが勝手に仕訳を送信してしまわないか」という不安が、自動化の壁となっています。
この課題に対し、Anthropicが提供するコーディングエージェント「Claude Code」は、単なるコード生成を超えた「実務の調査・下書き・検証」のパートナーとして極めて強力な力を発揮します。本記事では、Claude CodeをCLI（コマンドラインインターフェース）から操作し、freee会計APIを用いたセキュアで確実な連携基盤を構築する手法を解説します。
1. 経理DXのボトルネックをClaude Codeで突破する
経理実務におけるAPI連携が「構想」だけで終わってしまう最大の理由は、APIドキュメントの理解と、例外処理の多さにあります。例えば、freee会計APIで取引（deals）を登録する際、勘定科目ID、税区分コード、部門ID、タグIDなど、事前に取得・照合すべき項目が膨大に存在します。
Claude Codeは、開発者のローカルリポジトリに直接アクセスし、既存のコード、設定ファイル、そして読み込ませたドキュメントを「文脈」として理解します。これにより、従来のチャット型AIでは難しかった「うちの会社の勘定科目定義に基づいた、エラーの出ない連携スクリプトの作成」が可能になります。
特に重要なのは、Claude Codeに「完璧な自動化」ではなく「人間が確認するための高度な下書き」を作らせることです。仕訳データを飛ばす前に、その内容を人間がレビューできる形式（Markdownやスプレッドシート）で出力する工程をClaude Codeに担当させることで、セキュリティと心理的安全性を担保します。
2. Claude Code × freee API連携のリポジトリ設計と設定
Claude Codeを効果的に動かすためには、リポジトリ構成を「AIが読み取りやすい形」に整える必要があります。具体的には、プロジェクトのルートに CLAUDE.md を配置し、Claude Codeが守るべきルールや参照すべき情報を定義します。
リポジトリの推奨構成
/docs/api_spec/: freee APIの仕様（公式からダウンロードしたOpenAPI JSONやリファレンスのMarkdown）。/config/master/: 自社の勘定科目、部門、タグの一覧（JSON形式）。/scripts/: Claude Codeが生成する実行スクリプト（Python/Node.jsなど）。CLAUDE.md: プロジェクト全体の指示書。AGENTS.md: 特定のタスク（例：月次仕訳チェック）に特化したサブエージェントへの指示。
CLAUDE.md の記述例
Claude Codeはこのファイルを読み取って自身の挙動を制御します。ここに「freee会計のAPI仕様を遵守すること」「秘密鍵は .env から読み込み、コード内に直接書かないこと」「必ず dry-run モードを実装すること」といった制約を記述します。
# Project: freee-api-integration
Rules
Always use environment variables for CLIENT_ID, CLIENT_SECRET, and REFRESH_TOKEN.
Reference docs/api_spec/freee_accounting_api.json for endpoint structures.
Implement a '--dry-run' flag in all scripts to output target data in JSON format before actual API calls.
All financial numbers must be handled as integers to avoid floating-point errors.
3. 実践：Claude CodeによるAPI連携スクリプトの生成フロー
環境が整ったら、CLIから Claude Codeを起動します。ここでのポイントは、指示を細分化し、段階的に「下書き」を構築させることです。
ステップ1：APIドキュメントの解析と型定義の作成
まず、docs/api_spec/ に配置したfreeeのOpenAPIファイルを読み取らせ、スクリプトで利用するための型定義や定数を作成させます。
「docsの下にあるfreeeのAPI仕様を確認して、取引（deals）の作成に必要なリクエストボディのTypeScript型定義ファイルを作って。また、主要な勘定科目IDをconfigから読み取って列挙型にして」
ステップ2：認証・認可（OAuth2.0）の実装
freee APIはアクセストークンの有効期限が短いため、リフレッシュトークンによる更新処理が必須です。Claude Codeにこのロジックを実装させます。Claude Codeはファイル編集能力（edit_file）とターミナル実行能力（run_terminal_command）を持っているため、実際に curl などで導通確認を行いながらコードをブラッシュアップできます。
ステップ3：エラーハンドリングの組み込み
Claude Codeの強みは、過去の実行ログ（エラーメッセージ）を読み取らせて修正案を出させることにあります。例えば、「リクエストした勘定科目コードが存在しない」というエラーが出た場合、Claude Codeはそのログを解析し、「APIを叩く前にローカルのマスターと照合するチェック関数」を自動的にスクリプトに追加してくれます。
4. 「人間確認」を前提とした安全な実行・承認フローの構築
会計データにおいて、AIによる「全自動」はリスクです。Claude Codeを活用して、以下のような「承認ステップ」をコード内に組み込みます。
Dry-run とプレビュー出力
スクリプトを実行すると、実際のAPI送信を行う代わりに、送信予定のデータをテーブル形式のMarkdownファイル（proposed_deals.md）として出力させます。Claude Codeに対し、「このMarkdownを読んで、重複や異常値がないかエージェントの視点でチェックして」と依頼することも可能です。
Claude Codeによる「人間への質問」
複雑な配賦ロジックで迷った際、Claude Codeは自ら判断を下さず、開発者に質問を投げます。
「この行の部門IDが特定できません。マスタに従って『共通部門』に割り当てますか？それともスキップしますか？」
このやり取りの結果をスクリプトの条件分岐として反映させることで、実務に即した精度の高いコードが完成します。
5. freee会計API活用における比較と選定基準
API連携の実装手段は、Claude Codeによる自作以外にも存在します。用途に合わせて適切なツールを選択してください。
| 手法 | メリット | デメリット | 適したシーン |
|---|---|---|---|
| iPaaS (Make/Zapier) | ノーコードでUIが直感的。メンテナンスが視覚的。 | 複雑なループ処理やデータ変換が苦手。実行回数で課金が増える。 | シンプルな1対1のデータ同期。 |
| Claude Code + 自作スクリプト | 柔軟性が無限。複雑な経理ロジックを安価に実装可能。 | スクリプトを実行する環境（GitHub Actions等）の構築が必要。 | 大量データのバッチ処理、複雑な配賦・計算を伴う連携。 |
| freee標準連携アプリ | 設定のみで即利用可能。公式サポートがある。 | カスタマイズがほぼ不可能。自社の独自ルールを反映できない。 | 汎用的なSaaS（Slack, Shopify等）との連携。 |
freee会計API活用シナリオ別 Claude Code実装パターン × 人間確認ポイント × 想定初期構築工数 早見表
前のセクションで安全な実行・承認フローの構築方法を説明しましたが、「どのシナリオでClaude Codeを使うか」によって実装パターンと必要な承認ステップが変わります。全自動で実行すべきシナリオと、必ず人間が確認してから実行すべきシナリオを混同すると、経理処理のミスや監査への影響が生じます。以下の表はfreee会計API活用シナリオ別の設計指針をまとめたものです。
| 活用シナリオ | Claude Codeの役割 | 推奨実装パターン | 人間確認ポイント | 初期構築の想定工数 |
|---|---|---|---|---|
| 銀行明細の自動仕訳提案 （取引の勘定科目マッピング） |
freee会計APIで取得した銀行明細テキストから、過去の仕訳パターンを参照して勘定科目・補助科目・メモ欄の提案文を生成する | Claude Codeがfreee APIから明細を取得→仕訳提案を生成→確認用スプレッドシートに出力→経理担当者がレビュー→承認後にfreee APIでPOSTする「提案+承認後自動入力」パターンが最も安全 | ①提案された勘定科目と金額の整合性。②新規取引先や過去にない仕訳パターン。③消費税率の判定（課税・非課税・免税の選択）。金額が大きい取引（10万円以上等）は必ず二重確認 | 5〜10日（freee APIのOAuth設定2日＋仕訳提案ロジックの設計3日＋確認用UIまたはスプレッドシート出力設計2〜3日） |
| 請求書データの自動取込 （PDF・メール→freee仕訳） |
メールやフォルダに届いたPDF請求書からClaude Codeでテキストを抽出→取引先・金額・日付・明細を構造化→freee会計の取引として登録するデータを生成する | 「抽出→構造化→プレビュー表示→確認→登録」の5ステップが安全設計の基本。PDF内の金額認識ミスを防ぐため、Claude Codeの抽出結果と元PDFの数値を目視比較できるプレビュー表示は必須 | ①元PDFと抽出金額の一致確認。②インボイス登録番号の存在確認（仕入税額控除の可否）。③複数税率混在請求書の税額計算の正確性。④取引先名とfreee上の取引先マスタの一致 | 10〜15日（PDF解析ロジック3日＋freee取引先マスタ照合設計3日＋プレビューUI設計4〜5日＋テスト2日） |
| 月次締め作業の進捗管理 （未処理明細のリストアップ） |
freee会計APIで当月の未仕訳明細・未登録取引・承認待ち経費精算をリストアップして、月次締め作業の残タスクサマリーを毎朝自動生成する | 読み取り専用APIのGETリクエストのみを使うため、freee上のデータ変更リスクがない。Claude Codeがサマリーを生成して経理担当者のSlack/メールに通知するだけで完結する最もリスクの低い活用パターン | ①月次締め期限に対する残作業量の妥当性。②急増している未処理明細の原因確認（新規取引先の増加・仕訳ルールの抜け等）。このシナリオは基本的に通知のみで直接の人間介入は軽微 | 3〜5日（APIからのデータ取得設計2日＋Slackまたはメール通知設計1〜2日＋フォーマット調整1日） |
| freee上のデータ品質チェック （仕訳の整合性検証） |
freee会計APIで仕訳データを取得して、勘定科目の使い方の誤り・消費税区分の不一致・補助科目の入力抜けをClaude Codeで検出してレポートを生成する | GETのみを使う読み取り専用の分析ツールとして実装する。検出された問題リストをレポートとして出力して、修正は経理担当者がfreee画面上で手動実施するか確認済みのスクリプトで一括修正する | ①指摘された仕訳異常の修正要否の判断（意図的な例外処理か本当のミスか）。②修正前後の貸借バランスへの影響確認。大量一括修正の場合は必ずバックアップを取ってから実施 | 5〜8日（検証ルール定義設計3日＋APIからのデータ取得設計2日＋レポート出力設計2〜3日） |
この表で最初に着手するシナリオとして最も推奨されるのが「月次締め作業の進捗管理（未処理明細リストアップ）」です。読み取り専用APIのみを使うため、freee上のデータを誤って書き換えるリスクがゼロで、初期構築工数も3〜5日と短いです。「今日の締め作業残タスクが毎朝Slackに届く」だけで経理担当者の朝の確認工数が削減され、Claude Code活用の最初の成功体験として組織内での信頼を築きやすいシナリオです。
6. まとめ：Claude Codeを「経理のIT右腕」にするための運用ルール
Claude Codeを使ったfreee API連携は、開発スピードを劇的に向上させますが、それを継続的に運用するためには、エンジニアではない経理担当者との役割分担が重要です。
- エンジニア（またはIT担当者）: Claude Codeを使い、リポジトリの
CLAUDE.mdを更新し、スクリプトの骨組みをメンテナンスする。 - 経理担当者:
config/master/内のJSONファイルやCSVファイルを更新し、AIが参照する「正解データ」を常に最新に保つ。 - 共通フロー: 実行前に必ず
proposed_deals.mdなどの中間生成物を確認し、双方が合意してから本番実行（またはプルリクエストの承認）を行う。
AIエージェントを「ただのコード生成ツール」としてではなく、「ドキュメントと実務の溝を埋める調査担当」として位置づけること。これこそが、Claude Code時代の新しいバックオフィスDXの姿です。まずは、現在手動で行っているCSV変換作業の「下書き」を、Claude Codeに依頼するところから始めてみてください。
Claude CodeによるfreeeのAPI連携スクリプトが完成したら、本番運用に向けてどのAPIスコープを付与するか・dry-run承認フローをどう設計するか・操作ログをどこに保持するかが次の設計課題になります。freee APIをAIに安全につなぐためのセキュア記帳基盤として RuleHub も参考にしてください。freee API連携の設計やPoC全体の進め方は Claude Code 導入支援 でもご相談いただけます。
よくある質問（FAQ）
Q. Claude Codeを経理業務で使う際のセキュリティ・データ管理はどう考えればよいですか？
最も重要な原則は「本番の財務データをClaudeに直接貼り付けない」ことです。仕訳帳・試算表等の実データを含む内容を貼り付けると、そのデータが入力として処理されます。代わりに①サンプルデータ・匿名化データで操作を確認してから本番に適用する、②Claude CodeのPermission設定で読み書き可能なディレクトリを限定する、③会計システムのAPIトークンをMCPサーバー経由で管理しClaude本体に渡さない、の3点を徹底してください。RuleHubのような実装例では権限の読み取り専用制限も有効な対策です。
Q. Claude Codeで経理業務を自動化する具体的な例を教えてください。
実際の活用例：①Excelの銀行明細CSVを読み込んで勘定科目の自動仕分け提案を生成、②freee/マネーフォワードのAPIを使った残高照合スクリプトの作成、③請求書PDF（OCR済テキスト）から仕訳データをCSV形式に変換、④月次試算表データから前月比・前年同月比を計算してサマリーレポートを生成。これらはClaude Codeに「こんなスクリプトを作ってほしい」と依頼するだけで実装できます。
Q. 経理担当者がプログラミング知識なしでClaude Codeを使うことはできますか？
Claude Code自体はCLI（コマンドライン）ツールのため、最低限のターミナル操作（コマンド実行）の習慣が必要です。完全にノーコードとは言えませんが、プログラミング経験がなくても「日本語で作りたいものを説明する→Claudeがコードを書く→実行する」という流れで業務自動化ができます。導入時に社内のIT担当者やAurantのような支援会社と協力して初期セットアップを行い、経理担当者が安全に使えるテンプレート・手順書を整備することを推奨します。
経理・会計DXと仕訳／請求／債権自動化のご相談
仕訳・請求・入金消込・債権管理といった経理業務の自動化と、会計データの可視化までを一気通貫で支援します。ツール選定や既存運用の見直しについて、導入前後のセカンドオピニオンとしてもご相談いただけます。