@injectivelabs/ainj 将这些组件打包为一次安装,
让你一次配置完成,更快地开始构建。
在本教程中,你将:
- 安装 AInj
- 通过
npm全局安装 - 使用
ainj install配置 AInj 与你偏好的 harness - 使用
ainj status与ainj skills验证安装
- 通过
- 运行一条 Injective CLI 命令
- 调用一个 Injective agent skill
- 同时运行两个 Injective MCP 服务器
前置条件
Codex 和 Claude Code 只需其中一个 harness 即可。
你还需要:
- 一个具备安装全局
npm包权限的终端会话 - 一个本地项目或工作目录,让 harness 可以读取配置文件
快速开始
使用npm 全局安装 Injective AI SDK:
ainj install 会配置什么?
ainj install 会写入 AInj 状态,为所支持的 harness 配置 MCP 条目,
并安装内置的 skills,让你的 AI 工具无需手动接线即可使用 Injective 相关的提示词与传输方式。
在实际操作中,安装流程做了三件有用的事:
- 保存 AInj 状态,包括 scope、端口、默认 harness。
- 为你的 harness 配置添加 stdio 与 HTTP 传输的 MCP 条目。
- 安装 agent skills,使 harness 可以调用它们。
你必须运行一次
ainj install。
它包含交互式提示,用于配置安装。安装与配置 AInj
- 在终端中运行
ainj install。 - 在安装向导中选择相应选项
- 选择
global(推荐)。- 除非你希望配置仅在当前目录生效。
- 保留 MCP 服务器的默认端口
3001与3002(或选择其他端口)。 - 选择你希望 AInj 配置的 harness,例如
Codex或Claude Code。 - 选择你希望安装的 agent skills。
- 选择
AInj configured。
检查 AInj 安装
- 运行
ainj status。 - 查看已安装的版本、已配置的 scope、所选端口、默认 harness,以及 agent skills。
- 确认这些值都符合预期
- 如果有任何项不正确,只需重新运行
ainj install。
- 如果有任何项不正确,只需重新运行
注意,
ainj status 只显示可用 agent skills 的数量。
要查看完整的可用 skills 列表,请运行 ainj skills。运行 Injective CLI 命令
- 运行
ainj cli version,确认 AInj 能定位到内置的injectived可执行文件。 - 如果想在使用链相关命令之前查看 CLI 命令列表,运行
ainj cli --help。
注意,
ainj injectived 是 ainj cli 的别名。通过 harness 运行一个 Injective agent skill
- 启动你偏好的 harness(例如 Codex 或 Claude Code)。
- 输入一个引用先前已安装 agent skill 的提示词
- 例如,如果你想在 Injective 上构建智能合约或 dApp:
- 在 Codex 中使用
$injective-evm-developer (… 你的智能合约 / dApp 思路) - 在 Claude Code 中使用
/injective-evm-developer (… 你的智能合约 / dApp 思路)
- 之后 agent skill 会被加载到上下文窗口中, 你就可以与之交互。
注意,harness 应该会为 skill 名称提供 Tab 补全,
即当你输入
$inj(Codex)或 /inj(Claude Code)时,应有若干 Injective 相关的
agent skills 供你选择。如果这样做后没有出现名称匹配的 skills,
很可能是你还没有安装它们。
重新运行 ainj install 以重新安装 agent skills。启动文档 MCP 服务器
- 在一个专门的终端窗口中运行
ainj mcp docs http。- 服务器运行期间保持该终端打开。
- 将 MCP 客户端连接到
http://localhost:3002/mcp。- 如果你配置了非默认端口,请相应修改端口号。
- 发起一些 MCP 工具调用。
或者,如果你还没有 MCP 客户端,
可以将一个 inspector 指向同一 URL,用来查看可用工具并手动发起工具调用。
启动主 Injective MCP 服务器
- 运行
ainj mcp main http。- 打开另一个终端窗口,以便同时运行文档服务器(如果你希望两个 MCP 服务器同时运行)。
- 服务器运行期间保持该终端打开。
- 将 MCP 客户端连接到
http://localhost:3001/mcp- 如果你配置了非默认端口,请相应修改端口号。
- 发起一些 MCP 工具调用
下一步
你已经完成 AInj 的安装、配置,并让它在涵盖 CLI、agent skills 与 MCP 服务器的多种工作流中运行。 以下是你学到的内容:- 如何将 AInj 作为 Injective AI 开发的统一入口进行安装
- 如何通过
ainj install配置 harness 集成与 MCP 端口 - 如何通过
ainj status与ainj skills验证安装 - 如何使用 CLI、agent skills 与两个 MCP 服务器
