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
可用設定 設定鍵 環境變數 說明 api_keyCOMETAPI_KEYAPI key（所有命令皆必需） access_tokenCOMETAPI_ACCESS_TOKEN帳戶層級命令所需的 access token base_urlCOMETAPI_BASE_URLAPI 基底 URL（預設：https://api.cometapi.com/v1） default_modelCOMETAPI_DEFAULT_MODELchat 的預設 model（後備值：gpt-5.4）output_format— 預設輸出格式：table、json、yaml、csv 或 markdown
CLI 使用兩種類型的憑證：
API key 所有命令皆需要。API key 用於驗證對 CometAPI 模型端點發出的請求。
請在 CometAPI Console → API Keys 建立 API key。
可用以下其中一種方式設定：
Environment variable
Config file
Setup wizard
export COMETAPI_KEY = "<COMETAPI_KEY>"
Access token 選用。帳戶層級命令需要 access token：account、stats、tokens、logs 與 tasks。
請在 CometAPI Console → Personal Settings 產生 access token。
可用以下其中一種方式設定：
Environment variable
Config file
Setup wizard
export COMETAPI_ACCESS_TOKEN = "your-access-token"
安全性 CLI 會採用以下安全性實務：
API key 與 access token 絕不會被完整記錄或顯示。診斷輸出中只會顯示最後 4 個字元。
設定檔會以嚴格權限 (0600) 建立——只有檔案擁有者可讀取。
憑證絕不應提交到版本控制。如果適用，請將設定檔路徑加入你的 .gitignore。
你需對使用你的 API key 所產生的所有用量與費用負責。請妥善保管你的金鑰，若懷疑有未經授權的存取，請輪替金鑰。
疑難排解 錯誤 解決方案 API key not configured執行 cometapi init 或設定 COMETAPI_KEY 環境變數 Connection failed執行 cometapi doctor 以診斷連線問題 Access token not configured僅 account/stats/tokens/logs/tasks 需要。執行 cometapi init 來新增一個
