studio-cli 安装与认证

studio-cli 是给 AI IDE 用户（Cursor / Claude Code / Codex）的命令行工具。它让你在写代码时把 Aiko Studio 项目里的 BRD/PRD 当作 AI 上下文 注入到 IDE，而不是手动粘贴提示词。

前置条件

Node.js 20+
你的团队已经有 Aiko Studio 工作台，并且你能登录
Aiko Studio 地址：https://studio.aiko.geekstorm.com.cn

安装

通过 npm 全局安装：

npm install -g @ai-partner-x/aiko-studio-cli

或者用 npx 一次性跑（不安装）：

npx @ai-partner-x/aiko-studio-cli --help

安装到项目而不是全局

如果想随项目走（把 CLI 锁版本进 package.json）：

npm install -D @ai-partner-x/aiko-studio-cli

然后用 npx studio-cli 调用。

验证安装：

studio-cli --version
# 输出例如：0.1.13

配置 Studio URL

CLI 连哪个 Aiko Studio 实例，由配置文件或环境变量决定。

方式 1：环境变量（推荐用于 CI / 临时调试）

export STUDIO_API_URL=https://studio.aiko.geekstorm.com.cn
export STUDIO_API_TOKEN=stk_xxx_yyy

方式 2：配置文件（推荐日常开发）

studio-cli config set api-url https://studio.aiko.geekstorm.com.cn
studio-cli config set api-token stk_xxx_yyy

配置存在 ~/.aiko-studio/config.json。再次运行 studio-cli 会自动加载。

查看当前配置：

studio-cli config list

获取 API Token

从 Aiko Studio 工作台获取：

登录工作台 https://studio.aiko.geekstorm.com.cn
右上角头像 → 个人设置 → API Tokens
点 「创建 Token」，写一个备注（例如"Cursor 集成"）
复制 stk_... 开头的 token —— 这是唯一一次能看到完整值，关掉就只能重建
选择 token 的权限范围：通常选「读取我有权限的项目和文档」

Token 是密钥

不要把 token 提交到 git。.aiko-studio/config.json 默认在 ~/，安全；如果你用环境变量在 .env，记得 .gitignore。

验证连通

跑一个不需要参数的命令试试：

studio-cli whoami

预期输出：

登录身份: alice@example.com
显示名:   Alice Wang
有权限的项目数: 7

如果失败，常见原因：

错误	原因	处理
`ECONNREFUSED`	Studio URL 不通	检查 `STUDIO_API_URL` 或网络
`401 Unauthorized`	token 错或已过期	重新生成
`403 Forbidden`	token 权限范围不够	在工作台改 token 权限
`Unknown command`	CLI 版本太老	`npm install -g @ai-partner-x/aiko-studio-cli@latest`

第一个有用的命令：列项目

studio-cli project list

输出：

ID                       NAME                  TYPE
proj_01h...              电商商品管理 v2        电商类项目
proj_02k...              内部 CRM 改造          内部工具
...

记下你想集成的项目 ID，下一步上下文注入工作流会用到。

下一步

把项目文档作为上下文注入 Cursor / Claude Code：上下文注入工作流
集成示例：Cursor / Claude Code 配置
完整命令参考：studio-cli 命令表

studio-cli 安装与认证

On this page