翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Q 設定を構成する

Amazon Q には、設定を通じて動作をカスタマイズするためのさまざまな方法が用意されています。これらの設定には、グラフィカルインターフェイスとコマンドラインの両方のオプションからアクセスできます。

アクセス設定

Amazon Q の設定には、次の 2 つの方法でアクセスできます。

コマンドラインから設定を管理する

次のコマンドを使用して、コマンドラインから直接 Amazon Q の設定を管理できます。

q settings コマンドを使用する場合は、出力形式を指定できます。

q settings --format [FORMAT]

使用可能な形式

使用可能な設定リファレンス

以下のセクションでは、使用可能なすべての Amazon Q CLI 設定をカテゴリ別に整理して説明します。各設定には、キー名、説明、想定値タイプ、例が含まれます。

テレメトリとプライバシーの設定

チャットインターフェイスの設定

ナレッジベース設定

キーバインディング

機能の切り替え

API とサービスの設定

モデルコンテキストプロトコルの設定

一般的な設定例

一般的な設定シナリオをいくつか示します。

基本的な設定

# Enable telemetry
q settings telemetry.enabled true

# Set default chat model
q settings chat.defaultModel "claude-3-sonnet"

# Disable greeting message
q settings chat.greeting.enabled false

ナレッジベースの設定

# Enable knowledge base
q settings chat.enableKnowledge true

# Set file patterns to include
q settings knowledge.defaultIncludePatterns '["*.py", "*.js", "*.md", "*.txt"]'

# Set file patterns to exclude
q settings knowledge.defaultExcludePatterns '["*.log", "node_modules", ".git", "*.pyc"]'

# Set maximum files to index
q settings knowledge.maxFiles 2000

機能設定

# Enable experimental features
q settings chat.enableThinking true
q settings chat.enableTangentMode true
q settings chat.enableTodoList true
q settings chat.enableCheckpoint true

# Configure key bindings
q settings chat.tangentModeKey "t"
q settings chat.delegateModeKey "d"

設定の表示と管理

# View all configured settings
q settings list

# View all available settings with descriptions
q settings list --all

# View specific setting
q settings chat.defaultModel

# Export settings as JSON
q settings list --format json-pretty > my-settings.json

# Delete a setting
q settings --delete chat.defaultModel

設定のトラブルシューティング

設定を使用する際の一般的な問題と解決策:

無効な設定値

値の設定時にエラーが発生した場合:

設定のリセット

設定をデフォルトにリセットするには:

# Delete individual settings
q settings --delete setting.name

# Open settings file for manual editing
q settings open

# View current settings to identify issues
q settings list --all

設定ファイルの問題

設定ファイルが破損した場合:

その他の Amazon Q CLI コマンド

Amazon Q には、設定管理以外の多くのコマンドライン機能が用意されています。使用可能なすべてのコマンドとその引数の包括的なリファレンスについては、「Amazon Q CLI コマンドリファレンス」を参照してください。

コマンドに関するヘルプについては、--help フラグを使用します。

q [COMMAND] --help