全部產品
Search

搜尋本產品

    Alibaba Cloud Linux：管理配置

    文件中心

    Alibaba Cloud Linux：管理配置

    更新時間：Mar 28, 2026

    Alibaba Cloud Linux 4 Agentic Edition（Agentic OS）通過分層配置體系管理認證、模型、工具等設定，支援專案級與使用者級設定檔多層覆蓋。本文介紹了三種認證方式（API Key、Qwen 登入、阿里雲 AK/SK）的接入方法、模型切換操作，以及設定檔的層級優先順序和核心配置項說明。

    1 認證方式

    Agentic OS 第一次啟動需要通過認證串連大語言模型服務。後續可以用 /auth命令切換認證方式。

    目前支援三種認證方式。

    API Key（OpenAI 相容端點）

    在互動式介面選擇「OpenAI」，準備 API Key 和 Base URL，支援的 OpenAI 相容端點包括：

    • 各雲廠商的模型服務

    • 本地部署的模型（如 vLLM、Ollama）

    • 第三方 API 代理服務等。

    Qwen 登入

    使用 qwen.ai 帳號登入。在互動式介面選擇「Qwen OAuth (免費)」，隨後終端顯示授權 URL 和二維碼。在瀏覽器中開啟該 URL 或手機掃描二維碼，完成 qwen.ai 帳號登入並授權。

    阿里雲 AK/SK

    在互動式介面選擇「Aliyun AK/SK」，使用阿里雲 AccessKey 進行認證，可獲得一定的免費額度。

    擷取 AK/SK：

    1. 登入阿里雲控制台

    2. 在 AccessKey 管理頁面建立 Key

    通過阿里雲 AK/SK 認證的使用者可享受免費調用額度，適合個人開發與測試使用。

    ⚠️注意：阿里雲 AK/SK 認證方式僅支援使用 qwen 系列文本模型，不支援多模態模型。

    認證管理

    操作

    命令

    查看當前認證狀態

    /auth

    切換認證方式

    /auth（在互動菜單中選擇）

    登出

    /auth logout

    常見問題：認證失敗時，檢查 API Key 是否正確（注意前後空格）、網路是否能訪問對應的 API 端點。可 /bash 切換到 bash 命令列使用 co --debug 啟動查看詳細錯誤資訊。Agentic OS 支援同時配置多種認證，會按優先順序選擇，也可通過 /auth 手動切換。

    2 模型配置

    切換模型

    使用 /model 命令切換當前會話使用的模型：

    > /model
# 彈出可用模型列表，選擇目標模型

    3 設定檔

    互動式配置

    使用 /setting命令進入互動介面，可以修改大部分配置。

    配置層級與優先順序

    Agentic OS 的 系統 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

    強制認證方式