AgenticX: Command for Claude Code

setup-feishu-cli

从安装到配置多个飞书企业账号。一个 profile 对应一个开放平台应用，对应一个企业。飞书客户端里登了几个企业，不会自动变成几条 profile。

官方安装页：飞书 CLI。命令与多账号说明以 larksuite/cli 的中文 README 为准。

命令名

• 对话里使用：/setup-feishu-cli
• 可选参数：要配置的企业清单。用户没给清单时，先列出已有 profile，再问还要加哪几个企业。

硬性边界

• 只改本机 lark-cli 配置（钥匙串 / ~/.lark-cli）。不要把 App Secret、device code、用户令牌写入仓库、plan、commit 或 mcp.json。
• 回复用户时不回显 App Secret。添加 profile 时 Secret 只从 stdin 进入 lark-cli profile add --app-secret-stdin。
• 不使用 config init 覆盖已有默认应用。已有 App ID 时用 profile add，不要再 --new 出一个重复应用。
• 未经用户点名，不执行 profile use、profile remove。单次操作用 --profile "<名称>"。
• 同一轮只发起一个企业的浏览器授权。展示授权链接和二维码后结束本轮，等用户说做完了，再执行 --device-code。不要在同一轮里阻塞等待。
• 授权失败且 CLI 写明「请勿持续重试」时，不要立刻重开登录。把缺的 scope 告诉用户。

第一步：安装

需要本机有 Node.js（npm / npx）。源码编译才需要 Go 1.23+ 和 Python 3。

先检查：

command -v lark-cli && lark-cli -v

已有可执行文件就跳过安装，向用户报告版本和路径。没有则用官方一行安装（飞书 CLI 安装页 与 README 的推荐方式）：

npx @larksuite/cli@latest install

装完再跑 command -v lark-cli && lark-cli -v。新开的 shell 找不到命令时，提示用户新开终端，或执行 hash -r。

源码安装只在用户明确要求时使用：

git clone https://github.com/larksuite/cli.git
cd cli
make install
npx skills add larksuite/cli -y -g

npm 安装脚本若没有装上 Agent skills，补一次：

npx skills add larksuite/cli -y -g

用 lark-cli skills list 确认能看到 lark-shared。不要把社区包 feishu-mcp 或 @larksuiteoapi/lark-mcp 当成这个 CLI。

第二步：看清已有账号

lark-cli profile list
lark-cli whoami

向用户说明：active: true 是以后不写 --profile 时的默认身份。tokenStatus: valid 且 user 非空，才算用户身份可用。只有 bot、没有 user 的 profile 不能读该用户的知识库和云文档。

第三步：逐个企业接入

对用户点名的每一个企业单独做完下面一整段，再开始下一个。

3.1 已有应用

用户提供该企业的 App ID 和 App Secret。profile 名称用用户指定的短名（例如企业简称），不要用 App ID 当名字，除非用户要求。

python3 - << 'PY'
import subprocess
secret = """PASTE_SECRET"""
proc = subprocess.run(
    [
        "lark-cli", "profile", "add",
        "--name", "PROFILE_NAME",
        "--app-id", "APP_ID",
        "--app-secret-stdin",
        "--lang", "zh_cn",
    ],
    input=secret,
    text=True,
    capture_output=True,
)
print(proc.stdout)
print(proc.stderr)
raise SystemExit(proc.returncode)
PY
lark-cli --profile "PROFILE_NAME" whoami