CometAPI CLI は、TOML の config ファイル、環境変数、コマンドラインフラグから設定を読み取ります。同じ設定を複数のソースから取得できる場合、優先順位は次のとおりです。
CLI フラグ > config ファイル > 環境変数 > デフォルト Config file 場所: ~/.config/cometapi/config.toml
対話形式で config ファイルを作成するには、セットアップウィザードを実行します。
または、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 説明 api_keyCOMETAPI_KEYAPI キー（すべてのコマンドで必須） 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 は 2 種類の認証情報を使用します。
API key すべてのコマンドで必須です。API key は CometAPI の model エンドポイントへのリクエストを認証します。
API key は CometAPI Console → API Keys で作成できます。
次のいずれかの方法で設定します。
Environment variable
Config file
Setup wizard
export COMETAPI_KEY = "<COMETAPI_KEY>"
Access token 任意です。access token は、アカウントレベルのコマンド account、stats、tokens、logs、tasks に必要です。
access token は CometAPI Console → Personal Settings で生成できます。
次のいずれかの方法で設定します。
Environment variable
Config file
Setup wizard
export COMETAPI_ACCESS_TOKEN = "your-access-token"
セキュリティ CLI では、次のセキュリティ運用が適用されています。
API キーと access token がログに記録されたり、完全な形で表示されたりすることはありません。診断出力には末尾 4 文字のみが表示されます。
config ファイルは制限されたパーミッション（0600）で作成され、ファイル所有者のみが読み取れます。
認証情報をバージョン管理にコミットしてはいけません。必要に応じて、config ファイルのパスを .gitignore に追加してください。
API キーの使用によって発生するすべての利用と課金については、あなたが責任を負います。不正アクセスの疑いがある場合は、キーを安全に保管し、ローテーションしてください。
トラブルシューティング Error Solution API key not configuredcometapi init を実行するか、COMETAPI_KEY 環境変数を設定してくださいConnection failed接続性を診断するには cometapi doctor を実行してください Access token not configured必要なのは account/stats/tokens/logs/tasks のみです。追加するには cometapi init を実行してください
