安装 Figena CLI 并运行第一条命令

概述

Figena CLI 把已获批准的 Figena 工作带进终端。你可以通过浏览器登录、运行已发布的智能体版本、管理知识库、调用 OpenPort 操作，每条命令都会返回人和脚本都能读懂的明确结果。

环境要求

• Node.js 22。figena doctor 会把其他 Node 版本报告为不受支持。
• 一个 Figena 账号，所在工作区已获批开通 CLI。
• 终端能够访问 Figena API：https://api.figena.com/api。

安装 CLI

用你常用的包管理器全局安装：

npm install -g @figena/cli

运行 figena --version 确认安装成功，它会输出 CLI 包名、版本和 Node.js 版本。

三步完成配置

1. 1创建一个指向 Figena API 的 profile。config init 同时会把它设为当前 profile。
2. 2登录。浏览器会打开 Figena 的授权页面，在页面上批准请求。
3. 3运行 figena doctor 检查配置。

figena config init --profile production --api-base-url https://api.figena.com/apifigena auth loginfigena doctor

看懂 doctor 报告

figena doctor 会逐项检查并列出结果：

• node：Node.js 版本，必须是 22.x。
• profile 和 apiBaseUrl：当前使用的 profile，以及是否配置了 API 地址。
• auth：是否有可用的登录会话或 Agent Key。
• storePermissions：本地配置文件和凭据文件是否只有你自己的用户能读取。
• apiVersion 和 apiHealth：API 是否响应版本和健康检查。

只有 Node.js 版本不受支持或缺少 API 地址会阻断配置，此时报告最后显示“Doctor found blocking issues”。缺少凭据只会提示，不会阻断，因为你可以之后再登录。

查看帮助

运行 figena help、figena --help 或 figena -h 可以列出全部命令。输入未知命令时也会显示这份列表，并以退出码 2 结束。

下一步

1. 1为 Figena CLI 认证：浏览器登录、Agent Key，以及凭据的保存位置。
2. 2配置 profile：为多个工作区或环境分别保存设置。
3. 3在脚本中使用 CLI 输出：输出格式、结果字段和退出码。