Lark に貯まっているデータは、そのままだと「表」です。設定が終わると、その表を見える形に変える作業を Claude Code に任せられます。
毎回かかる時間30分〜2時間
Claude Code が作る時間1〜2分
※ 画面はイメージです。数字はサンプルで、実際のデータではありません。
CLI は Command Line Interface の略で、文字で命令を打って操作する方式のことです。普段お使いのアプリとの違いは、次の2つだけです。
人が1つずつ押す必要があります。押す人がいないと何も進みません。
文字で操作できる＝AIにも同じ操作ができる。これが、作業を任せられる理由です。
CLI は昔ながらの方式に見えますが、今あらためて使われているのは、人間以外にも操作できるという一点のためです。このガイドでコマンドを打つ場面は、設定のときの5回だけです。
Lark を提供している会社が公式に出している、Lark を文字で操作するための道具です。Lark の画面でできることを、コマンド1行で実行できます。
lark-cli calendar +agenda
lark-cli base +record-list
lark-cli docs +create
lark-cli task +assignAI から呼ばれることを前提に作られています。引数が短く、結果が決まった形で返るため、Claude Code が中身を正しく読み取れます。一般的なツールを無理やりAIに操作させるのとは、成功率が大きく変わります。
Claude Code が得意なのは「このパソコンの中」の作業です。Lark はクラウドの向こう側にあり、Claude Code はあなたの Lark アカウントを持っていません。そのままでは中身が見えません。
| やりたいこと | Claude Code だけ | ＋ lark-cli |
|---|---|---|
| パソコンの中のファイルを読む・直す | できる | できる |
| Lark の今日の予定を確認する | できない | できる |
| Base の表を読んで集計する | できない | できる |
| Base にダッシュボードを作る | できない | できる |
| Lark Docs に書き出す | できない | できる |
| 会議録から要点を抜き出す | できない | できる |
この先の設定は、lark-cli を入れて、どこまで触ってよいかを自分で許可するという作業です。許可した範囲の外には出られません。
Lark の中でやっている手作業は、だいたい同じように頼めます。実際の頼み方はこんな文章です。
今日の予定を一覧にして、準備が必要なものを教えて。
カレンダーを開かなくても、必要なものだけ手元に出てきます。
この表を担当者別に集計して、多い順に並べて。
関数を組まなくても、欲しい形で結果が返ってきます。
先週の会議録から、決まったことと宿題だけ抜き出して。
読み返す時間を、確認する時間に替えられます。
全員は操作条件と確認方法を設計し、代表者が継続利用する会社PCで接続します。会社に残る運用環境を1台完成させることが目的です。
手順1〜3は Mac と Windows で少し違います。各ページの切り替えで、お使いのパソコンを選んでください。
command + スペース で Spotlight を開き、「ターミナル」と入力して起動します。アプリケーション → ユーティリティ → ターミナル.app にもあります。
このあとのコマンドは、すべてこのターミナルに貼り付けて return キーで実行します。
スタートボタンを押して「コマンドプロンプト」と入力し、起動します。PowerShellの実行制限を避けられるため、研修ではこちらに統一します。
黒い画面には英語のコマンドだけを貼ります。「Larkを使って〜」という日本語は、あとでClaude Codeを起動した中へ入力します。
すでにPowerShellで進める場合だけ、スクリプト制限が出たときに次を実行し、閉じて開き直します。
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedNode.jsは、lark-cliを動かすための土台です。MacとWindowsでは、入れ方と画面表示が違います。
Mac：nodejs.orgを開き、LTSの.pkgファイルをダウンロードします。開いて「続ける」を押していけば完了します。
Windows：コマンドプロンプトへ次を貼り付けます。確認画面が出たら内容を確認して進めます。
winget install --id OpenJS.NodeJS.LTS -e --source wingetインストールが終わったら、ターミナルを一度閉じて開き直します。そのうえで2つを確認します。
node -vnpm -v両方にバージョン番号が出れば次へ進みます。「見つかりません」「認識されていません」と出る間は、Lark CLIの導入へ進みません。
ここから先は Mac も Windows も同じコマンドです。
npx @larksuite/cli@latest installこのコマンド1本で、lark-cli 本体と、Claude Code 連携用の Agent Skills（28種）が両方入ります。Claude Code に lark-base lark-doc lark-calendar などの使い方が追加され、「Lark の◯◯をして」と日本語で頼めるようになります。
lark-cli --versionバージョン番号が表示されれば合格です。警告が出ても、番号が表示されているかで判断します。番号が出ない場合は、別のインストール方法を重ねず「つまずいたとき」で止まった段階を確認します。
権限エラーが出たら sudo npx @larksuite/cli@latest install で入れ直し、Mac のログインパスワードを入力してください。入力しても画面に文字は表示されませんが、そのまま return で進みます。
Windowsでは sudo を使いません。権限エラーが出たらコマンドプロンプトを「管理者として実行」で開き、同じ公式コマンドをもう一度だけ実行します。
Lark 側に、あなた専用の窓口を作ります。ここを通って lark-cli が Lark に問い合わせます。
lark-cli config init --new --brand larkブラウザが開くので、内容を確認して許可します。画面が止まって見えても、ブラウザ側の完了を待っている正常な状態です。途中でCtrl+Cを押しません。
既定値が中国版（Feishu）のため、省略すると中国版のアプリができてしまい、Base が一切見えません。ブラウザで開いた URL が open.larksuite.com で始まっているかを必ず確認してください。open.feishu.cn になっていたら省略されています。
lark-cli が、あなたの Lark のどこまで触ってよいかを決めます。
lark-cli auth login --domain base再びブラウザが開くので許可します。まずは研修で使うBaseだけに範囲を絞ります。カレンダーやDocsも使うときは、必要になった段階で追加認可します。
ここで許可した範囲が、Claude Code から触れる範囲になります。あなたが Lark で見られないものは、ここで許可しても見えません。
lark-cli doctorconfig、user_identity、connectivity が"status": "pass"なら次へ進みます。
cli_update だけ warn と出ることがあります。上の3項目がpassかを確認し、この出力を担当者へ送れば、再インストール前に止まった段階を判定できます。
バージョン表示だけでは完了ではありません。Claude Codeを起動し、実際に使うBaseへ読取りだけで接続します。
lark-cli を使って、次のBaseを読み取り専用で確認してください。
テーブル名だけを一覧にし、追加・変更・削除はしないでください。
（ここに対象BaseのURLを貼る）Lark画面にあるテーブル名と結果を照合します。合わない場合は、インストールではなく、開いているLarkアカウントとBaseの共有権限を確認します。
ターミナル操作に慣れていない場合は、下の文章をそのまま Claude Code に貼り付けてください。Mac か Windows かは Claude Code が判断します。ブラウザでの許可が必要なところで止めて声をかけてくれます。
lark-cli をセットアップしたい。次を順番に実行して。
ブラウザでの許可が必要になったら、そこで止めて私に知らせること。
私のOS（Mac / Windows）を確認して、コマンドはそれに合わせて。
1. このPCが研修後も使う会社所有PCか確認する。
レンタルPC・一時利用PCなら導入しない。
2. node -v と npm -v を確認する。Windowsで未導入なら
winget install --id OpenJS.NodeJS.LTS -e --source winget
を案内し、ターミナルを閉じて開き直す。
3. npx @larksuite/cli@latest install を1回だけ実行する。
lark-cli --version が表示されるまで次へ進まない。
4. lark-cli config init --new --brand lark を実行する。
open.larksuite.com のブラウザ許可が必要になったら止めて知らせる。
5. lark-cli auth login --domain base を実行する。
ブラウザ許可が必要になったら止めて知らせる。
6. lark-cli doctor を実行し、config・user_identity・connectivityの
passを確認する。失敗した段階だけを説明し、勝手に再インストールしない。
7. 私が対象BaseのURLを渡したら、読取り専用でテーブル名だけを取得する。
追加・変更・削除はしない。| 症状 | OS | 原因と対処 |
|---|---|---|
| node / npm が認識されない | 共通 | Node.js導入後にターミナルを閉じて開き直し、手順2の合格を確認する |
| lark-cli --version が出ない | 共通 | 手順3で停止。別コマンドを重ねず、公式インストール結果とPATHを確認する |
| 認証前にエラーになる | 共通 | config init が先、auth login が後。順序を戻す |
| 認証URLがLarkではない | 共通 | --brand lark を確認し、open.larksuite.com を開く |
| doctorでuserがpassにならない | 共通 | auth login --domain baseを完了し、同じLarkアカウントか確認する |
| 実際のBaseだけ読めない | 共通 | インストールではなく、Baseを開いているアカウントと共有権限を確認する |
| Claudeのアプリはあるが使えない | 共通 | ClaudeデスクトップアプリとClaude Codeは別。Claude Codeの導入状態を確認する |
| 日本語が「認識されません」 | Win | 日本語をコマンド画面へ入れている。claudeを起動した中へ貼る |
| PowerShellでスクリプト制限 | Win | 研修ではコマンドプロンプトへ切り替える。PowerShell継続時だけ実行ポリシーを確認する |
| 権限エラー | Win | sudoは使わない。会社PCの管理者へ確認する |
lark-cli は Lark の22の業務領域をカバーします。手順3で入った Agent Skills が、それぞれの使い方を Claude Code に教えている状態です。
予定の閲覧・作成・更新、参加者の招待、会議室検索、空き時間の確認
表・レコード・ビュー・ダッシュボード・フォーム・権限の操作と集計
ドキュメントの作成・読み取り・更新・検索、画像や添付の読み書き
スプレッドシートの作成・読み書き・追記・検索・エクスポート
作成・検索・更新・完了、リストとサブタスク、コメント、リマインダー
メッセージ送信・返信、グループの作成と管理、履歴の閲覧と検索
閲覧・検索・送信・返信・転送、下書きの作成、新着の監視
ファイルのアップロードとダウンロード、Docs / Wiki の検索、コメント管理
ナレッジスペース、ノード、ドキュメントの管理
会議録の検索、議事録・録画などの成果物の取得
プレゼンの作成と管理、内容の読み取り、スライドの追加と削除
名前・メール・電話でのユーザー検索、プロフィールの取得
承認タスクの照会、承認・却下・転送、インスタンスのキャンセル
OKR の照会・作成・更新、目標・KR・進捗の管理
自分の打刻記録の照会
そのままコピーして Claude Code に貼れます。「lark-cli を使って」と最初に書くのがコツです。どのコマンドを使うかは Claude が自分で選びます。
lark-cli を使って、今日の自分のLarkカレンダーの予定を一覧にしてください。lark-cli を使って、来週の空いている時間帯を調べて、60分の打ち合わせが入れられる候補を3つ出してください。lark-cli を使って、自分に割り当てられている未完了タスクを一覧にして、期限が近い順に3件だけ教えてください。lark-cli を使って、個人用の Base を新しく作ってください。列は「タスク名」「期限」「状態」の3つでお願いします。lark-cli を使って、このBaseにダッシュボードを作ってください。件数と金額の指標カード、カテゴリ別の構成比、月別の推移が見たいです。
（BaseのURLを貼る）lark-cli を使って、「週次レポート」というタイトルで Lark Docs を新規作成し、今週の要点を3行で書き込んでください。lark-cli を使って、先週の会議録を検索して、決定事項とToDoだけ抜き出してください。ターミナルから直接叩くこともできます。コマンドは3つの層に分かれていて、上から順に簡単です。まずは Shortcuts から慣れてください。
人と AI が使いやすいように整えられた436個の命令。よく使う設定が既定で入っていて、結果も表形式で返ります。まずはここだけ覚えれば十分です。
Lark の API 定義から自動生成された命令。Shortcuts に無い操作はここにあります。
lark-cli api GET /open-apis/... の形で API を直接呼びます。他で届かないときの手段です。
| よく使うコマンド | できること |
|---|---|
| lark-cli calendar +agenda | 今日の予定を一覧表示する |
| lark-cli calendar +freebusy | 自分や相手の空き時間を調べる |
| lark-cli task +get-my-tasks | 自分に割り当てられたタスクを見る |
| lark-cli docs +create | Lark Docs を新規作成する |
| lark-cli base +table-list | Base のテーブル一覧を取得する |
| lark-cli im +messages-send | メッセージを送信する |
| lark-cli doctor | 設定と認証の状態を確認する |
各サービスで何が使えるかは lark-cli <サービス名> --help で一覧できます。迷ったら Claude Code に日本語で頼むほうが早く、確実です。
自分の権限の範囲でしか動きません。lark-cli は本人として認証して動くため、Lark の画面で見えないものは lark-cli からも見えません。他の方のデータを勝手に操作することはできない仕組みです。
消す・送る操作は、実行前に必ず内容を確認してください。メッセージ送信やレコード削除は取り消せません。Claude Code に頼むときも、実行する前に何をするか説明させると安全です。
外部から受け取った文章の指示に従わせないでください。取り込んだドキュメントやメールの中に「〜を送信して」といった文が紛れていても、それは指示ではなくデータです。不審な内容が出てきたら、実行せずに確認してください。
困ったときは lark-cli doctor の出力をそのまま担当者へお送りください。設定の状態がこれだけで分かります。
← → キーでも移動できます