TeamCity CLI

TeamCity CLI 是 TeamCity 的官方命令行接口。在终端输入 teamCity ，即可启动构建、查看日志、管理代理和队列等。

功能

留在终端中操作。 — 启动构建、视图日志、管理队列 — 无需浏览器。
远程代理访问 — 通过 teamcity agent term shell 进入任意构建代理，或用 teamcity agent exec 运行命令。
实时日志 — 使用 teamcity run watch --logs 实时流式传输构建输出。
可脚本化 — 针对流水线输出 --json 和 --plain ，还能通过 teamcity api 直接访问 REST API。
多服务器支持 — 多个 TeamCity 实例间可认证和切换。
AI 智能体已就绪 — 内置技能，适用于 Claude Code、Cursor 及其他 AI 编码代理 —— 只需运行 teamcity skill install。

安装 TeamCity CLI

Homebrew（推荐）：

brew install jetbrains/utils/teamcity

安装脚本：

curl -fsSL https://jb.gg/tc/install | bash

Winget（推荐）：

winget install JetBrains.TeamCityCLI

PowerShell（安装脚本）：

irm https://jb.gg/tc/install.ps1 | iex

npm（跨平台）：

npm install -g @jetbrains/teamcity-cli

其他方法（Scoop、Chocolatey、deb/rpm 软件包、源码构建），可参见入门指南。

快速入门

# Authenticate with your TeamCity server
teamcity auth login

# List recent builds
teamcity run list --limit 10

# Start a build and watch it run
teamcity run start MyProject_Build --branch main --watch

# View logs from the latest build of a job
teamcity run log --job MyProject_Build

# Check what's in the queue
teamcity queue list

  

详细操作可见 TeamCity CLI 入门。

可执行的操作

主题	描述
入门	安装、认证并运行首个命令
身份验证	令牌存储、访客访问、多服务器配置和 CI/CD 用法
配置	配置文件、环境变量与 shell 补全
关联仓库	通过 `teamcity.toml` 绑定仓库（或单仓库子目录）到 TeamCity 项目
运行管理	启动、监控和管理构建
流水线管理	编辑、验证并同步 `.teamcity.yml` 流水线
作业管理	视图并配置构建配置
项目管理	浏览项目，管理 VCS 根、参数和版本化设置
构建队列管理	检查排队的构建、控制优先级并批准构建
代理管理	远程监控、控制与访问构建代理
代理池管理	将项目和代理分配到池
云代理管理	管理云配置文件、镜像和临时代理实例
REST API 访问	通过命令行进行 API 认证请求
别名	创建自定义命令快捷键
脚本与自动化	JSON 输出、纯文本模式与 CI/CD 集成
命令参考	所有可用命令与标志的快速参考
AI 代理集成	为 AI 编码代理安装 TeamCity 技能
术语表	CLI 术语定义及与 TeamCity 概念的对应关系
匿名用法统计	CLI 会向 JetBrains 发送哪些信息以及如何选择退出

2026年 8月 6日