Skip to main content
CometAPI CLI 会从 TOML 配置文件、环境变量和命令行标志中读取设置。当同一设置可从多个来源获取时,优先级顺序为: CLI 标志 > 配置文件 > 环境变量 > 默认值

配置文件

位置:~/.config/cometapi/config.toml 运行设置向导以交互方式创建配置文件:
或者使用 config 子命令管理单个设置:

可用设置

凭据

CLI 使用两种类型的凭据:

API key

所有命令都必需。API key 用于对发送到 CometAPI 模型端点的请求进行身份验证。 CometAPI Console → API Keys 创建 API key。 通过以下任一方式进行设置:

Access token

可选。以下账户级命令需要 access token:accountstatstokenslogstasks CometAPI Console → Personal Settings 生成 access token。 通过以下任一方式进行设置:

安全

CLI 采用以下安全实践:
  • API key 和 access token 绝不会被完整记录或显示。诊断输出中只会显示最后 4 个字符。
  • 配置文件会使用严格的权限(0600)创建——仅文件所有者可读。
  • 凭据绝不应提交到版本控制中。如果适用,请将配置文件路径添加到你的 .gitignore
你需要对使用你的 API key 所产生的所有用量和费用负责。请妥善保管你的密钥;如果怀疑存在未经授权的访问,请轮换密钥。

故障排查