Codacy Cloud CLI(codacy)是 Codacy Cloud 的命令行界面,用于与远程 Codacy 数据交互,区别于在本地运行静态分析的 Codacy Analysis CLI。
用途与能力:查询仓库、问题、安全发现、拉取请求、工具与模式;支持触发重新分析、忽略问题或发现、导入本地配置、链接编码标准等。可用 --output json 输出机器可读结果。数据反映 HEAD 提交状态,配置变更需下次分析才生效;组织级编码标准不可在仓库级覆盖。
安装与认证:npm install -g @codacy/codacy-cloud-cli。认证方式:设置环境变量 export CODACY_API_TOKEN=,或 codacy login,或 codacy login --token 。令牌获取见 Codacy 账户访问管理页面。用 codacy info 验证。Cloud CLI 与 Analysis CLI 共享 ~/.codacy/credentials 凭据。
常用命令:codacy info;codacy repositories <provider> <org>;codacy repository gh my-org my-repo;codacy issues gh my-org my-repo;codacy issue gh my-org my-repo <issueId>;codacy findings gh my-org my-repo;codacy finding gh my-org my-repo <findingId>;codacy pull-request gh my-org my-repo <prNumber>;codacy tools、codacy patterns、codacy pattern。在仓库内运行时,CLI 会自动从 git remote origin 推断 provider、组织和仓库。
重新分析与导入:codacy repository gh my-org my-repo --reanalyze-and-wait(-w)可触发并等待重新分析并报告增量;--reanalyze 为不等待。codacy tools gh my-org my-repo --import 从本地 .codacy/codacy.config.json 导入配置,可用 -y 跳过确认、--force 先解除标准链接。
限制:具体命令与行为以 --help 为准;本地 .codacy/codacy.config.json 仅用于本地分析,提交到仓库不影响 Cloud,需用 --import 同步。