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:account、stats、tokens、logs 和 tasks。
在 CometAPI Console → Personal Settings 生成 access token。
通过以下任一方式进行设置:
CLI 采用以下安全实践:
- API key 和 access token 绝不会被完整记录或显示。诊断输出中只会显示最后 4 个字符。
- 配置文件会使用严格的权限(
0600)创建——仅文件所有者可读。
- 凭据绝不应提交到版本控制中。如果适用,请将配置文件路径添加到你的
.gitignore。
你需要对使用你的 API key 所产生的所有用量和费用负责。请妥善保管你的密钥;如果怀疑存在未经授权的访问,请轮换密钥。
故障排查