
既存の Excel マクロを Claude Code で Python 移植する
はじめに
予算係の棚の奥に「予算執行月次集計.xlsm」というファイルがある。2005 年に当時の係長が書いた VBA マクロ、400 行。書いた本人はとうに退職し、コメントは無く、`Range("AZ65536")` と `Cells(1,1)` が混在し、シート名は「Sheet1」「データ」「集計」「集計2」「集計2_old」が並ぶ。
それでも毎月誰かが「マクロを有効にしますか? → はい → F9」という呪文を頼りに使い続ける。Office 365 への更新で動かなくなった日、係内が止まる。
本稿は、この VBA レガシー資産を Claude Code を使って Python に移植する実務手順を、5 段階のステップで示す。完全自動移植ではなく、**AI が 7 割(コード移植・テスト生成)、人間が 3 割(業務理解の検証・廃止判定)**で再生する現実的な方法。最初の 1 本を 3-4 時間で動かす。
「動いているがメンテ担当が不在の VBA マクロ」は、中規模市の事業部単位で 10-30 個、全庁では 100-500 個規模で存在するケースが報告されている。用途別の典型例は次の 5 系統に集中する。
予算執行月次集計 (各課または予算係に 1 個ずつ)
勤怠・超過勤務集計と給与システム連携データ生成 (人事課に 3-5 個)
固定資産税の課税明細整形 (税務課に 5-10 個)
公共施設利用統計の集計 (各施設の所管課ごと)
住民意見の集計と回答取りまとめ (広報・市民協働系)
作成時期は 2000 年代前半-2010 年代前半が中心で、作者の異動・退職率が 60-80% に達しているという内部調査結果も自治体 IT 担当者の発表で公表されている。
執筆者は元自治体職員。現在は Claude Code を使い、47 都道府県の統計サイト stats47.jp(約 2,000 のランキングを毎日自動更新)を個人で開発・運用している。
📚 本記事はシリーズ「公務員 × Claude Code」全 33 本の 1 本です。関心のあるテーマから読めるよう、全記事をマガジン 公務員 × Claude Code 実務活用ガイド にまとめています。
こんな人におすすめ
作者が退職して中身が分からなくなった Excel VBA マクロを抱える予算・税務・人事課の職員
Office 更新でマクロが動かなくなるリスクに不安を感じている人
レガシー資産を Python に移植して保守しやすくしたい IT 担当者
「移植すべきか廃止すべきか」の判断基準を知りたい人
この記事でわかること
VBA → Python 移植は「業務理解 + コード移植 + 並列テスト」の 3 工程
Claude Code は中間 2 工程(コード移植・テスト生成)を 70% カバー、業務理解は人間
移植先は `openpyxl` + `pandas` が現実解(Excel 互換性が高い、Office なしでも動く)
廃止判断も同時に行う。「移植しない」「業務を見直す」も選択肢
1 マクロあたり従来 1-2 週間 → Claude Code で 3-4 時間

背景: なぜ公務員にこの課題があるか
VBA マクロは、1990 年代後半〜2010 年代前半の自治体 IT 化期に大量生産された。当時の典型パターン:
係内で Excel に詳しい職員が業務効率化のため自発的に作成
ドキュメントは無い(本人の頭の中)
引継ぎは口頭か、運が良ければ A4 1 枚のメモ
異動・退職後はブラックボックス化
これが 2026 年現在、3 つの理由で限界に来ている。
総務省「自治体 DX 推進計画」でも、レガシーシステム(Excel マクロ含む)の刷新が明示的に掲げられている。Claude Code を使えば、Python 移植のハードルは劇的に下がる。Python なら今後 20 年は安心、と判断する材料が揃った。
Excel マクロが動かなくなる事例は、Office のバージョン更新タイミングで集中して発生する。2020 年代に多く報告されたのは次の 3 系統。
Office 2016 → Office 365 移行で `Range("A1").Activate` の挙動が変わり、画面遷移を前提とした VBA が無限ループに陥るケース
Excel のセキュリティ強化で「インターネットから取得したファイルのマクロ実行ブロック」が既定動作となり、係内共有フォルダ経由のファイル配布で「マクロを有効にできない」事例
Windows 11 への OS 移行で 32bit ActiveX 参照が失敗するケース
マクロ停止が業務に直撃すると、復旧までの半日-3 日間は手作業で集計表を作る対応となり、係長級が休日出勤で対応する例も自治体 IT 障害報告で散見される。

手順 / 解説
ステップ 1: 移植対象の選定(3 軸判定 + 廃止検討)
全 VBA マクロを移植しようとすると挫折する。優先順位を 3 軸で判定する。
3 軸すべて「高」のマクロが最優先。逆に「年 1 回 + 代替あり + 単純」なら、廃止か手作業で十分。
判定の前に必ず「そもそもこの業務は要るのか」を問う。例えば「決裁簿の月次集計マクロ」が紙決裁前提で書かれているが、現在は電子決裁に移行済み、というケース。マクロごと廃止が正解。

ステップ 2: VBA コードを Claude に読ませる(文字コード変換必須)
Excel ファイルから VBA を抽出する。
1. Excel を開く
2. Alt + F11 で VBA エディタ起動
3. プロジェクトエクスプローラで各モジュール (Module1, Sheet1 など) を右クリック
4. 「ファイルのエクスポート」で .bas / .cls / .frm として保存
5. ThisWorkbook も忘れずエクスポート(イベントマクロが入っていることがある)抽出した .bas ファイルは Shift_JIS で出力されることが多い。UTF-8 に変換してから Claude に渡す。
# nkf で一括変換(macOS なら brew install nkf, Linux は apt)
for f in *.bas; do
nkf -w --overwrite "$f"
done
# あるいは iconv
iconv -f SHIFT-JIS -t UTF-8 Module1.bas > Module1_utf8.basファイルを Claude Code のワーキングディレクトリに配置:
mkdir -p .claude/migration/budget-monthly-aggregate
cp Module1_utf8.bas .claude/migration/budget-monthly-aggregate/
cp ThisWorkbook_utf8.cls .claude/migration/budget-monthly-aggregate/
cp 元データサンプル_匿名化.xlsx .claude/migration/budget-monthly-aggregate/ステップ 3: Claude に「移植前の業務理解」をさせる
いきなり「Python に変換して」と頼むと、コードの字面だけ翻訳された使えないものが出る。先に業務理解させる。
.claude/migration/budget-monthly-aggregate/ 配下の VBA コードを全部読んで、
まず「このマクロが何をしているか」を業務の言葉で説明してください。
コードの説明ではなく、業務フローとして。
OUTPUT FORMAT:
1. 入力: このマクロが受け取るデータ(シート名・列構成・取得元)
2. 処理: 業務上何をしているか(技術用語ではなく業務担当者が読んで分かる言葉)
3. 出力: 何を生成するか(ファイル / シート / 印刷物)
4. 想定される業務シーン: いつ・誰が・何のために実行するか
5. リスク: 動作しなくなった場合の業務影響
6. 不明点: コードから読み取れない業務前提(質問リスト)ここで Claude が出した業務理解を、人間(できれば元業務担当者・後任者)が読んで「合っている / 違っている」を判定する。違っていれば修正して、Claude に「では正しい業務理解を踏まえて再度説明して」と返す。
業務理解の例(Claude 出力):
1. 入力:
- シート「元データ」: 列 A=日付, B=課コード, C=科目コード, D=金額, E=備考
- シート「マスタ_科目」: 科目コード → 科目名対応表
2. 処理:
- 元データから当月分(現在月の前月)の支出データを抽出
- 課別 × 科目別に金額を集計
- 予算額(マスタ_予算)と突合し、執行率を算出
- 執行率 80% 超の課・科目を赤マーク
3. 出力:
- シート「集計」: 課別 × 科目別マトリクス
- シート「アラート」: 執行率 80% 超リスト
- PDF: 印刷用 A4 縦
4. 想定シーン: 毎月 10 日、予算係係長が月次予算会議資料として実行
5. リスク: 停止すると課別執行状況の把握ができず、年度末駆け込み執行を防げない
6. 不明点:
- 「赤マーク」の閾値が 80% で固定だが、これは現在も妥当か?
- 「集計2_old」シートは何のために残っているか?
- 年度切替時の処理が VBA に見当たらないが、手作業か?不明点を業務担当者に確認 → 回答を踏まえて再度業務理解させる。これを 1-2 回繰り返す。
レガシー VBA の難読パターンとして自治体現場で語られる典型例は、次の 4 系統だ。
1 つの Sub 関数が 300-500 行で、ネスト 5-6 段、グローバル変数 30-50 個が散在するケース
`Application.OnTime` を使った遅延実行と `DoEvents` の組み合わせで、シート再計算の順序に依存する非同期処理
`Worksheet_Change` イベントで別シートのセルを書き換え、それが連鎖的に複数イベントを発火させる「イベント連鎖型」
印刷用シートを毎回複製して `_old1` `_old2` `_old3` と残し続ける「履歴保持型」(シート数が 50-100 枚に膨張する例も)
いずれも作者の意図がコメントから読み取れず、移植時はコードを動かして挙動を観察する作業が業務理解の起点となる。
ステップ 4: Python 移植プロンプト
業務理解が合致したら、Python 移植に進む。要件を明示する。
業務理解が正しいことを確認しました(上記)。
このマクロを Python に移植してください。
要件:
1. ライブラリは openpyxl + pandas のみ使用(他は最小限)
2. 入力 Excel と出力 Excel の構造は既存マクロと完全一致
3. エラーハンドリングを追加(VBA は黙って失敗するが、Python は明示的に例外)
4. 各処理ステップに業務コメントを付ける(VBA にはコメントがなかった)
5. テスト用のサンプルデータ生成スクリプトも同時に作成
6. 1 ファイルで完結する Python スクリプト + テストファイル
7. Python 3.10+ 対応、型ヒント完備
8. 業務理解で「不明点」だった項目は引数化(閾値 80% は CLI 引数で変更可能に)
出力:
- src/budget_monthly_aggregate.py (本体、200-300 行目安)
- src/test_data.py (サンプルデータ生成)
- tests/test_budget.py (pytest)
- README.md (使い方、CLI 例、依存ライブラリ)
- requirements.txtClaude が出力した Python の品質チェック観点:
[ ] 関数が 30 行を超えていないか(超えたら分割)
[ ] マジックナンバー(80, 12 など)が定数化されているか
[ ] ファイルパスが OS 非依存(`pathlib.Path`)になっているか
[ ] 文字コード明示 (`encoding="utf-8-sig"` for Excel CSV)
[ ] エラーメッセージが日本語で業務担当者に分かるか
ステップ 5: 並列テストで動作検証
移植後は必ず「同じ入力で VBA と Python の出力が一致するか」を検証する。Claude にテストパターンを生成させる。
以下のテストパターンを生成してください:
1. 正常系: 一般的な入力データ(10 件)
2. 境界値: 0 件・1 件・10000 件・100000 件
3. 異常系: 列が欠けている / データ型不一致 / 空セル / 文字化け (Shift_JIS 混入)
4. 既知のバグ: VBA で正しく動かなかったケース(これは Python で修正する)
5. 年度切替: 3 月 31 日 → 4 月 1 日跨ぎ(VBA で曖昧だった部分)
各パターンを VBA と Python の両方で実行し、出力 Excel を openpyxl で diff してください。
diff が出た場合、原因が「VBA のバグ」か「Python の移植ミス」かを判定し、
原因別に表形式で報告してください。
OUTPUT FORMAT:
| ケース | VBA 出力 | Python 出力 | 差分 | 原因区分 | 対応 |実行スクリプト例:
# テストデータ生成
python src/test_data.py --pattern=normal --count=10 --out=tests/fixtures/
# VBA 実行(Windows Excel 自動化、macOS なら手動)
# → tests/fixtures/vba_output/
# Python 実行
python src/budget_monthly_aggregate.py \
--input=tests/fixtures/input.xlsx \
--output=tests/fixtures/py_output.xlsx \
--threshold=80
# 差分検証
pytest tests/test_budget.py -vVBA マクロの「怪しい挙動」として現場で報告される典型ポイントは、次の 4 系統が典型的となる。
月末日の集計で 30 日と 31 日で結果が変わるケース (`Day(Date)` ベースの分岐ロジックが月末対応していない)
年度切替期の 3 月 31 日 → 4 月 1 日跨ぎで前年度データが消えるケース (`Year(Date)` ベースの会計年度判定にずれ)
課コードに枝番 (例: 1101-1 と 1101-2) が混在すると片方が脱落するケース (文字列比較の半角全角混在)
1,000 行を超えると `For Each cell In Range` が極端に遅くなる (`ScreenUpdating = False` を入れ忘れた典型)
移植時はまずこれら 4 点をテストケースに含め、VBA 側の隠れバグを Python 側で潰す方針が現実的になる。

よくあるつまずきポイント
Shift_JIS 文字化け: VBA コードも入出力 Excel も Shift_JIS が多い。`nkf -w` または `iconv` で UTF-8 変換を最初に。Python 側は `pd.read_excel(encoding=None)` だが CSV 経由なら `encoding="cp932"`
絶対参照と相対参照の混在: VBA で `Range("A1")` と `Cells(1,1)` が混在しているとリファクタが必要。Python 側は `df.iloc[0, 0]` (位置指定) と `df.loc["A1"]` (ラベル指定) を業務文脈で使い分け
Excel 関数の VBA 呼び出し: `Application.WorksheetFunction.VLookup` 等は pandas の `merge` に置換。`Application.Match` は `pd.Series.searchsorted` または `df.index.get_loc`
イベントマクロ: シート変更時に自動実行される `Worksheet_Change` `Workbook_Open` 系は Python では再現しない設計に。代わりにファイル変更検知 (`watchdog`) や cron で代替
「動いている」を信用しない: VBA で動いている = 正しい、ではない。移植時に隠れバグが見つかることが多い。並列テストで両者の差分が出たら、VBA 側を疑う癖をつける
配列とコレクションの罠: VBA の 1-indexed と Python の 0-indexed のズレで、月初の 1 件が欠落するパターンが頻発。境界値テスト必須
まとめ
VBA → Python 移植は、Claude Code を使えば1 マクロあたり 3-4 時間で完了する(従来は 1-2 週間)。鍵は次の 3 つ。
業務理解を先にやらせる(人間が検証)
並列テストで VBA vs Python の差分を見る
廃止判断を同時にする
20 年もののレガシー資産を、向こう 20 年メンテできる形に再生する作業に、AI は最適なパートナー。最初の 1 本を選び、月次定例日の翌日に着手するのがおすすめ(直近の実行ログが温かい)。

関連記事 / 次に読む
.claude/skills で「毎月の定型業務」を 1 コマンド化する
Excel 予算ファイルを Claude Code で集計
統計データ加工: 公務員のための Claude Code × データ前処理入門
この続きは有料パートです
こんな人におすすめ
作者不在でブラックボックス化した VBA マクロを抱え、Office 更新で止まる前に Python へ移植したい予算・人事・税務系の職員の方。5 段階の進め方は無料部でわかっても、実際の移植には移植前後のコード全文・3 種のプロンプト完全版・廃止判定シートが要ります。最初の 1 本を確実に動かしたい方に向いています。
この続きで読めること
単体購入のほか、マガジン「公務員 × Claude Code 実務活用ガイド」でシリーズをまとめて読むこともできます。
- #生成AI
- #AI活用
- #業務効率化
- #プロンプト
- #ClaudeCode
- #業務改善
- #python
- #公務員
- #DX推進
- #生成AI活用
- #地方公務員
- #業務自動化
- #市役所
- #Windows11
- #VBA
- #属人化
- #プロンプト設計
- #内部統制
- #年度末
- #AIコーディング
- #役所
- #総務省
- #固定資産税
- #自治体DX
- #自治体職員
- #行政DX
- #勤怠管理
- #リファクタリング
- #Python入門
- #パブリックコメント
- #市町村
- #引継ぎ
- #pandas
- #業務フロー
- #レガシーシステム
- #月次報告
- #office365
- #技術的負債
- #Excel自動化
- #Excelマクロ
- #情報システム部門
- #決裁
- #IT担当者
- #openpyxl
- #システム刷新
- #業務棚卸し
- #セキュリティ強化
- #保守性
- #人事課
- #事務作業効率化
- #Pytest
- #UTF8
- #行政事務
- #ブラックボックス化
- #行政実務
- #超過勤務
- #優先順位付け
- #業務の属人化
- #電子決裁
- #回帰テスト
- #Excel業務効率化
- #shiftjis
- #予算執行
- #Excel集計
- #業務理解
- #月次集計
- #税務課
- #型ヒント
- #ActiveX
- #コード変換
- #自治体it
- #文字コード変換
- #予算執行率
- #テスト生成
- #Excel互換
- #住民意見
- #執行率
- #庶務担当
- #年度切替
- #コード移植
- #境界値テスト
- #Office更新
- #公共施設利用統計
- #中規模市
- #予算執行管理
- #事務引継ぎ
- #レガシー資産
- #課税明細
- #予算係
- #VBA移植
- #Python移植
- #マクロ廃止
- #給与システム連携
- #Pythonテスト
- #マクロ有効化
- #並列テスト
- #AIによるコード変換
- #廃止判断
- #移植判断