DevTax

Claude CodeとCodexの定額料金を、説明できる制作物別AI原価へ。開発の早い段階から、あとで必要になる記録も案内します。

開発中のプロトタイプです。 機能は途中で、既知の不備があります。税務上の扱いを確定するものではありません。できないことはまだできないことに、不具合の報告や要望はIssuesへお願いします。

DevTaxの目的は、個人開発の実態に沿って費用・判断・根拠を積み上げ、今年の扱いと翌年への引継ぎを説明できるようにすることです。完成像は製品仕様v0.5と技術設計v0.5にあります。仕様の採用と実装の完了は別です。 いまどこまで接続しているかは要件・実装・受入対応表、目的から現行コードまでの図解は全体設計図で確認できます。

ローカル版を起動する · 画面だけ見る（合成データのデモ） · 開発に参加する

30秒でわかるDevTax

困りごと — 定額AIサブスクは、どの制作物にいくら使ったのか説明しにくい。

Claude CodeやCodexを月額契約すると、同じ料金の中にアプリAの新規開発、アプリBの機能追加、保守、一般学習、私用が混在します。API従量課金のような制作物別請求額がないため、取得価額や資本的支出の検討に必要な、合理的で続けられる振り分け根拠を作るのが困難です。

解決方法 — このPCの履歴を、月額と必ず一致する説明可能な振り分け表へ変換し、次に残す記録を案内する。

「今年どうなる？」は計画年の全費用の算定済み基礎と未算定件数を表示し、原額・配分の明細へつなぎます。AI内訳は対象年だけに絞り、全費用とは別に表示します。対応済みの取得価額・方法・年度額は「残高と繰越し」と年度資料へ接続し、未対応・不明な処理は未算定のまま分離します。

利用期間を指定したAI請求は、請求額が分からなくても理由を添えて登録できます。年をまたぐ不明額は関係する各年に残し、同期間の金額が分かる請求だけ計算を続けます。直接費・自宅費用・設備も原額の不明と0円を区別します。既定月額・月別上書き料金でも不明と0円を区別して理由を保存できます。月別の空欄は上書きなしなので、不明として残す場合は「料金不明」を選びます。

現在のDevTaxはClaude Code／Codexのローカル利用履歴から本文を保存せずに利用量を集計し、AIサービス別・期間別・制作物別に料金を配賦します。「支払と配分」ではAI料金・設備・家賃等・直接費を同じ費用資料へ正規化し、原額、対象年の費用基礎、制作物・通常業務・私用・未配分、未算定理由を確認できます。設備とソフトウェアの対応済み方法は、適用条件・取得価額・前年残高から年度額を計算し、残高と年度資料へ渡せます。特殊償却・未対応条件・不明額を通常計算へ置き換えず、未対応範囲として残します。

特徴 — 時間計測でも、単純な「仕事60%」でもない。

• AIサービスごとに異なるトークン定義を混ぜず、それぞれの月額を別の分母で配賦
• 入力、キャッシュ、出力、推論の利用量を重み付けし、プロダクトとの対応を保持
• 捕捉外の利用は確認した割合で留保。不明または利用基準がない支払は「配分未算定」として保持
• 配賦額の合計が、私用・未取得利用・端数調整・配分未算定額まで含めて請求額と必ず一致
• AI配賦の分類候補と、制作物・設備等の不足情報を表示。詳細な税務決定木の全ルールは画面へ未接続
• 初回の5段階案内で「何のための質問か」と入力の進み具合を表示し、途中保存できる
• 自分だけで使うアプリと、外部へ公開・販売するアプリの開始日を分けて記録できる

ローカル履歴（本文は保存しない）
  → AIサービス別の加重利用量
  → 月額料金を制作物へ配賦
  → 開発段階・作業目的を確認
  → AI配賦に基づく3グループ表示

AI料金・制作物・設備・家賃・電気・通信・直接費・証拠
  → 原額 / 対象年の費用基礎 / 配分の共通計算
  → 支払と配分・根拠画面・作業中の相談用Markdown
  → 未算定の原額・理由・影響先を確認

v0.5の採用設計で引き続き接続するもの:
  全費用の入力・保存 → 事実に基づく処理候補
  → 当年費用・種類別残高 → 採用・翌期引継ぎ・訂正・完全出力

想定している使い方

Claude Code／Codexを使って個人開発している方を想定しています。複数PCを使う場合は、DevTaxを動かすPCから各PCの履歴フォルダをSMB/Samba等で読み取り可能にし、「はじめの準備」で走査元を追加します。各PCへのクライアント配置、常駐サービス、秘密鍵、手動インポートは不要です。

重要: 本ツールが資産計上や節税を自動的に成立させるわけではありません。利用履歴から配賦根拠と検討材料を作り、利用者・税理士が事実関係を確認できる状態にするプロトタイプです。何ができないかはまだできないことにまとめています。使い始める前にお読みください。

きっかけは3時間のハッカソンでしたが、そこで作ったMVPを継続して手を入れているOSSです。ライセンスはMIT、Issueとプルリクエストを歓迎します。

公開デモ

画面の雰囲気だけを見たい場合のために、合成データ専用のデモを置いています。実在する利用記録、パス、プロンプト、請求額は一切含みません。

https://devtax-radar.pages.dev/

デモは手動でデプロイしているため、mainより遅れていることがあります。自分の履歴を実際に集計する場合は、下のローカル版を起動してください。デモでは「残高と繰越し」の入力と年度資料の保存を体験できません。3年にわたる取得価額・年額・繰越しの流れはローカル版で確認してください。

	公開デモ	ローカル版
データ	架空の合成データのみ	利用者自身のローカル履歴
履歴走査	しない	読み取り専用で走査
保存先	ブラウザを閉じると消える	端末内SQLite
更新	手動デプロイ	取得したソースのcommitまたはReleaseのtag

ローカルで起動

必要環境はNode.js 24.14以上です。

git clone https://github.com/aobane-tsumugu/DevTaxRadar.git
cd DevTaxRadar
npm ci
npm run dev

起動後、http://127.0.0.1:5173を開きます。ローカルAPIは127.0.0.1:4317で動きます。

本番相当のローカル実行:

npm run build
npm start

GitHub Releasesで配布するZIPは依存関係をbundle済みです。Node.js 24.14以上を用意して展開し、ZIP内で次を実行します。npm installは不要です。

npm start

起動後、http://127.0.0.1:4317を開きます。

GitHubからソースまたはReleaseを取得し、各利用者のPCで使うことを配布の基本とします。利用者自身にCloudflareアカウントは不要です。

このREADMEは現在のソースの説明です。v0.1.0は9879d8e時点の配布版で、後述のCodexアーカイブ走査・原本不在時の数値保持は含みません。これらはmainへ取り込まれた変更です。次版の範囲と公開前の確認事項はリリースノート候補を参照してください。候補の記載だけでは、新版の公開や受入完了を意味しません。

以前のバージョンから更新する場合

メッセージ単位で保存していた古い開発版から更新する場合は、起動時にusage_eventsテーブルをセッション単位へ作り直すため、履歴の再走査が必要です。v0.1.0はすでにセッション単位の形式なので、今回のCodex数値保持の更新だけでこの再作成は行いません。フォルダに付けた期間付きの分類ルールも、旧形式のものは作り直されます。制作物（税務上の単位）と、設備・自宅費用・直接費・証拠の入力内容はそのまま残ります。

複数走査元に対応した版へ初めて更新するときは、DevTaxがDBの検証済みバックアップを作成してから、利用履歴とセッション参照へ走査元IDを付ける移行を行います。既定のローカル履歴の識別子は変更しません。

Codexの原本不在に対応した版への更新では、既存DBを検証付きでバックアップした後、数値キャッシュへ取得状態と不透明なセッション対応を追加します。セッション・制作物の識別子は変更しません。旧版ですでに集計から消えた未保持の数値を、この更新だけで復元することはできません。

配賦の帰属も変わりました。以前は月の判定をUTC基準で行っていたため、日本時間の午前9時より前の利用が前月へ入ることがありました。現在はPCのローカルタイムで判定します。再走査すると、月をまたぐ境界付近の配賦額が以前と変わる場合があります。

ひととおりの流れ

1. 「はじめの準備」から、5段階の案内を開く
2. Claude Code／Codexの履歴を確認する。「履歴がいつ消えるかを確認する」を開くと、最も古い履歴と、Claude Codeの履歴が次に失われる推定日を確認できる。必要ならClaude Codeの保持日数をここで変更する
3. 「候補整理」で全履歴候補を確認し、同じ番号で制作物へまとめる。制作物の用途などを確認する
4. AI料金と契約期間、設備、家賃・電気・通信費、直接費と証拠を登録する
5. 診断で「現在地」「今すぐ確認すること」「出来事が起きたときに行うこと」を見る
6. 「フォルダの割当」で履歴フォルダを制作物・期間・分類へ結び付ける
7. 「今年どうなる？」で複数月の3グループ集計と準備の進み具合を見る
8. 「なぜそうなる？」で配賦、設備・自宅費用、金額保存則、証拠を確認し、相談用Markdownを出力する
9. 「税務QA」で取得価額、資本的支出、旧版→新版、実際に使い始めた日の考え方を確認する

ローカルAPIへ接続できない場合は、エラーと再読込操作を表示します。合成データへ自動的には切り替えません。ローカルの静的プレビューで合成デモを明示的に選ぶ場合は、URLに ?mode=demo を付けます。実履歴はリポジトリ、Release、公開デモへ含めません。

できること

履歴を読む

• ~/.claude/projects/**/*.jsonlと、既定のCodex取得元では~/.codex/sessions/**/*.jsonl・兄弟フォルダ~/.codex/archived_sessions/**/*.jsonlを同じ取得元IDで読み取り専用走査。追加した取得元は指定したルートだけを走査し、兄弟フォルダを自動追加しない
• SMB/Samba、Windows共有、マウント済み共有等、DevTaxを動かすPCから通常のフォルダとして読める履歴を走査元に追加
• 起動時の自動走査と、画面からの再走査。走査元が一時的に読めない場合は前回の正常な集計を保持
• プロンプト・応答・ソースコードの本文を保存しないClaude Code／Codex Adapter
• セッション、作業フォルダ、モデル、月、トークン内訳の正規化
• 識別子とパスを、このPCの中だけで生成したsaltと走査元IDでハッシュ化し、別PCの同一IDを衝突させない
• 走査中のファイル数表示
• 履歴がいつ削除されるかの検出（cleanupPeriodDays、最も古い履歴の日付、次に失われる日）と、差し迫ったときの警告
• バックアップを取ったうえでの保持期間の変更（変更するのはcleanupPeriodDaysだけ。日数は利用者が決め、製品は推奨値を出しません）
• このPCの既定履歴では、取り込み時のファイルSHA-256記録と、再走査時に内容が変わっていた件数の表示（走査直後の画面に出ます）。追加した共有走査元は、設定したルート絶対パスだけを設定として保存し、共有元内の各ファイル絶対パスやハッシュは保存しない。走査前後のサイズ・更新日時が一致したファイルだけを採用
• 走査時と現在のタイムゾーンが違う場合の警告（月の帰属が変わりうるため）

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗