如何把全新 Qoder 智能体工作台接入终端

8 月 27 日，阿里把 Qoder 从一款 AI 编程 IDE 升级为面向所有人的智能体工作台：以编程智能体为核心引擎，告诉它你想完成什么，它会自己理解上下文、制定计划、调用工具、执行并验证，整个过程随时可查看、调整或接管。截至发布日，Qoder 累计全球用户超 600 万、企业客户超 10 万。

对开发者来说，全新 Qoder 最值得接入的两个面是 Qoder CLI（终端原生、本地协同）和 Qoder Cloud Agents（API 驱动、云端自治）。本文给出一套终端接入双路径，两条路任选其一即可让 Agent 围绕目标自主「读 — 改 — 验证 — 迭代」。

两条接入路径对比

方式 A：用 Qoder CLI 在终端本地协同开发

第 1 步：下载并安装 Qoder CLI

国际版与中国版客户端独立，按你所在网络选择其一（账号通用）：

1# 国际版（海外网络）
2# 访问 https://qoder.com/download?product=cli 下载对应平台安装包
3
4# 中国版（原灵码，国内网络更稳）
5# 访问 https://qoder.com.cn/download 下载 CLI

macOS / Linux 也可用一行脚本安装（以官方下载页提供的安装命令为准）：

1# 以官方 install 脚本为准（下载页会给出当前最新命令）
2curl -fsSL https://qoder.com/install-cli.sh | bash

安装完成后在终端验证：

1qoder --version

能看到版本号即装好。首次进入会看到欢迎语 Welcome to Qoder CLI! 并显示当前工作目录。

第 2 步：登录并领取上线期 Credits

1qoder login

按提示在浏览器完成账号登录，回到终端即登录成功。新用户在即日起至 9 月 1 日 10:00，每天 10 点可领 500 Qwen 系列专属 Credits，最多累计 2500，建议先把额度领够再跑大任务。

第 3 步：进到项目目录，给 Agent 下一个 Goal

全新 Qoder 的核心交互是 Goal + Plan：你给一个明确目标（Goal），Agent 先想清楚路径（Plan），再围绕目标持续工作。进入你的项目目录后启动：

1cd ~/your-project
2qoder

在 Qoder 提示符里直接口述目标，例如：

Agent 会自动：检索代码库结构 → 制定 Plan → 跨文件编辑 → 运行测试 → 根据真实结果自我纠错。你随时可以查看进度、调整 Plan、或中途接管。

第 4 步：用分级权限锁住敏感操作

全新 Qoder 采用分级权限模式 + 工具白名单机制，敏感操作必须显式授权。第一次跑涉及执行命令、改动线上的任务时，Agent 会暂停并请求授权，你确认后才继续。

建议在配置里把执行类工具设为"需授权"、编辑类工具设为"允许"，避免 Agent 自作主张跑危险命令。

第 5 步：开 Auto 调度引擎省 Credits

非专业用户或想省成本时，把模型选择交给 Auto 智能调度引擎：它会根据任务类型与难度，自动平衡输出效果、运行速度与成本，无需手动挑模型。专业开发者也可手动选 Qwen3.8、GLM、DeepSeek、MiniMax、Kimi 等模型。

故障排查（方式 A）

方式 B：用 Qoder Cloud Agents API 接入云端自治

Qoder Cloud Agents 是全托管的 AI Agent 运行平台：通过 API 定义 Agent、启动 Session，即可在云端运行复杂任务并实时接收结果，支持长时运行、中断自动恢复、每次调用可追溯审计。适合批量任务、CI 集成、委派后离开工位。

第 1 步：在控制台开通 Cloud Agents 并拿 API 凭证

登录 Qoder 控制台（中国版在阿里云账号体系下），开通 Qoder Cloud Agents 服务，在「API 凭证」页拿到 AGENT_API_KEY 与接口地址。把它配到本地环境变量：

1export QODER_AGENT_API_KEY="你的凭证"
2export QODER_AGENT_BASE="控制台给出的接口地址"

第 2 步：定义 Agent 并启动一个 Session

Cloud Agents 的使用范式是「定义 Agent → 启动 Session → 云端运行 → 实时接收结果」。下面是一个最小可运行示例（具体字段以官方 API 文档为准）：

1curl -X POST "$QODER_AGENT_BASE/v1/agents" \
2  -H "Authorization: Bearer $QODER_AGENT_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "name": "health-check-adder",
6    "model": "qwen3.8",
7    "goal": "为指定仓库增加 /health 健康检查接口并补冒烟测试，跑通后回报",
8    "permissions": { "mode": "standard", "allowlist": ["edit","test","git-status"] },
9    "repo": "git@github.com:your-org/your-project.git"
10  }'

拿到 agent_id 后启动一个 Session：

1curl -X POST "$QODER_AGENT_BASE/v1/agents/$AGENT_ID/sessions" \
2  -H "Authorization: Bearer $QODER_AGENT_API_KEY" \
3  -d '{ "goal": "今天 18 点前完成 /health 接口并合并到 main 分支" }'

返回 session_id 与一个结果流端点。

第 3 步：实时接收进度并取最终结果

Session 启动后云端自治运行，你通过结果流接收每次工具调用与中间产出：

1curl -N "$QODER_AGENT_BASE/v1/sessions/$SESSION_ID/events" \
2  -H "Authorization: Bearer $QODER_AGENT_API_KEY"

任务完成或需要授权时，流里会推对应事件；你也可以随时发指令调整。最终产出（改动的分支、PR、测试报告）按事件里的引用拉取即可。

故障排查（方式 B）

小结

全新 Qoder 把"编程"从开发者专属技能变成所有人可调用的通用数字执行能力：方式 A 适合在本地终端里和 Agent 一起改代码、跑测试、上线；方式 B 适合把长链路、批量任务丢到云端自治运行、随时审批。两条路共用同一套 Goal/Plan/权限/Credits 体系，按场景切换即可。

下一步可以试试给 Agent 配 40+ 连接器里的 GitHub 与项目管理工具，让它在真实工作流里跑起来——那会真正体会到「Harness 读-改-验证-迭代」长链路自治的威力。