すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Linux:構成管理

    ドキュメントセンター

    Alibaba Cloud Linux:構成管理

    最終更新日:Mar 28, 2026

    Alibaba Cloud Linux 4 Agentic Edition (Agentic OS) は、認証、モデル、ツールの設定を管理するための階層的な構成システムを採用しています。このシステムでは、プロジェクトレベルおよびユーザーレベルの設定ファイルによって上位の設定をオーバーライドできます。本ドキュメントでは、API キー、Qwen ログイン、Alibaba Cloud AK/SK の 3 種類の認証方式について説明します。また、モデルの切り替え方法や、設定ファイルにおける優先順位の階層および主要な設定項目についても解説します。

    認証方式

    Agentic OS を初めて起動する際には、大規模言語モデルサービスに接続するために認証が必要です。後から /auth コマンドを使用して認証方式を切り替えることができます。

    Agentic OS は現在、以下の 3 種類の認証方式をサポートしています。

    API キー (OpenAI 互換エンドポイント)

    インタラクティブインターフェイスで「OpenAI」を選択し、API キーとベース URL を入力します。サポートされる OpenAI 互換エンドポイントには以下が含まれます。

    • 各クラウドプロバイダーのモデルサービス

    • vLLM や Ollama などのローカルにデプロイされたモデル

    • サードパーティの API プロキシサービス

    Qwen ログイン

    qwen.ai アカウントでログインします。インタラクティブインターフェイスで「Qwen OAuth (Free)」を選択すると、ターミナルに認証用の URL と QR コードが表示されます。ブラウザでその URL を開くか、スマートフォンで QR コードをスキャンして、qwen.ai へのログインおよび権限付与を完了してください。

    Alibaba Cloud AK/SK

    インタラクティブインターフェイスで「Alibaba Cloud AK/SK」を選択し、Alibaba Cloud の AccessKey を使用して認証します。この方式では無料利用クォータが提供されます。

    AK/SK の取得方法:

    1. Alibaba Cloud コンソールにログインします。

    2. AccessKey 管理ページでキーを作成します。

    Alibaba Cloud AK/SK による認証では無料利用クォータが提供されるため、個人での開発やテストに適しています。

    ⚠️注意: Alibaba Cloud AK/SK 認証方式は Qwen シリーズのテキストモデルのみをサポートしており、マルチモーダルモデルはサポートしていません。

    認証管理

    操作

    コマンド

    現在の認証状態の確認

    /auth

    認証方式の切り替え

    /auth (インタラクティブメニューから選択)

    ログアウト

    /auth logout

    トラブルシューティング: 認証が失敗した場合は、API キーに前後の空白文字が含まれていないことを確認し、ネットワークから対応する API エンドポイントにアクセス可能であることをご確認ください。/bash コマンドで bash コマンドラインに切り替え、co --debug を実行することで、詳細なエラーメッセージを確認できます。Agentic OS は複数の認証方式を同時に設定できます。システムは優先度に基づいていずれかの方式を選択しますが、/auth コマンドを使用して手動で切り替えることも可能です。

    モデル構成

    モデルの切り替え

    現在のセッションで使用するモデルを切り替えるには、/model コマンドを使用します。

    > /model
# 利用可能なモデルの一覧が表示されます。目的のモデルを選択してください。

    設定ファイル

    インタラクティブ設定

    /setting コマンドを使用すると、ほとんどの設定を変更できるインタラクティブインターフェイスが開きます。

    設定の階層と優先順位

    Agentic OS System Shell のエントリポイントである cosh は、JSON 形式の設定ファイルを使用して設定を管理します。設定は以下の優先順位（上から下へ向かって優先度が低下）で適用されます。

    コマンドライン引数 > 環境変数 > プロジェクト設定 > ユーザー設定 > デフォルト値

    設定ファイルの保存場所

    種別

    パス

    説明

    ユーザー設定

    ~/.copilot/settings.json

    個人用のグローバル設定。

    プロジェクト設定

    .copilot/settings.json (プロジェクトのルートディレクトリ内)

    チームで共有可能なプロジェクト固有の設定。

    主要な設定項目

    general — 一般設定

    パラメーター

    型

    デフォルト

    説明

    preferredEditor

    string

    —

    ファイルを開く際に使用するエディター。

    vimMode

    boolean

    false

    Vim キーバインドを有効にします。

    enableAutoUpdate

    boolean

    true

    自動的に更新をチェックします。

    checkpointing.enabled

    boolean

    false

    セッションのチェックポイントを有効にします。

    defaultFileEncoding

    string

    "utf-8"

    デフォルトのファイルエンコーディング。

    model — モデル設定

    パラメーター

    型

    デフォルト

    説明

    name

    string

    —

    使用するモデルの名前。

    maxSessionTurns

    number

    -1

    会話セッションにおける最大ターン数。

    chatCompression.contextPercentageThreshold

    number

    0.7

    チャットコンテキストを圧縮するしきい値。

    tools — ツール設定

    パラメーター

    型

    デフォルト

    説明

    approvalMode

    string

    "default"

    ツール実行時にユーザー承認を必要とするタイミングを定義します。

    sandbox

    boolean/string

    —

    ツール実行時のサンドボックス環境を指定します。

    core

    array

    —

    有効化されたツールのリスト（ホワイトリスト）を指定します。

    exclude

    array

    —

    明示的に除外するツールのリスト。

    allowed

    array

    —

    承認を必要としないツール。

    context — コンテキスト設定

    パラメーター

    型

    デフォルト

    説明

    fileName

    string/array

    "COPILOT.md"

    コンテキストファイルの名前。

    includeDirectories

    array

    —

    コンテキストに含める追加ディレクトリ。

    fileFiltering.respectGitIgnore

    boolean

    true

    .gitignore ファイル内のルールを尊重するかどうかを指定します。

    security — セキュリティ設定

    パラメーター

    型

    説明

    folderTrust.enabled

    boolean

    フォルダ信頼メカニズムを有効または無効にします。

    auth.selectedType

    string

    現在選択されている認証方式。

    auth.enforcedType

    string

    ユーザー選択を上書きする強制的な認証方式を指定します。