IrisBooks マニュアル
EN / 日本語
章一覧
マニュアル / はじめに
第01章

はじめに

IrisBooks の入り口は2つあります。多くの事業主は CLI（完全オフライン、 アカウント不要）から始めます。クラウドを使う方や税理士の方は、加えて Web アプリも使います。このページでは両方を案内します。

経路 A — 自分のマシンで帳簿を作る（CLI）

1. iris をインストールする

iris は単一のバイナリです。macOS / Linux では:

curl -fsSL https://irisbooks.jp/install.sh | sh

Windows（PowerShell）では:

irm https://irisbooks.jp/install.ps1 | iex

インストーラーがお使いのプラットフォーム向けバイナリをダウンロードし、 署名を検証して PATH に配置します。次のコマンドで確認します。

iris version

iris が見つからない場合は、新しいターミナルを開くか（PATH の変更は 新しいシェルから有効になります）、上のインストールコマンドをもう一度 実行してください。

2. 最初の帳簿を作る

空のディレクトリでガイド付きウィザードを実行します。

iris init

帳簿名、地域（region）、言語、事業形態（individual / company …）、会計年度の 開始月、そして検証を通った仕訳を AI アシスタントが自動で記帳するか （「いいえ」なら自分で確認して記帳。あとから LLM-GUIDE.md の 「記帳ポリシー」セクションを編集して変更できます）を尋ね、フォルダを 生成します。質問を飛ばして一括指定もできます。

iris init --name "Acme Design" --region JP --language ja \
  --entity-kind individual --fiscal-start-month 4

--sample を付けると、試せるデモ仕訳が約40件入ります（あとで削除可能）。 全フラグは iris init を参照してください。

3. 帳簿を自分用に整える

config/chart-of-accounts.yaml を開き、勘定科目を自分の事業に合わせます。 次に期首残高（現金・預金・売掛金・買掛金・借入金など）を最初の仕訳として opening-balance タグ付きで記帳します（レポートはこのタグの付いた最新の仕訳を 残高計算の起点として扱います。年度締めの繰越仕訳にも同じタグが自動で付きます）。 他システムから移行する場合は、移行日時点の旧システムの試算表と一致させて ください。（notes/todos.md にこのタスクのリマインダーがあります。）

4. AI アシスタントをつなぐ

実際に記帳を進める一番速い方法は、AI アシスタントにファイルを読み書きさせる ことです。最初に一度だけ設定します。

iris onboard

これにより iris mcp serve が MCP 対応クライアント（Claude Code・Claude Desktop・Codex・Cursor・Gemini CLI・VS Code）に登録され、アシスタントが 帳簿内での作業手順を理解するための Claude Code スキルが書き込まれます。詳しい 流れは CLI と自分の LLM で記帳する を参照。AI は作業前に 帳簿ルートの LLM-GUIDE.md を読みます。

5. 毎日のループ

# 1. 銀行CSV / 領収書 / 請求書を raw/ のどこかに置く
# 2. AI にそれを仕訳（status: draft）へ処理させる
# 3. 構造と計算をチェック
iris validate
# 4. 現状を確認
iris balance
iris report pl --from 2026-04-01 --to 2026-06-30

これがオフラインの全ループです。raw/ にファイル、journals/ に仕訳、 iris validate でチェック、iris report で読む。アカウントもネットワークも 不要です。

経路 B — Web アプリを使う（クラウド）

Web アプリは、GUI・クラウド同期・複数端末アクセス・共同作業・改ざんの見える 履歴を提供します。IrisBooks アカウントが必要です。

1. サインインする

アカウントはメールアドレス + パスワードです。IrisBooks の Web アプリにアクセス してサインイン（または新規登録）します。税理士に招待された場合は、招待された メールアドレスで登録すれば、帳簿はすでに待っています。

2. 帳簿を作る

まだ帳簿が1つもなければ、アプリは 新規帳簿ウィザードを表示します。帳簿名・ 地域・会計年度を入力すると、クラウド上に帳簿が作られます。作成時点で config/book.yaml とひな形の勘定科目表が入っているため、iris clone <book-id> だけで、すぐ使えるローカルフォルダが手に入ります。

3. 既存のローカル帳簿をリンクする（任意）

経路 A でディスク上に帳簿がある場合、両者を接続して同期できます。

iris api login                 # 一度だけのブラウザサインイン（このデバイス専用のセッション）
iris api books new             # または: iris api books link <book-id>
iris sync                      # ローカルファイルを push

これで同じ帳簿に CLI と Web アプリの両方からアクセスできます。同期が何を 変え、何を変えないかは 基本コンセプト → 同期 を参照してください。

4. アプリで作業する

上部バーにはダッシュボードタブと帳簿プレートがあり、そこで帳簿を選んで 中に入ります。帳簿の中では、左サイドバーにその帳簿の画面 — 仕訳、 アクティビティ、各レポート、管理グループ（勘定科目、元資料、ノート、 年度の締め、設定）— が並びます。右上のアバターからあなたの設定を 開けます。詳しくは Web アプリを使う。

アカウントは必要か

記帳そのものには不要です — ローカルファイルと CLI だけで完結します。 IrisBooks アカウントは、同期・Web アプリ・共同作業、そして優良な電子帳簿 （任意）の適用に必要な訂正・削除の恒久履歴を追加します。 基本コンセプト → 同期 を参照してください。

次のステップ