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：
登录阿里云控制台
在 AccessKey 管理页面创建 Key
通过阿里云 AK/SK 认证的用户可享受免费调用额度，适合个人开发和测试使用。
⚠️注意：阿里云 AK/SK 认证方式仅支持使用 qwen 系列文本模型，不支持多模态模型。
认证管理
操作 | 命令 |
查看当前认证状态 |
|
切换认证方式 |
|
登出 |
|
常见问题：认证失败时，检查 API Key 是否正确（注意前后空格）、网络是否能访问对应的 API 端点。可 /bash 切换到 bash 命令行使用co --debug启动查看详细错误信息。Agentic OS 支持同时配置多种认证，会按优先级选择，也可通过/auth手动切换。
2 模型配置
切换模型
使用 /model 命令切换当前会话使用的模型：
> /model
# 弹出可用模型列表，选择目标模型3 配置文件
交互式配置
使用 /setting命令进入交互界面，可以修改大部分配置。
配置层级与优先级
Agentic OS 的 系统 Shell 入口 cosh 使用 JSON 格式的配置文件管理设置，优先级从高到低：
命令行参数 > 环境变量 > 项目配置 > 用户配置 > 默认值配置文件位置
类型 | 路径 | 说明 |
用户设置 |
| 个人全局配置 |
项目设置 |
| 项目级配置，可团队共享 |
核心配置项
general — 通用设置
配置项 | 类型 | 默认值 | 说明 |
| string | — | 打开文件使用的编辑器 |
| boolean | false | 启用 Vim 键绑定 |
| boolean | true | 自动检查更新 |
| boolean | false | 启用会话检查点 |
| string | "utf-8" | 文件编码 |
model — 模型设置
配置项 | 类型 | 默认值 | 说明 |
| string | — | 使用的模型名称 |
| number | -1 | 最大会话轮数 |
| number | 0.7 | 上下文压缩阈值 |
tools — 工具设置
配置项 | 类型 | 默认值 | 说明 |
| string | "default" | 审批模式 |
| boolean/string | — | 沙箱环境 |
| array | — | 工具白名单 |
| array | — | 排除的工具 |
| array | — | 免确认的工具 |
context — 上下文设置
配置项 | 类型 | 默认值 | 说明 |
| string/array | "COPILOT.md" | 上下文文件名 |
| array | — | 额外包含的目录 |
| boolean | true | 遵守 .gitignore |
security — 安全设置
配置项 | 类型 | 说明 |
| boolean | 启用目录信任机制 |
| string | 当前认证方式 |
| string | 强制认证方式 |