Qoder

安装

1. 前往 Qoder 官网下载并安装 Qoder。

2. 初次启动后完成初始配置并登录 Qoder 账号。

配置接入凭证

1. 在界面右上角打开 Qoder 设置，选择模型，点击添加。

2. 模型配置信息如下：

   配置项	说明
   提供商	在下拉菜单中选择 阿里云百炼 - 国内
   类型	根据计费方案选择 Token Plan、Coding Plan 或 按量付费
   模型	在下拉菜单中选择模型，仅支持文本生成模型。
   API Key	填写对应方案的专属 API Key： Token Plan 团队版：获取 API Key Coding Plan：获取 API Key 按量计费：获取 API Key

3. 点击添加，通过校验后即可完成模型配置。

4. 在模型列表中选择对应模型即可开始使用。

安装

1. 在终端执行以下命令安装。

   curl -fsSL https://qoder.com/install | bash

2. 验证安装是否成功。

   qodercli --version

   若输出版本号，则安装成功。

登录 Qoder

使用前需完成身份验证，有两种方式：

1. 通过 TUI 登录（推荐）

   1. 执行 qodercli 进入交互界面，在对话框中输入 /login。

   2. 选择 login with browser 或 login with qoder personal access token 完成登录。

2. 通过环境变量登录

   适用于非交互式环境（如 CI/CD 流水线）。将 your_personal_access_token_here 替换为实际的 Token，可在 服务集成页面获取。

   macOS/Linux

   export QODER_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

   Windows

   set QODER_PERSONAL_ACCESS_TOKEN=your_personal_access_token_here

配置接入凭证

1. 在对话框中输入 /model，通过 Tab 键切换至 Custom。

2. 回车选择 Add custom model，提供商选择 Alibaba Cloud Model Studio - China，类型根据计费方案选择 Token Plan、Coding Plan 或 按量付费。

3. 选择模型后输入对应方案的专属 API Key，确认后等待配置生效。

使用 Qoder CLI

1. 重启 Qoder CLI。

   qodercli

2. 在对话框中输入 /model，通过 Tab 键切换至 Custom，选择已配置的模型即可开始使用。

错误码

配置过程中遇到报错，请参考对应计费方案的常见问题文档：

• Coding Plan：Coding Plan 常见问题

• Token Plan 团队版：Token Plan 团队版常见问题

为什么在 Qoder 设置中找不到模型选项？

可能有以下原因：

• 未完成登录：需要先完成登录，才能进行对话和配置模型。

• 当前版本不支持：建议更新至最新版本（0.16.0 及以上）。