跳转到内容
Ticos Docs

CLI

@ticos/cli 是面向开发者和 AI 编程智能体（如 Claude Code, Cursor, Windsurf）的命令行入口。它允许你将 Ticos 的平台能力直接集成到你的本地开发环境或 CI/CD 流水线中。

快速开始

无需全局安装，直接使用 npx 运行：

Terminal window
npx -y @ticos/cli --help

核心命令

1. npx -y @ticos/cli mcp

启动 Ticos MCP Server。

用途：让 AI 编程工具（如 Claude Code）能够直接读取你的机器人列表、机型配置和智能体状态。

  • Claude Code：在 ~/.claude-code/config.json 中配置。
  • Cursor/Windsurf：在设置中的 MCP 部分添加该命令。

2. npx -y @ticos/cli deploy

触发配置发布流程。

用途：在 CI/CD 环境中自动同步你的本地配置文件（如智能体提示词、工具定义）到 Ticos 云端。这确保了你的生产环境配置始终与代码仓库同步。

环境变量

通过环境变量配置 CLI 的行为，避免在命令中显式传递敏感信息：

变量说明默认值
TICOS_API_URLTicos 后端 API 地址https://api.ticos.cn
TICOS_API_KEY你的平台 API 密钥(无)

示例：集成到 Claude Code

在你的项目中运行以下命令，让 Claude 能够帮助你管理机器人：

Terminal window
# 临时运行
npx -y @ticos/cli mcp


# 或者作为 Claude Code 的工具永久配置
# 编辑 ~/.claude-code/config.json
{
  "mcpServers": {
    "ticos": {
      "command": "npx",
      "args": ["-y", "@ticos/cli", "mcp"],
      "env": {
        "TICOS_API_URL": "https://api.ticos.cn",
        "TICOS_API_KEY": "你的_API_KEY"
      }
    }
  }
}

相关文档