LINEハーネス
導入マニュアル
GitHubのリンクと、Claude Codeに貼る指示文つき
Lステップのような月額のツールを使わずに、公式LINEの配信や顧客管理をしたい方へ。自分専用の管理画面ができるまでを、順番に案内します。
LINEハーネスはLINE公式アカウントの配信や顧客管理をするための道具です。ステップ配信、タグ、フォーム、予約、リマインドなど、Lステップのような有料ツールでやっていることを、自分の環境で動かせます。
プログラムはすべて公開されていて、ツール代はかかりません。Claude Codeとつなげば、「この人たちに、この日時に、これを送って」と頼むだけで、配信の予約まで進みます。
この特典に、動画で紹介したGitHubのリンクと導入の手順をまとめました。Claude Codeにそのまま貼れる指示文もあります。
自分専用の管理画面が開き、テストで友だち追加とメッセージのやり取りができるところまで進めることです。
GitHubのリンク
導入に使うのは、開発者の野田修一さんが公開しているGitHubのページです。GitHubはプログラムを公開して共有するためのサイトです。
LINEハーネスは、2026年8月に正式な名前が「L Harness」に変わりました。GitHubのページにはL Harnessと書いてありますが、動画で紹介したLINEハーネスと同じものです。誰でも無料で使えて、自由に作り替えてよい決まりで公開されています。参考 [1]
お金がかかるもの、かからないもの
| もの | 費用 |
|---|---|
| LINEハーネス | 0円です。 |
| Cloudflare | LINEハーネスを動かす場所です。無料の範囲で動かせますが、登録の途中でカードの登録が必要です。参考 [2] |
| LINE公式アカウント | 配信の料金は、LINEの料金プランのとおりです。今までと変わりません。 |
| Claude Code | 使うには、有料のプランが必要です。 |
0円になるのは、Lステップのような配信ツールの月額です。LINE公式アカウントそのものの料金は、今までどおりかかります。
パソコンに入れずに試したい方向けに、開発者が無料のクラウド版も出しています。空き枠や条件は公式ページで確認してください。参考 [3] この特典では、動画で紹介した「自分の環境に入れる方法」を説明します。
始める前に用意するもの
始める前に、次の5つがそろっているか確かめてください。
- パソコン
WindowsでもMacでも使えます。導入の途中で、ターミナルという文字で操作する画面を使います。 - Node.jsとGit
どちらもLINEハーネスを入れるのに必要な無料のソフトです。Node.jsはバージョン22以上が必要です。入っているかどうかは、Claude Codeが確かめてくれます。参考 [4] [5] - Claude Code
導入の案内役です。導入が終わったあとは、LINEハーネスを動かす相手になります。参考 [6] - LINE公式アカウント
今使っているアカウントで大丈夫です。管理画面にログインできるようにしておきます。 - まとまった時間
コマンドが動く時間は数分です。ただ、LINEやCloudflareの画面での設定もあるので、時間に余裕のあるときに始めましょう。
はじめての方は本番のアカウントの前に、テスト用のLINE公式アカウントで試すのがおすすめです。応答の設定を変えるので、今のあいさつメッセージや自動応答が止まります。
STEP1 Cloudflareに登録する
CloudflareはWebのサービスを動かせる場所を貸してくれる会社です。LINEハーネスはここで動きます。無料の範囲で動くので、サーバー代はかかりません。
- アカウントを作る
Cloudflareの登録ページで、メールアドレスとパスワードを決めて登録します。届いたメールで、アドレスの確認も済ませておきます。 - R2を使えるようにする
R2は画像などのファイルを置いておく場所です。LINEハーネスは配信に使う画像をここに置きます。管理画面の左のメニューから、R2を開いて有効にします。このとき、カードと住所の登録を求められます。
R2は10GBまで無料で使えます。参考 [2] カードを登録しても、無料の範囲で使っているうちは請求されません。R2を有効にする作業は、導入の途中でも案内が出ます。
STEP2 LINEの準備をする
LINE公式アカウントを、外のツールから動かせるようにします。そのための入口が「Messaging API」です。
Messaging APIをオンにする
- いつも使っているLINE公式アカウントの管理画面を開きます
- 右上の「設定」を開き、左のメニューから「Messaging API」を選びます
- 「Messaging APIを利用する」を押します
- プロバイダーを作ります。プロバイダーはチャネルをまとめる入れ物です。名前は会社名や屋号で大丈夫です
オンにすると、このアカウントが「LINE Developers」にも出てきます。LINE DevelopersはLINEを外のツールとつなぐための管理画面です。参考 [7]
導入の途中で聞かれる値
STEP3で導入を始めると、次の値を順番に聞かれます。聞かれたときに、画面の案内どおりに取りに行けば大丈夫です。先に全部集めておく必要はありません。
| 聞かれるもの | どこで取るか |
|---|---|
| Channel ID | 公式アカウントの管理画面の「設定」→「Messaging API」 |
| チャネルシークレット | Channel IDと同じページ |
| チャネルアクセストークン | LINE Developersで、Messaging APIのチャネルを開き、「Messaging API設定」タブの下で発行します。長期のものを使います |
| LINEログインのチャネルID | LINE Developersで、同じプロバイダーに「LINEログイン」のチャネルを新しく作ります。作ったチャネルの基本情報にあります |
| LIFF ID | LINEログインのチャネルの「LIFF」タブで、アプリを追加すると出てきます |
LINEログインのチャネルは、友だち追加した人が誰なのかをLINEハーネスが見分けるために使います。LIFFはフォームや予約のページをLINEの中で開くための仕組みです。参考 [8] [9]
LIFFを追加するときの入力
- サイズ:Full
- エンドポイントURL:いったん https://example.com と入れます。導入が終わったら、本当のURLに変えます
- Scope:openid、profile、chat_message.write の3つ
- 友だち追加オプション:On (Aggressive)
LINEログインのチャネルは最後に「公開済み」にします。「開発中」のままだと、自分以外の人がフォームを開けません。
STEP3 Claude Codeに指示文を貼る
準備ができたら、Claude Codeを開いて、下の指示文を貼って送ります。GitHubのリンクも指示文に入っています。
Claude CodeはLINEハーネスを入れたいフォルダで開いてください。導入の最後に、そのフォルダへClaude Code用の接続の設定が作られます。
LINEハーネスを導入する
全文をコピーし、ご自身の条件に合わせて使ってください。
プロンプト全文を読む
LINE公式アカウントの配信・顧客管理ツール「LINEハーネス(L Harness)」を、自分の環境に入れたいです。 GitHub:https://github.com/Shudesu/line-harness-oss 私はプログラミングに慣れていません。次の順番で、1つずつ案内してください。 1. GitHubのREADMEを読んで、今の導入手順と、必要なものを確認してください。 2. このパソコンに、Node.js(バージョン22以上)とGitが入っているか確かめてください。足りなければ、入れ方を教えてください。 3. 導入用のコマンド「npx --yes create-line-harness@latest」は、質問に答えながら進む形です。私がターミナルで動かすので、このフォルダで動かすための手順を教えてください。 4. 途中で質問が出たら、私がその画面の文字を貼ります。何を答えればいいか、その値がLINEやCloudflareの画面のどこにあるかを教えてください。 5. 「セットアップ完了!」の画面が出たら、APIキーの行を消してから貼ります。そこに書かれたLINE側の設定(応答設定・Webhook URL・LINEログインのCallback URL・LIFFのエンドポイントURL)を、1つずつ一緒に終わらせてください。 6. 最後に、管理画面が開けること、テストで友だち追加してメッセージのやり取りができること、Claude CodeからLINEハーネスを動かせることを、一緒に確かめてください。 守ってほしいこと - チャネルシークレット、チャネルアクセストークン、APIキーは、チャットに貼らせないでください。私がターミナルにだけ入力します。 - お金がかかる設定や、友だちへの配信は、実行する前に必ず私に確認してください。
導入の流れ
導入用のコマンドは、質問に答えながら進む形です。そのため、コマンドはターミナルで自分で動かします。質問が出たら画面の文字をClaude Codeに貼れば、何を答えればいいか教えてくれます。
| 順番 | 画面に出ること |
|---|---|
| 1 | ブラウザが開くので、Cloudflareにログインします |
| 2 | R2を有効にします。済んだらEnterを押します |
| 3 | プロジェクト名を聞かれます。何も入れずにEnterを押すと「line-harness」になります |
| 4 | Messaging APIのChannel ID、チャネルシークレット、チャネルアクセストークンを入れます |
| 5 | LINEログインのチャネルIDと、LIFF IDを入れます |
| 6 | データベースや管理画面は、自動で作られます。待つだけです |
| 7 | 「MCP設定を.mcp.jsonに追加しますか?」と聞かれたら、Yesを選びます。これで、Claude CodeからLINEハーネスを動かせるようになります |
| 8 | 「セットアップ完了!」と出たら、次の章の設定に進みます |
途中で止まっても、同じコマンドをもう一度動かせば、続きから再開できます。Cloudflareのアカウントが2つある方は、使うアカウントを選ぶ画面が出ます。
秘密の値は、チャットに貼らない
チャネルシークレット、チャネルアクセストークン、最後に出るAPIキーは、合い鍵のようなものです。知られると、ほかの人があなたのLINEから配信できてしまいます。
これらはターミナルにだけ入力してください。Claude Codeのチャットに貼る必要はありません。指示文にも、チャットに貼らせないでとお願いする一文を入れてあります。
最後に、LINEの設定を4つ
「セットアップ完了!」の画面には、LINEに登録するURLが出ます。上から順に、4つの設定をします。
- 応答設定を変える
公式アカウントの管理画面の「設定」→「応答設定」で、チャット・あいさつメッセージ・応答メッセージをオフ、Webhookをオンにします。これからは、LINEハーネスが返事や配信を受け持ちます。 - Webhook URLを登録する
Webhookは、友だち追加やメッセージが来たことを、LINEハーネスに知らせる仕組みです。「設定」→「Messaging API」に、完了画面のWebhook URLを貼り、「Webhookの利用」をオンにします。 - LINEログインの設定をする
LINE DevelopersのLINEログインのチャネルで、「リンクされたLINE公式アカウント」に自分のアカウントを選びます。友だち追加オプションはOn (aggressive)にします。「LINEログイン設定」タブで「ウェブアプリでLINEログインを利用する」をオンにして、完了画面のCallback URLを貼ります。 - LIFFのエンドポイントURLを変える
STEP2で仮に入れたhttps://example.comを、完了画面に出たURLに変えます。URLの最後の「?liffId=」まで、そのまま貼ってください。
完了画面に出る、そのほかのもの
- 友だち追加URL:お客さんにはQRコードではなくこのURLから友だち追加してもらいます。誰がどこから来たかを、LINEハーネスが記録できます
- 管理画面のURL:ブックマークしておきましょう
- APIキー:管理画面へのログインに使います。この画面でしか表示されないので、パスワード管理アプリなど安全な場所に保存します
最後に、自分のスマホで友だち追加URLを開いて、友だち追加します。メッセージを送って、管理画面に届けば完成です。Claude Codeは一度閉じて、開き直してください。そうすると、LINEハーネスとつながります。
動いたら、Claude Codeに頼んでみる
ここからがLINEハーネスの本番です。管理画面を開かなくても、Claude Codeに頼めば設定が進みます。動画で紹介した頼み方を、そのまま使える形にしました。
どの指示文にも「案を先に見せて、OKしてから実行して」と入れています。配信は送ったら取り消せないので、慣れるまではこの一文を残してください。
セミナーのリマインドを予約する
全文をコピーし、ご自身の条件に合わせて使ってください。
プロンプト全文を読む
LINEハーネスで、セミナーのリマインドを予約してください。 - 送る相手:「(タグの名前。例:11月セミナー申込)」のタグがついている人 - 送る日時:(例:明日の朝9時) - 伝えたいこと:(例:今夜20時から開始。参加URLはこちら。5分前には入っておいてほしい) 本文の案と、送る相手の人数を先に見せてください。私がOKしてから予約してください。
アンケートフォームを作って送る
全文をコピーし、ご自身の条件に合わせて使ってください。
プロンプト全文を読む
LINEハーネスで、アンケートフォームを作って配信を予約してください。 - 送る相手:「(タグの名前。例:〇〇購入)」のタグがついている人 - 送る日時:(例:今日の19時) - 聞きたいこと:(例:満足度を5段階で/よかったところ/もっとこうしてほしいところ) - 回答した人には:「(タグの名前。例:アンケート回答済み)」のタグをつける フォームの中身と、配信の本文の案を先に見せてください。私がOKしてから作成と予約をしてください。
欲しい機能を足してもらう
LINEハーネスはプログラムが全部公開されているので、Claude Codeに頼んで機能を足すこともできます。「こんな機能が欲しい」と、ふだんの言葉で頼めば大丈夫です。
欲しい機能を足してもらう
全文をコピーし、ご自身の条件に合わせて使ってください。
プロンプト全文を読む
LINEハーネスに、次の機能を足したいです。 - 欲しい機能:(例:予約が入ったら、自分のLINEにも通知が来るようにしたい) - 使う場面:(例:個別相談の予約にすぐ気づいて、お礼を送りたい) 進め方 1. まず今のプログラムを読んで、どこをどう直すかの案を、専門用語を使わずに見せてください。 2. 直す前に、今の状態を保存しておいてください。 3. 直したら、テストをしてから結果を教えてください。 4. 本番に反映するのは、私がOKしてからにしてください。
作り替えたあとに開発者の新しいバージョンを取り込むと、直したところとぶつかることがあります。作り替えるときは、直す前の状態を残しておくと安心です。指示文にもそのお願いを入れてあります。
つまずきやすいところ
フォームや予約のページが開かない
LINEログインのチャネルが「開発中」のままになっていないか確かめてください。「公開済み」にすると、ほかの人も開けるようになります。LIFFのエンドポイントURLがexample.comのままになっていないかも見てください。
パソコンでQRコードを読むと、友だち追加でエラーになる
LINEログインのCallback URLが登録されていないと起きます。前の章の3つめの設定を確かめてください。スマホからの友だち追加は、この設定がなくても動きます。
メッセージを送っても、管理画面に出てこない
Webhook URLが登録されているか、「Webhookの利用」がオンになっているかを確かめてください。応答設定のWebhookがオフのままでも、届きません。
Node.jsが古いと言われた
バージョン22以上が必要です。今の画面をClaude Codeに貼って、入れ直し方を聞いてください。
Claude CodeからLINEハーネスを動かせない
導入の最後に、MCPの設定でYesを選んだかを確かめてください。Yesを選んだあとは、Claude Codeを開き直すとつながります。LINEハーネスを入れたフォルダで、Claude Codeを開いているかも見てください。
途中でエラーが出て止まった
エラーの文字をClaude Codeに貼って、原因を聞いてください。直したら、同じコマンドをもう一度動かせば続きから再開できます。
今日やること
読み終わったら、次の5つを上から順に進めてください。
Claude Codeに頼む時代へ。
管理画面の操作を覚えるより、何を、誰に、いつ送るかを考えることに時間を使いましょう。