Qoder 智能体工作台接入完整指南

Qoder 智能体工作台接入完整指南

2026年8月27日阿里发布了全新Qoder——这不是一次普通升级，而是从「Coding编程助手」到「人人可用的智能体工作台」的质变。600万累计用户、10万企业客户沉淀下来的Agent Harness基座，让它既能服务专业开发者做复杂工程，也能让产品经理、设计师、运营人员用自然语言就能把创意变成可运行的成果。

本教程采用双路径接入模式，无论你喜欢图形界面交互还是偏好配置文件掌控一切，都能找到适合自己的接入方式。

双路径接入对比

前置准备

在开始之前，请确保你已经完成以下准备工作：

• 已注册阿里账号（淘宝/钉钉/支付宝任一即可）
• 操作系统为 Windows 10+ 或 macOS 12+
• 至少 5GB 可用磁盘空间（模型缓存+运行时）
• 网络可正常访问公网（首次安装需要下载组件）

方式 A：桌面应用交互路径

步骤一：下载并安装全新Qoder客户端

前往官网下载对应系统的安装包。

1. 打开浏览器访问 Qoder 官网
2. 点击右上角「下载客户端」按钮
3. 选择 Windows (.exe) 或 macOS (.dmg) 安装包
4. 下载完成后双击运行安装程序
5. 按安装向导完成安装，勾选「创建桌面快捷方式」

步骤二：登录账号并领取初始 Credits

首次启动后完成登录和权益领取。

1. 启动 Qoder，登录界面支持淘宝/钉钉/支付宝扫码登录
2. 扫码授权后自动进入工作台初始化
3. 初始化完成后，点击右下角「Credits 领取横幅」
4. 弹出的权益面板中点击「立即领取」，领取当天的 500 Qwen Credits
5. 领取成功后右上角会显示当前剩余 Credits

⚠️ 重要警告：Credits 每日领取时间为 10:00 整，数量有限先到先得。如果错过了当天的领取时间，也可以先跳过，用个人账号绑定的自有模型 API Key 工作。

步骤三：选择工作模式并创建第一个项目

Qoder 提供编程模式和通用模式两种模式，按需选择。

1. 工作台首页左侧点击「新建项目」
2. 模式选择（关键一步）：
   • 如果你要写代码、做开发项目 → 选「编程模式」
   • 如果你要搭原型、处理数据、做自动化工具、写PPT → 选「通用模式」
3. 填写项目名称和简要描述
4. 模型选择：新手推荐选「Auto 自动调度」，进阶可手动挑选
5. 点击「创建项目」进入工作区

1常见模式选择判断：
2✅ 产品经理要做个"批量压缩设计素材"的小工具 → 通用模式
3✅ 前端工程师开发 Vue 组件库 → 编程模式
4✅ 运营同学要自动爬取周报数据并生成可视化 → 通用模式
5✅ 后端工程师接 API + 写数据库迁移 → 编程模式
6✅ 设计师要批量重命名+裁切200张图片 → 通用模式

步骤四：启用桌面宠物与实时语音（可选增强）

这是全新Qoder最有特色的功能——不用打开窗口就能发指令。

1. 进入项目后，点击顶部菜单栏「设置 → 偏好设置」
2. 切换到「桌面宠物」标签页
3. 打开「启用桌面宠物」开关
4. 选择宠物形象（猫/狗/机器人三种可选）
5. 打开「实时语音唤醒」开关，按提示完成麦克风授权
6. 点击「测试唤醒词」，说一句"你好Qoder"验证识别是否正常

步骤五：验证配置是否生效

通过一个简单任务确认接入正常。

1. 在对话框中输入："帮我生成一个个人博客首页的HTML页面，带导航栏、Hero区域和三篇文章卡片"
2. 观察桌面宠物状态——它会从"思考中 🤔"→"编码中 👨‍💻"→"完成 ✅"
3. 通用模式下会自动弹出浏览器预览页面
4. 编程模式下会在项目目录生成完整代码并打开文件树
5. 点击右上角「运行」按钮，确认页面能正常渲染

🎉 方式A接入完成！ 你已经可以通过Qoder完成日常任务了。如果需要更深度的定制（比如团队统一模型、接入内部系统），继续看方式B。

方式 B：配置文件手动路径

适合需要精细控制模型参数、连接器配置、团队统一标准的场景。所有配置均通过 JSON 文件管理，可纳入 Git 版本控制。

步骤一：定位配置文件目录

Qoder 安装后会在用户目录下自动创建配置文件夹。

1Windows: C:\Users\<用户名>\.qoder\config\
2macOS:   ~/.qoder/config/

核心配置文件结构：

1~/.qoder/
2├── config/
3│   ├── settings.json        # 全局设置（模型、模式、桌面宠物等）
4│   ├── connectors.json      # 40+连接器配置（GitHub/飞书/钉钉等）
5│   ├── plugins.json         # 70+插件开关与参数
6│   └── skills/              # 20K+技能库的自定义技能目录
7├── cache/                   # 模型缓存目录
8└── logs/                    # Agent 执行日志

步骤二：编辑 settings.json 配置模型与全局参数

全局配置决定Qoder的默认行为。打开 settings.json：

1{
2  "mode": "auto",
3  "defaultModel": {
4    "scheduler": "auto",
5    "overrides": {
6      "coding": "qwen3.8-72b-instruct",
7      "creative": "qwen3.8-14b-chat",
8      "analysis": "qwen3.8-72b-instruct"
9    }
10  },
11  "desktopPet": {
12    "enabled": true,
13    "avatar": "cat",
14    "voiceWake": true,
15    "wakeWord": "你好Qoder"
16  },
17  "agentHarness": {
18    "maxThinkingSteps": 30,
19    "autoVerifyOutput": true,
20    "maxRetryOnFailure": 3
21  },
22  "runtime": {
23    "sandboxEnabled": true,
24    "autoInstallDependencies": true,
25    "timeoutSeconds": 600
26  },
27  "credits": {
28    "autoRechargeThreshold": 100,
29    "autoRechargeAmount": 1000
30  }
31}

关键参数说明：

步骤三：配置 connectors.json 打通外部生态

40+连接器让Qoder能和你的真实工作流打通。以常用的GitHub、飞书、钉钉为例：

1{
2  "github": {
3    "enabled": true,
4    "authType": "token",
5    "token": "ghp_你的GitHub_Personal_Access_Token",
6    "defaultOrg": "your-org-name",
7    "autoCreatePR": true
8  },
9  "feishu": {
10    "enabled": true,
11    "appId": "cli_你的飞书应用ID",
12    "appSecret": "你的飞书应用Secret",
13    "defaultDocFolderToken": "你的文档目录token"
14  },
15  "dingtalk": {
16    "enabled": true,
17    "accessKey": "钉钉开放平台AccessKey",
18    "accessSecret": "钉钉开放平台AccessSecret",
19    "notifyRobotWebhook": "群机器人Webhook地址"
20  }
21}

步骤四：验证配置加载并应用

保存配置文件后无需重启Qoder，它会热加载。执行以下验证：

1. 打开Qoder桌面应用，进入「设置 → 高级设置 → 配置管理」
2. 点击「重新加载配置」按钮，确认右上角显示「配置已热加载 ✓」
3. 点击「测试连接器」按钮，依次测试 GitHub、飞书、钉钉是否返回「连接成功」
4. 在对话框输入："读取我GitHub上 my-org/my-repo 仓库的 README 并生成摘要"
5. 如果能正常拉取并生成摘要 → 连接器配置生效

故障排查

下一步

完成基础接入后，你可以继续探索：

• 在「技能库」中启用 20K+ 现成技能，覆盖SEO、数据分析、文档生成等垂直场景
• 在「插件市场」启用 70+插件扩展能力（Figma转代码、浏览器自动化、数据库直连等）
• 编程模式下启用「多仓库协同」，让Agent同时跨多个代码库工作
• 接入更多连接器（Jira、Notion、MySQL、企业微信等）打造个性化智能体