文档快照 · CLI 7.30.1 · SDK 2.6.53。Desktop 使用其发行版随附的运行时。命令和示例保留英文原文。英文原文

连接首个模型提供方

选择连接方式

提供方负责连接模型服务；模型是通过这条连接选择的具体模型。连接提供方并不意味着选择了全部模型，也不会自动获得账户权限。

在终端界面输入 /connect，然后选择以下路径。Desktop 使用独立的提供方设置和内置运行时；这里的斜杠命令用于终端界面。

云端 API：选择 API Cloud Provider，找到服务并按照提示填写凭据。聊天订阅未必包含 API 使用权限或 API 额度。
编程 CLI：先安装受支持的 CLI 并登录，再选择 CLI Provider。AX Code 复用本地登录状态；具体能力取决于适配器。
本地模型：启动 Ollama 或 LM Studio，加载支持工具调用的模型，然后选择 Local LLM runtime 并确认端点。受支持的 Mac 可通过 AX-Engine runtime 完成专用设置和模型下载。
网关：AX Trust 端点请选择 AX Trust，其他网关请选择 API Cloud Provider → Custom API provider，专用兼容部署请选择 Private GPU cloud。填写服务地址、令牌以及服务实际公布的模型 ID。

在交互式终端中运行以下命令。登录命令会要求选择提供方并输入凭据；不要将真实密钥粘贴到共享命令或仓库文件中。

ax-code providers login
ax-code providers list
ax-code models

正常情况下应能看到提供方和可用模型 ID。保存凭据或成功获取模型列表，都不能单独证明具备推理权限。继续阅读模型选择并发送一个小型测试请求。

使用 /providers 管理连接，通过 /connect 更换密钥。禁用会保留已保存的凭据；断开连接会删除已保存的凭据。环境变量及配置中的密钥仍可能提供访问权限。

项目 ax-code.json 用于共享的非敏感设置，全局 ~/.config/ax-code/ax-code.json 用于个人默认值。不要将机密提交到版本控制；使用提供方的凭据提示，或网关指南介绍的环境变量引用。手动编辑配置后请重启。

身份验证失败：确认密钥属于所选服务、端点和 API 套餐。编程 CLI 请先检查其自身的登录状态。
模型列表为空或连接被拒绝：确认本地服务已启动、模型已加载，地址和端口无误。Ollama 通常使用 http://localhost:11434/v1；LM Studio 使用 http://localhost:1234/v1。
模型被拒绝：使用端点返回的准确 ID，并检查账户权限。网关的显示名称可能不同于上游请求 ID。
找不到提供方：检查 enabled_providers 和 disabled_providers。安装诊断可运行 ax-code doctor；该命令不会验证提供方账户。