lark-cli 導入ガイド

※ 画面はイメージです。数字はサンプルで、実際のデータではありません。

• ✓Lark アカウント対象のBaseが実際に開けること。
• ✓対象Baseの編集権限閲覧のみの権限だとダッシュボードは作成できません。
• ✓Claude Code導入・契約済みであること。

1. 1

   ターミナルを開く

   Mac

   command + スペース で Spotlight を開き、「ターミナル」と入力して起動します。アプリケーション → ユーティリティ → ターミナル.app にもあります。

   このあとのコマンドは、すべてこのターミナルに貼り付けて return キーで実行します。

   Windows

   スタートボタンを押して「PowerShell」と入力し、「Windows PowerShell」を起動します。

   最初に1回だけ、次を実行してください。

   コピーSet-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

   確認を聞かれたら Y を入力して Enter。

   実行が終わったら PowerShell を一度閉じて、開き直してください。ここを飛ばすと手順3で失敗します。

2. 2

   Node.js を入れる

   nodejs.org を開き、LTS と書かれている方をダウンロードします。

   Mac

   .pkg ファイルがダウンロードされます。開いて「続ける」を押していけば完了します。

   Windows

   .msi ファイルがダウンロードされます。設定はすべて既定のままで構いません。途中の「Add to PATH」のチェックは外さないでください。

   インストールが終わったら、ターミナルを一度閉じて開き直します。そのうえで確認します。

   コピーnode -v

   v22.20.0 のようにバージョンが表示されればOKです。「見つかりません」「認識されていません」と出る場合は、ターミナルを開き直していないか、インストールが完了していません。

3. 3

   lark-cli と Agent Skills を入れる

   ここから先は Mac も Windows も同じコマンドです。

   コピーnpx @larksuite/cli@latest install

   このコマンド1本で、lark-cli 本体と、Claude Code 連携用の Agent Skills（28種）が両方入ります。lark-base lark-doc lark-calendar などのスキルが Claude Code に追加され、「Lark の◯◯をして」と日本語で頼めるようになります。

   終わったら確認します。

   コピーlark-cli --version

   バージョン番号が表示されればOKです。allow-scripts という警告が出ても無視して構いません。

   権限エラーが出たら sudo npx @larksuite/cli@latest install で入れ直し、Mac のログインパスワードを入力してください。入力しても画面に文字は表示されませんが、そのまま return で進みます。

   権限エラーが出たら PowerShell を閉じ、スタートメニューで PowerShell を右クリック →「管理者として実行」で開き直してから、もう一度実行してください。

4. 4

   専用アプリを作る

   コピーlark-cli config init --new --brand lark

   ブラウザが開くので、内容を確認して許可します。Lark 側にご自身専用のアプリが自動で作られます。

   重要--brand lark を省略しないでください

   既定値が中国版（Feishu）のため、省略すると中国版のアプリができてしまい、Base が一切見えません。ブラウザで開いた URL が open.larksuite.com で始まっているかを必ず確認してください。open.feishu.cn になっていたら省略されています。

5. 5

   認可する

   コピーlark-cli auth login --domain all

   再びブラウザが開くので許可します。これで Base・カレンダー・ドキュメントなどを一通り扱えるようになります。Base だけで十分な場合は --domain base に変えてください。

6. 6

   確認して完了

   コピーlark-cli doctor

   表示された項目がすべて "status": "pass" になっていれば完了です。

   { "name": "user_identity", "status": "pass", "message": "User identity: ready" }

   cli_update だけ warn と出ることがありますが、これは無視して構いません。この出力をそのままコピーして担当者に送ってください。こちらで設定状態を確認できます。

7. 7

   Claude Code から使ってみる

   ここまでで設定は完了です。最後に、実際に動くところまで確認します。Claude Code を起動して、次のように頼んでみてください。

   コピーlark-cli を使って、今日の自分のLarkカレンダーの予定を一覧にしてください。

   予定が表示されれば、Claude Code から Lark が操作できる状態になっています。予定が無い日は「予定なし」と返ってきますが、それでも成功です。

   設定はこれで終わりです。何ができるか・どう頼むかは、このページの後半「使い方」に続きます。

• 設定ファイル~/.lark-cli/config.json%USERPROFILE%\.lark-cli\config.json
• トークン設定ファイルとは別の安全な場所に保存されます（macOS はキーチェーン）
• 更新lark-cli update