全部產品
Search

搜尋本產品

    Alibaba Cloud Linux：管理配置

    文件中心

    Alibaba Cloud Linux：管理配置

    更新時間：Sep 11, 2026

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

    1 認證方式

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

    目前支援以下認證方式。

    阿里雲認證

    在互動式介面選擇「Aliyun Authentication」，可獲得一定的免費額度。

    • 在 ECS 環境中，終端顯示授權 URL 和二維碼。在瀏覽器中開啟該 URL 或手機掃描二維碼，完成阿里雲帳號登入並授權

    • 在非 ECS 環境中，使用阿里雲 AK/SK 認證

      • 擷取 AK/SK：

        1. 登入阿里雲控制台

        2. 在 AccessKey 管理頁面建立 Key

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

    注意：阿里雲認證方式僅支援使用千問系列文本模型，不支援多模態模型。

    百鍊認證

    百鍊認證已經預製好Base Url，可以選擇Coding Plan、Token Plan、以及自訂模型認證方式，提供API Key進行認證。

    OpenAI 相容端點 API Key 認證

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

    • 自訂 Base URL：本地部署的模型（如 vLLM、Ollama）、第三方 API 代理服務等。

    認證管理

    操作

    命令

    查看當前認證狀態

    /auth

    切換認證方式

    /auth（在互動菜單中選擇）
    常見問題：認證失敗時，檢查 API Key 是否正確（注意前後空格）、網路是否能訪問對應的 API 端點。Agentic OS 支援同時配置多種認證，會按優先順序選擇，也可通過 /auth 手動切換。

    2 模型配置

    切換模型

    使用 /auth 命令切換當前會話使用的模型，選擇已配置的認證配置，然後選擇"Set as active provider"。

    3 設定檔

    配置層級與優先順序

    Agentic OS 的 系統 Shell 入口 cosh 使用 JSON 格式的設定檔管理設定，優先順序從高到低：

    命令列參數 > 環境變數 > 專案配置 > 使用者配置 > 預設值

    設定檔位置

    類型

    路徑

    說明

    系統設定

    /etc/copilot-shell/config.toml

    管理員預設值

    使用者佈建

    ~/.copilot-shell/config.toml

    個人全域配置

    專案設定

    .copilot-shell/config.toml（專案根目錄）

    專案級配置，可團隊共用

    設定檔位置

    類型

    路徑

    說明

    系統設定

    /etc/copilot-shell/config.toml

    管理員預設值

    使用者佈建

    ~/.copilot-shell/config.toml

    個人全域配置

    專案設定

    .copilot-shell/config.toml（專案根目錄）

    專案級配置，可團隊共用

    cosh-core 按系統 → 使用者 → 專案的順序合并配置。專案配置可以設定 Agent、Hook、Skill、會話、active_model 和回答語言偏好，但會忽略 active_provider、Provider 定義、MCP server 和專案審計設定。cosh-shell 唯讀取使用者檔案，不讀取系統或專案檔。

    核心配置項

    ai --- AI 與模型設定

    配置項

    類型

    預設值

    說明

    active_provider

    string

    ---

    當前啟用的 Provider

    active_model

    string

    ---

    當前使用的模型名稱

    output_language

    string

    ---

    回答語言偏好

    thinking

    string

    ---

    thinking 模式偏好

    ai.providers. --- Provider 定義

    配置項

    類型

    預設值

    說明

    type

    string

    ---

    Provider 類型，如 dashscope、openai_compat、aliyun

    base_url

    string

    ---

    API 基礎 URL

    api_key

    string

    ---

    API 金鑰，建議使用 ${VAR_NAME} 環境變數展開

    model

    string

    ---

    該 Provider 的預設模型

    auth_source

    string

    ---

    認證源，如 ecs_ram_role

    access_key_id

    string

    ---

    阿里雲 Access Key ID

    access_key_secret

    string

    ---

    阿里雲 Access Key Secret

    security_token

    string

    ---

    阿里雲 Security Token

    explicit_cache

    boolean

    false

    是否啟用顯式緩衝

    agent --- Agent 行為設定

    配置項

    類型

    預設值

    說明

    approval_mode

    string

    "recommend"

    Core 審批模式：recommend、auto、trust

    max_turns

    number

    50

    單次 Agent 請求的最大輪次

    max_tool_calls_per_turn

    number

    10

    每輪最大工具調用數

    session_token_limit

    number

    128000

    會話 token 限制

    allowed_tools

    array

    []

    免審批的工具列表

    session --- 會話管理

    配置項

    類型

    預設值

    說明

    auto_persist

    boolean

    true

    是否自動持久化會話

    persist_dir

    string

    "~/.copilot-shell/cosh-core/sessions"

    會話持久化目錄

    session.compaction --- 會話壓縮

    配置項

    類型

    預設值

    說明

    enabled

    boolean

    true

    啟用壓縮

    auto

    boolean

    true

    自動壓縮

    trigger_ratio

    number

    0.70

    觸發正常壓縮的上下文比例

    emergency_ratio

    number

    0.90

    觸發緊急保護的上下文比例

    target_ratio

    number

    0.30

    壓縮後的目標上下文比例

    preserve_recent_runs

    number

    2

    保留的最近完整 Agent 運行數

    auto_compact_token_limit

    number

    ---

    可選的絕對觸發 token 限制

    model_context_window

    number

    ---

    模型上下文視窗覆蓋值

    model_max_output_tokens

    number

    ---

    模型最大輸出 token 覆蓋值
    必須保持 target_ratio <= trigger_ratio <= emergency_ratio。

    shell --- Shell 互動設定

    配置項

    類型

    預設值

    說明

    default

    string

    "auto"

    預設 shell

    adapter_default

    string

    "cosh-core"

    預設適配器

    analysis_mode

    string

    "smart"

    分析模式：smart、auto、manual

    approval_mode

    string

    "auto"

    Shell 審批模式：recommend、auto、trust

    integration

    string

    "enhanced"

    Shell 整合模式：enhanced（預設，啟用 marker hook 支援 AI 路由與命令事件，Shift+Tab 可在 Assisted 與 Shell-only 之間切換）、native（無 Hook，Shell 擁有全部輸入）

    input_wait_timeout_secs

    number

    120

    輸入等待逾時秒數，0 表示禁用

    trusted_commands

    array

    []

    受信任的命令列表

    trusted_project_roots

    array

    []

    受信任的專案根目錄列表

    shell.recommendations --- Shell 建議

    配置項

    類型

    預設值

    說明

    enabled

    boolean

    true

    是否啟用 Shell 建議

    bash_history

    boolean

    false

    是否使用 Bash history 產生建議

    ui --- 介面設定

    配置項

    類型

    預設值

    說明

    language

    string

    "auto"

    UI 語言

    startup_banner

    boolean

    true

    啟動橫幅

    startup_hooks

    boolean

    false

    啟動鉤子

    debug

    boolean

    false

    偵錯模式

    log_level

    string

    "warn"

    UI 記錄層級

    skills --- 技能設定

    配置項

    類型

    預設值

    說明

    enabled

    boolean

    false

    是否啟用自訂技能

    custom_paths

    array

    []

    自訂技能路徑列表

    logging --- 日誌設定

    配置項

    類型

    預設值

    說明

    level

    string

    "warn"

    記錄層級

    mcp.servers. --- MCP 伺服器

    MCP client 只能定義在系統或使用者配置中。每個 server 使用 command（stdio）或 url（Streamable HTTP）之一；省略 allowed_tools 表示暴露全部工具，[ ] 表示不暴露工具。

    配置項

    類型

    預設值

    說明

    command

    string

    ---

    stdio 伺服器可執行檔路徑

    url

    string

    ---

    Streamable HTTP 端點

    args

    array

    []

    命令列參數

    env

    table

    {}

    環境變數

    timeout_ms

    number

    10000

    請求逾時毫秒

    startup_timeout_ms

    number

    30000

    啟動逾時毫秒

    allowed_tools

    array

    ---

    允許暴露的工具列表

    health --- 健全狀態檢查

    配置項

    類型

    預設值

    說明

    enabled

    boolean

    true

    是否啟用健全狀態檢查

    role

    string

    ---

    角色標識

    memory_sensitive

    boolean

    false

    記憶體敏感模式

    critical_mounts

    array

    ["/"]

    關鍵掛載點列表

    verbose

    boolean

    false

    詳細輸出模式

    health.services 使用 TOML 數組表定義：

    [[health.services]]
name = "nginx"
expected = "active"

    audit --- 審計設定

    系統檔案包含 [audit] 表時，以系統設定為準；否則使用使用者佈建。專案審計表會被忽略。

    配置項

    類型

    預設值

    說明

    mode

    string

    "best_effort"

    審計模式：best_effort 或 required

    retention_days

    number

    30

    審計資料保留天數

    max_disk_bytes

    number

    1073741824

    審計資料最大磁碟佔用位元組