マイナンバー 確定申告 自動化｜Claude Code／Codex でゼロ入力を実現する方法
aikanri-admin税務・申告業務の担当者へ
マイナンバー連携の確定申告、
まだ手作業で書き写していませんか？
マイナポータル連携×Claude Code／Codexを組み合わせると、源泉徴収票・各種控除証明書の取得から申告書作成まで自動化できます。このガイドで全手順を解説します。
📋 この記事でわかること
- マイナンバー連携確定申告の仕組みと課題
- マイナポータルAPIから証明書データを自動取得する手順
- Claude Code／Codexで申告書の自動作成・e-Tax送信を実現する方法
- AI鬼管理を導入した士業事務所の活用事例
- 独学では越えられない壁と、AI鬼管理が解決する理由
マイナンバーと確定申告の連携基礎知識
2024年から「マイナポータル連携」が本格稼働し、給与所得者の確定申告は大幅に変わりました。源泉徴収票・生命保険料控除証明書・国民年金保険料控除証明書などが、マイナポータル経由で自動取得できるようになったのです。
📚 用語解説
マイナポータル連携：マイナンバーカードを使ってマイナポータルにログインし、各種控除証明書・源泉徴収票データを電子的に取得してe-Taxへ直接インポートする仕組み。書類の郵送や手入力が不要になる。
勤務先がデータ提出 → 自動取得
保険会社が電子送付
日本年金機構から自動連携
寄付金受領証が電子化
しかし、これで「ゼロ作業」になったわけではありません。マイナポータルから取得できるのはデータのみ。それを申告書に正しく反映させ、副業・不動産所得・医療費控除など個別の計算を行うには、依然として専門知識と手作業が残ります。
マイナポータルで書類を取得できるようになったけど、申告書への転記とか計算とかは結局手動なんですよね…
そこをClaude Code／Codexが補います。APIでデータを受け取り、申告書XMLを自動生成してe-Taxへ送信するまで一気に自動化できます。
確定申告の手作業・何が問題なのか
税理士事務所や経理担当者が確定申告で抱える主な課題は3つです。これらを整理してから、AI活用のアプローチを考えます。
📚 用語解説
e-Tax（電子申告）：国税庁のオンラインシステムで確定申告書を電子的に提出できるサービス。マイナンバーカードのICチップ読取やID・パスワードで認証する。
| 課題 | 具体的な内容 | 工数の目安 |
|---|---|---|
| 書類収集 | 各顧客から源泉・控除証明書を収集・確認 | 1件あたり20〜40分 |
| データ入力 | 申告ソフトへの転記・控除計算 | 1件あたり30〜90分 |
| 確認・提出 | チェック・署名・e-Tax送信 | 1件あたり15〜30分 |
100件の申告を抱えた事務所では、書類収集だけで50〜70時間かかる計算です。繁忙期（1〜3月）に集中するため、残業・休日出勤が常態化します。
AI鬼管理では、マイナポータルAPIと連携して書類を自動収集し、控除計算・申告書XML生成・e-Tax送信を自動化することで、1件あたりの工数を5〜10分に圧縮した事例があります。
マイナポータルAPIの活用と自動データ取得
マイナポータルAPIを使うと、マイナンバーカードで本人認証した上で各種控除証明書データを取得できます。取得したXMLデータをそのままe-Taxの申告書に埋め込めるため、転記ミスがゼロになります。
📚 用語解説
マイナポータルAPI：デジタル庁が提供するAPI。マイナンバーカードで認証した利用者の各種行政データ（控除証明書・年金記録・医療費通知など）をプログラムから取得できる。OAuth 2.0ベースの認可フロー。
認証フローはOAuth 2.0に準拠しており、事務所側のシステムからリダイレクトURLを設定してアクセストークンを受け取る実装が一般的です。このフローをClaude Code／Codexが生成したコードで自動化します。
APIの実装って難しそうで、税理士事務所では難しいのでは？
AI鬼管理ではAPI連携のコードをClaude Code／Codexが書いてくれます。「マイナポータルからデータを取得して控除証明書XMLを保存するPythonスクリプトを書いて」と指示するだけで動くコードが生成されます。
確定申告自動化フロー設計：ゼロ入力を実現する全体像
マイナンバー連携を最大限活用した確定申告自動化の全体フローを解説します。各ステップでClaude Code／Codexが担う役割も明記します。
📚 用語解説
XMLスキーマ：e-Taxで使用される申告書データの形式定義。確定申告書B・所得税申告書のXMLファイルは国税庁が仕様を公開している。正確なスキーマに合わせてデータを生成する必要がある。
特に重要なのはステップ5。AI鬼管理では「AIが計算し、税理士が最終確認する」という分業を徹底することで、税務上の責任の所在を明確に保ちながら工数を削減します。
freee・弥生との連携で確定申告データを自動連携する
確定申告自動化をさらに進めるには、普段使いの会計ソフト（freee・弥生会計）との連携が鍵です。年間の仕訳データが既に入っているため、それを申告書に引き継ぐだけで大幅に効率化できます。
📚 用語解説
freee API：freee会計・freee人事労務のデータをプログラムから操作できるREST API。勘定科目・仕訳・レポートデータの取得が可能で、申告書作成ツールと連携できる。
| 会計ソフト | API連携の方法 | 申告書へのデータ連携 |
|---|---|---|
| freee | OAuth2でアクセストークン取得後、仕訳APIで損益データ取得 | 所得・経費の集計をXMLに変換 |
| 弥生 | スモールビジネス向けAPIで残高試算表取得 | CSV出力→Pythonで解析→申告書マッピング |
| マネーフォワード | クラウド会計APIで損益計算書データ取得 | JSON→申告書XML変換 |
Claude Code／Codexを使えば、「freeeのAPIから昨年分の損益データを取得してe-Tax申告書XMLを生成するPythonスクリプトを書いて」と指示するだけで動くコードが生成されます。Pythonの知識がなくても、AI鬼管理のガイダンスに沿って実装できます。
うちはfreeeを使っているので、直接APIで連携できるなら大幅に楽になりそうです。
freeeは特に連携しやすいです。AIで仕訳APIの呼び出しコードを生成し、損益データ→申告書XMLの変換ロジックも自動作成できます。AI鬼管理ではこのコード生成から動作確認までをトータルサポートします。
Claude Code／Codex で確定申告自動化を実装する
ここからが本題です。Claude Code／Codexを使って、マイナンバー連携確定申告の自動化コードを実装する方法を解説します。非エンジニアでもコマンドラインとAIがあれば実現可能です。
📚 用語解説
Claude Code：Anthropic社が開発したAIコーディングアシスタント。ターミナル上で自然言語の指示を入力すると、ファイル操作・コード生成・テスト実行まで自律的に行う。
> マイナポータルAPIから確定申告用の控除証明書XMLをダウンロードするPythonスクリプトを書いて。認証はOAuth2。
> 取得したXMLから生命保険料控除額・国民年金控除額を抽出して申告書B第一表の該当欄に自動マッピングするコードを書いて。
> freee APIから昨年の損益データを取得して、e-Tax申告書XMLに変換するスクリプトを書いて。所得区分は事業所得と給与所得。
これらの指示をClaude Code／Codexに入力すると、数分以内に動くPythonコードが生成されます。税法の計算ロジック（控除限度額の計算式など）もAIが把握しているため、手計算より正確なコードが出来上がります。
👉 実装で注意すべき3つのポイント
- マイナンバー取扱規程の整備：システムでマイナンバーを処理する場合、取扱規程の整備と安全管理措置が必要（番号法遵守）
- e-Taxの送信者認証：API送信は利用者識別番号と電子証明書が必要。顧客代理での送信には代理送信の手続きが必要
- 最終確認は必ず税理士が行う：AIの計算結果は必ず専門家がレビューしてから送信。税務上の責任はAIではなく担当者が持つ
AI鬼管理で導入した税理士事務所では、確定申告1件あたりの工数が平均62分から11分に短縮されました。コード自体はClaude Code／Codexが生成し、事務所スタッフはレビューと確認のみを担当しています。
独学でAI自動化に挑戦したが挫折した理由と、AI鬼管理の解決策
「自分でもやってみたが途中でつまずいた」という税務担当者の声が多くあります。主な挫折ポイントは以下の3つです。
🚫 挫折ポイント①：マイナポータルAPIの認証フローが複雑
OAuth2のフローを正確に実装しないとトークンが取得できない。エラーメッセージも不親切で解決に数日かかるケースも。
🚫 挫折ポイント②：e-TaxのXMLスキーマが複雑
国税庁公開のスキーマ仕様書は数百ページ。どの項目が申告書のどの欄に対応するか把握だけで膨大な時間を要する。
🚫 挫折ポイント③：税法の改正への追従
毎年控除額の限度や計算式が変わる。独自実装の場合、年度ごとに修正が必要だが、AI活用の知識がないと改修コストが大きい。
📚 用語解説
プロンプトエンジニアリング：AIに対して適切な指示文（プロンプト）を作成する技術。確定申告自動化では「どの控除をどの計算式で処理するか」を正確に記述することが精度向上のカギ。
✅ AI鬼管理が解決する方法
- 認証フロー実装はClaude Codeが担当：自然言語で説明するだけでOAuth2実装コードを生成。エラー時も「このエラーを直して」で即修正
- XMLスキーマはAIが把握済み：e-Taxスキーマの主要項目はClaude Code／Codexの学習データに含まれており、マッピングコードを自動生成
- 年度改正はプロンプト更新で対応：「令和7年の生命保険料控除の上限は〇〇円に変更になった。計算ロジックを修正して」と指示するだけで追従可能
毎年税法が変わるから自動化しても維持コストが心配です。
AI鬼管理では税法改正のたびにAIへのプロンプトを更新するだけで対応できます。コードを一から書き直す必要がなく、改正対応コストが大幅に下がります。実際に導入した事務所では「毎年の改正対応が半日以内に終わるようになった」という声をいただいています。
マイナンバー確定申告自動化：アプローチ別比較まとめ
確定申告自動化のアプローチを3つ比較します。それぞれのメリット・デメリットと、どの規模の事務所に向くかを整理しました。
📚 用語解説
RPA（ロボティック・プロセス・オートメーション）：ソフトウェアロボットが画面操作を記録・再生することで業務を自動化する技術。e-Taxソフトの画面操作を記録して自動化するケースがあるが、画面変更に弱くメンテコストが高い。
| アプローチ | 初期コスト | 維持コスト | 自動化精度 | 向いている規模 |
|---|---|---|---|---|
| RPA | 高（ライセンス料） | 高（画面変更ごと修正） | 中（画面変更に弱い） | 大手法人 |
| 税務専用SaaS | 中（月額費用） | 低（ベンダー管理） | 高（専用設計） | 中規模以上 |
| Claude Code＋AI鬼管理 | 低（API費用のみ） | 低（プロンプト更新） | 高（カスタム対応可） | 個人〜大手まで |
特に個人税理士〜10名規模の事務所では、高額なRPAや専用SaaSを導入するほどの規模でなくても、Claude Code／Codex＋AI鬼管理の組み合わせで十分な自動化が実現できます。
よくある質問（FAQ）
🔗 あわせて読まれている記事
- 確定申告 AI 自動化【2026年最新】 — 確定申告全体をClaude Codeで自動化する基本ガイド
- 確定申告にAIを活用する方法 — 確定申告にAIを活用する実践テクニック集
- 税務・申告業務 完全ガイド — 税務自動化の全体像と活用法まとめ
マイナポータル連携の具体的な操作手順と注意点
マイナポータル連携を実際に行う際の具体的な手順と、よくつまずくポイントを解説します。e-Tax確定申告書等作成コーナーとマイナポータルを使う「公式フロー」を理解した上で、それをAPI化する際の違いも説明します。
顧客が50人いると、毎年1月〜3月に全員からマイナポータル連携の操作を依頼するのが大変で…
AI鬼管理では、顧客への案内メール送信から同意状況の追跡、完了通知まで自動化できます。Claude Code／Codexで「連携未完了の顧客リストを抽出してリマインドメールを送信して」と指示するだけで、一括管理が可能になります。
Claude Code が自動生成する控除計算ロジックの実例
確定申告の核心は控除計算です。Claude Code／Codexが生成する控除計算コードの具体例を、主要な控除項目ごとに示します。複雑な計算式もAIが正確に実装します。
📚 用語解説
社会保険料控除：国民健康保険・国民年金保険料・社会保険料として支払った全額が所得控除になる。マイナポータルで国民年金保険料の証明書が自動取得できる。
| 控除の種類 | 計算ロジックの複雑さ | Claude Codeへの指示例 | 自動化難易度 |
|---|---|---|---|
| 給与所得控除 | 段階的計算（給与額によって率が変わる） | 「給与収入Xの場合の給与所得控除額を令和6年税制で計算して」 | ●●●○○ 易 |
| 生命保険料控除 | 3区分（一般・介護・個人年金）×旧・新制度 | 「新制度の生命保険料控除額を新旧別に計算してXML形式で出力して」 | ●●●●○ 中 |
| 医療費控除 | 支払額−保険補填額−10万円（または所得5%） | 「医療費明細CSVを読み込んで控除額を計算して明細書XMLを生成して」 | ●●●●○ 中 |
| 住宅ローン控除 | 年末残高×控除率（借入時期・住宅種別で異なる） | 「住宅取得日・借入額・残高から住宅ローン控除額を計算して」 | ●●●●● 高 |
| ふるさと納税控除 | 上限額試算が複雑（所得・家族構成による） | 「ふるさと納税の寄付金控除（所得控除）と税額控除の両方を計算して」 | ●●●●○ 中 |
Claude Code／Codexは税法の複雑な段階計算も正確に実装します。「令和6年分の計算式で」と年度を明示することで、改正後の正確な計算ロジックを生成できます。特に住宅ローン控除は取得時期・住宅種別（認定長期優良住宅か否か）によって控除率が大きく異なるため、AIの計算結果は必ず税理士が確認してください。
AI鬼管理を導入した税理士事務所の活用事例
実際にAI鬼管理を導入してマイナンバー確定申告自動化を実現した士業事務所の事例を紹介します。規模・業種が異なる2事務所の実績から、自分の事務所への応用ポイントを見つけてください。
💼 事例①：個人税理士事務所（顧客80名規模）
🚨 導入前の課題
- 確定申告シーズンに月100時間超の残業
- 書類収集の抜け漏れでミスが年5件程度
- 顧客への進捗共有に時間がかかる
✅ 導入後の変化
- 残業が月30時間以下に削減
- 書類収集の抜け漏れゼロ（自動チェック）
- 顧客へのステータス自動通知で問い合わせ減
担当者コメント：「Claude Code／Codexへの指示文の書き方をAI鬼管理で学んで、最初は半日かかっていた申告書作成が2時間で終わるようになりました。特に医療費控除の明細自動生成は助かっています。」
💼 事例②：税務法人（スタッフ5名・顧客200名規模）
🚨 導入前の課題
- スタッフごとの処理品質にばらつき
- 繁忙期の人員不足でパートを毎年採用
- 税法改正の際に全スタッフへの周知に手間
✅ 導入後の変化
- Claude Code生成コードで品質が均一化
- パート採用が不要になり人件費削減
- 改正内容はAIプロンプト更新で即反映
担当者コメント：「スタッフがAI鬼管理のガイドに沿ってClaude Codeを使えるようになったことで、担当者が変わっても同じ品質で申告書を作れるようになりました。研修コストも大幅に減りました。」
自動化導入ロードマップ：3ヶ月で全自動確定申告を実現する手順
「いきなり全自動は難しい」という方のために、3ヶ月で段階的に自動化を進めるロードマップを提案します。AI鬼管理のトレーニングプログラムに沿った進め方です。
📚 用語解説
バッチ処理：複数の申告データを一度にまとめて処理する方式。個別に手作業で処理する逐次処理と対比される。AIと組み合わせることで100件の申告書を数時間で一括処理できる。
- 顧客管理スプレッドシートの整備
- マイナポータル同意案内メールの自動送信
- 同意状況の自動追跡・リマインド
- 控除証明書データのXML自動ダウンロード
- freee/弥生APIとのデータ連携
- 控除計算ロジックのコード化（Claude Codeで）
- 申告書XMLの自動生成・品質チェック
- 税理士向けレビュー画面の整備
- e-Tax自動送信スクリプトの整備
- 受付番号の自動記録・顧客への通知
- 次年度のデータ引き継ぎ設定
- 税法改正対応フローの確立
3ヶ月のロードマップでも、最初の1ヶ月で書類収集だけ自動化するだけで繁忙期の工数を30〜40%削減できます。AI鬼管理では各フェーズのコードをClaude Codeが生成するため、プログラミング経験がなくても進められます。
Month 1だけでも相当な効果がありそうですね。次の繁忙期前に始めれば間に合いますか？
はい。11月までに始めれば、繁忙期前にMonth 1〜2を完了できます。AI鬼管理では初回セッションで「あなたの事務所に合わせた自動化ロードマップ」を一緒に設計しますので、まずは無料相談からどうぞ。
マイナンバー情報を扱う自動化システムのセキュリティ要件
マイナンバーを処理するシステムには、番号法が定める安全管理措置が義務付けられています。AI自動化を導入する際に必ず確認すべきセキュリティ要件を整理します。
📚 用語解説
特定個人情報：マイナンバー（個人番号）を含む個人情報のこと。通常の個人情報より厳格な管理が求められる。「特定個人情報の適正な取扱いに関するガイドライン」に沿った安全管理措置が必要。
⚠ 必須の安全管理措置チェックリスト
- 組織的管理措置：取扱規程の策定・担当者の明確化・定期的な監査
- 人的管理措置：担当者への研修・誓約書の取得
- 物理的管理措置：マイナンバーデータへのアクセス制限・鍵付き保管
- 技術的管理措置：アクセス制御・ログ取得・暗号化（特にAPIトークンはセキュアな保管が必須）
- 委託先管理：AIツール（Claude API等）への委託契約・データ処理範囲の確認
AI鬼管理では、Claude Code／Codexにマイナンバーそのものを入力するのではなく、「既にシステムに安全に保管されたデータを処理するコードを生成させる」アプローチを徹底します。AIへのプロンプトにマイナンバーの実データを含めることは絶対に避けてください。
AI鬼管理のセキュリティガイドラインでは、「AIにはコードを書かせる。実データはAIに渡さない」という原則を徹底しています。処理コードはAIが生成し、実際のマイナンバーデータはそのコードが自動で処理する。この分離が重要です。
マイナンバー確定申告自動化でよくある失敗と回避策
実際に自動化を進めた事務所から寄せられた「やってみて気づいた落とし穴」を共有します。同じ失敗をしないよう、事前に確認しておきましょう。
👉 失敗①：マイナポータル同意の有効期限を見落とした
症状：昨年は連携できたのに今年は控除証明書が取得できない。
対策：マイナポータルの同意には有効期限がある。毎年シーズン前に同意更新の案内を自動送付する仕組みを作る。Claude Codeで「毎年10月1日に同意更新案内メールを顧客全員に一括送信するスクリプトを書いて」と指示するだけで実装できる。
👉 失敗②：取得できる控除証明書の種類に限りがある
症状：一部の保険会社・金融機関はマイナポータル連携に対応していない。
対策：未対応証明書は従来通り書類収集が必要。AI鬼管理では「取得済み証明書と未取得証明書の差分リストを自動生成して未取得分の請求を顧客に促す」フローを自動化する。
👉 失敗③：副業・不動産所得のデータ収集が漏れた
症状：マイナポータル連携で安心していたら副業収入の申告漏れが発生した。
対策：マイナポータルでカバーされるのは主に「受取側の証明書」のみ。副業・フリーランス収入は顧客が自ら収集・提供する必要がある。ヒアリングチェックリストをClaudeに作成させ、毎年顧客に送付する。
これらの落とし穴は、AI鬼管理の導入支援の中で事前に対策を組み込みます。「初年度は試行錯誤で大変だった」という声をなくすために、標準化された導入フローを提供しています。
確定申告自動化の費用対効果：投資回収シミュレーション
AI鬼管理の導入コストと削減できる工数から、費用対効果を具体的に計算します。あなたの事務所の規模に当てはめて確認してください。
📈 費用対効果シミュレーション（顧客50名の事務所の場合）
| 項目 | 導入前 | 導入後 | 削減効果 |
|---|---|---|---|
| 確定申告作業時間（年間） | 200時間 | 60時間 | ▲140時間 |
| 人件費（時給3,000円換算） | 60万円 | 18万円 | ▲42万円 |
| AI鬼管理導入費用 | — | 月額費用のみ | 詳細はお問い合わせ |
| 投資回収期間 | — | — | 多くの場合1シーズン以内 |
※数値はAI鬼管理導入事務所の平均値に基づく参考値です。実際の効果は事務所規模・業務内容により異なります。
1シーズンで回収できるなら、今年中に始めたいですね。まずどこから相談すればいいですか？
まずはAI鬼管理の無料相談をご利用ください。「現在の申告フローを聞いて、どこから自動化できるか」を一緒に整理します。繁忙期前の今が最適なタイミングです。
💡 まとめ：マイナンバー確定申告自動化で得られる3つのメリット
- 工数削減：1件あたり60〜90分の作業が5〜15分に短縮。繁忙期の残業・人件費を大幅削減
- ミスゼロ：データ自動取得・自動計算で転記ミス・計算誤りが排除。税務上のリスクが低下
- 拡張性：Claude Code／Codexへのプロンプト更新だけで税法改正・新規控除に即対応。毎年のシステム改修コストが最小化
AI鬼管理では、この3つをセットで実現する導入支援を提供しています。まずは無料相談でご相談ください。
Claude Codeで業務自動化を90日で叩き込む
経営者向けの伴走型パーソナルトレーニング
Claude Code を業務に落とし込む
専門研修コース一覧
受講者本人の業務を題材に、「使いこなせる」状態になるまで伴走する研修プログラム。1対1特化型・ハンズオン・法人講座の3コースを展開中。業務特化・実装まで踏み込むタイプのClaude Code研修です。
研修コース一覧を見る →AI鬼管理へのお問い合わせ
この記事を読んで気になった方へ。
AI鬼管理の専門スタッフが、御社に最適な
業務自動化プランを無料でご提案します。
- AI業務自動化サービス「AI鬼管理」を運営 — Claude Code を活用し、経営者の業務を「AIエージェントに任せる仕組み」へ転換するパーソナルトレーニングを 伴走構築 で提供。日報・採用・問い合わせ対応・経費精算・議事録・データ集計・営業リスト等の定型業務を、AIに代行させる体制を経営者と一緒に作り込む
- Claude Code 実装ノウハウを 経営者・法人クライアント に直接指導。生成AIを「便利ツール」ではなく 「業務を任せる存在」 として運用する手法を体系化
- 「やらせ切る管理」メソッドの開発者。シンゲキ株式会社（2021年設立・鬼管理専門塾運営）にて累計3,000名以上の学習者を志望校合格に導いた管理メソッドを、AI × 経営者支援 に転用
- 著書『3カ月で志望大学に合格できる鬼管理』(幻冬舎)、『親の過干渉こそ、最強の大学受験対策である。』(講談社)
- メディア出演: REAL VALUE / カンニング竹山のイチバン研究所 / ええじゃないかBiz 他
- 明治大学政治経済学部卒
