CometAPI CLI 会从 TOML 配置文件、环境变量和命令行标志中读取设置。当同一个设置可从多个来源提供时，优先级顺序为：
CLI 标志 > 配置文件 > 环境变量 > 默认值 配置文件 位置：~/.config/cometapi/config.toml
运行设置向导以交互方式创建配置文件：
或者使用 config 子命令管理单个设置：
# View current configuration cometapi config show # Set a value cometapi config set api_key sk-... # Remove a value cometapi config unset api_key # Show the config file path cometapi config path
可用设置 Config key Environment variable Description api_keyCOMETAPI_KEYAPI 密钥（所有命令均必需） access_tokenCOMETAPI_ACCESS_TOKEN用于账户级命令的访问令牌 base_urlCOMETAPI_BASE_URLAPI 基础 URL（默认值：https://api.cometapi.com/v1） default_modelCOMETAPI_DEFAULT_MODELchat 的默认模型（回退值：gpt-5.4）output_format— 默认输出格式：table、json、yaml、csv 或 markdown
CLI 使用两种类型的凭据：
API key 所有命令都必需。API 密钥用于对发往 CometAPI 模型端点的请求进行身份验证。
在 CometAPI Console → API Keys 创建 API 密钥。
通过以下任一方式进行设置：
Environment variable
Config file
Setup wizard
export COMETAPI_KEY = "<COMETAPI_KEY>"
Access token 可选。以下账户级命令需要访问令牌：account、stats、tokens、logs 和 tasks。
在 CometAPI Console → Personal Settings 生成访问令牌。
通过以下任一方式进行设置：
Environment variable
Config file
Setup wizard
export COMETAPI_ACCESS_TOKEN = "your-access-token"
CLI 采用以下安全实践：
API 密钥和访问令牌绝不会被记录日志或完整显示。在诊断输出中只会显示最后 4 个字符。
配置文件会以受限权限（0600）创建——仅文件所有者可读。
凭据绝不应提交到版本控制中。如适用，请将配置文件路径添加到你的 .gitignore。
你需要对使用你的 API 密钥所产生的所有用量和费用负责。请妥善保管你的密钥；如果你怀疑存在未授权访问，请轮换这些密钥。
故障排查 Error Solution API key not configured运行 cometapi init 或设置 COMETAPI_KEY 环境变量 Connection failed运行 cometapi doctor 以诊断连接问题 Access token not configured仅 account/stats/tokens/logs/tasks 需要。运行 cometapi init 添加一个
