把大模型用起来

面向第一次使用大模型平台的教师、学生与工作人员。无需先学编程，也无需自己部署大模型。

本指南介绍智能体的基本概念、工具选择和平台接入方法，帮助师生使用平台模型完成学习、科研与办公任务。建议先读第 1—4 节，再选择一种工具完成配置，最后完成第 9 节练习。新手推荐从 dsh 桌面版开始。 平台申请流程、模型服务与接口说明见用户指南首页。

您将学会： 分清人、智能体、平台与模型；认识四款智能体并选择使用版本；申请并保管 API Key；填写网关地址和模型名称；判断连接是否成功。

继续学习：加入「词元计划」成长营

“词元计划”是中国科学技术大学网络信息中心面向在校师生推出的 AI 应用与数字素养提升计划。「词元计划」成长营（词元成长营） 是其中的实践与分享空间：这里汇集学习、科研和日常工作中的 AI 使用经验，也提供智能体接入指南和共享的 Skills（可复用的 AI 技能）。刚入门的读者可以从案例开始，有经验的读者也可以分享自己的方法，在交流中积累经验、练习 Git 协作。

学习与实践入口：进入「词元计划」成长营 →

完成本教程后，可以接着做三件事：

• 看案例： 到实践成果分享看看别人遇到了什么问题、用了什么方法、得到了什么结果。
• 查方法： 参考智能体接入指南和共享 Skills，寻找适合自己任务的工具与用法。
• 分享实践： 先完成一个自己的小任务，再按成长营参与说明整理问题、过程和收获，与其他成员交流。

更新日期：2026 年 9 月 22 日。示例中的 API Key 均为占位符，使用时请替换为您在平台申请的 Key。可用模型以项目授权列表为准；客户端界面随版本更新可能有所调整。

1. 先看懂：谁在做什么？

假设您想完成一件事：“阅读这份会议记录，整理出待办事项，并保存为文件。”

图 1 的读法： 人把目标交给智能体；智能体带着 API Key，通过平台网关调用模型；模型返回文字或工具调用请求；智能体在授权范围内执行工具，并把结果反馈给模型或交给人验收。一个任务可能循环多次。

平台的网关是模型服务的统一入口。项目管理、身份认证、模型调用与用量管理属于平台提供的能力，详见平台介绍。

什么是“通用智能体”？

通用智能体（Agent）是围绕目标完成多步骤任务的助手。 您告诉它想得到什么结果，它会结合模型能力，安排步骤、使用工具、检查过程，再交付结果。这里的“通用”，指它能通过不同工具处理多类任务，例如整理材料、处理数据、编写程序；实际能力取决于所接模型、已安装的工具和授权范围。

可以把它理解为一套工作组合：大模型负责理解和推理，工具负责具体操作，智能体把步骤组织起来，人决定目标与边界。

例如，您可以问“怎样整理会议记录”，得到操作建议；也可以把记录文件交给有文件工具的智能体，说“整理成待办表并保存”。后一种任务要经历读取、分析、生成和检查等步骤，这正是本文要学习的使用方式。

三个容易混淆的地方

• 智能体名称与模型名称是两回事。 DeepSeek Harness（dsh）、WorkBuddy、Claude Code、Codex 是本文介绍的工具；DeepSeek、Qwen 等是模型家族。工具能接哪些模型，要看其接口与兼容性。
• 模型请求调用工具，智能体实际执行工具。 能否读文件、运行程序或使用浏览器，还取决于智能体提供的工具和您授予的权限。
• “本地安装智能体”不等于“模型在本地运行”。 使用平台网关时，智能体会把完成任务所需的提示词和相关材料发送给模型服务。选择材料时应遵守学校及课题组的数据使用要求。

2. 认识四款智能体：它们能帮您做什么？

下面介绍的是四种助手工具的侧重点。您只需选择适合自己任务的一款，不必全部安装。示例任务用于帮助理解用途，能否完成还要看实际模型和工具配置。

DeepSeek Harness（dsh）：可扩展的任务助手

它是什么： DeepSeek 开源的智能体框架。Harness 可以理解为“让模型持续完成工作的运行环境”：它组织会话、文件工具、任务计划和其他扩展能力。dsh 支持以插件组合这些能力，适合从一个练习文件夹开始，逐步学习多步骤任务。DeepSeek Harness 项目介绍

可以交给它的任务： 阅读项目资料、整理文本文件、编写和运行数据处理脚本、解释或修改代码。例如：“阅读这个文件夹里的课程说明，整理实验清单，保存为 Markdown 表格。”

适合谁、怎样开始： 希望用学校模型处理本地资料，或逐步扩展科研、教学工作流的用户。本文推荐 DSH Desktop 桌面版作为新手入口，通过安装包打开图形界面，再配置平台网关；命令行方式留作补充。本文选用的桌面发行版由社区维护，来源和安装步骤见第 5 节。

WorkBuddy：面向日常办公的桌面助手

它是什么： 腾讯推出的桌面智能体工作台。您通过自然语言发起任务，在界面中查看执行过程与交付文件；它面向文档、表格、演示文稿、资料研究和文件处理等办公场景，也提供编程相关能力。WorkBuddy 产品介绍与快速入门

可以交给它的任务： 汇总会议记录、整理工作报告、分析数据文件、制作演示材料。例如：“根据这份活动记录，整理一页工作总结和下一步待办。”

适合谁、怎样开始： 希望以图形界面完成教学和行政办公任务、较少接触终端的用户。安装桌面客户端，在“自定义模型”中接入本平台，然后在任务里选择对应模型。配置步骤见第 6 节。

Claude Code：以项目和代码为中心的智能体

它是什么： Anthropic 提供的编程智能体，能够理解代码项目、编辑多个文件、运行命令并检查结果。常见使用入口包括终端、代码编辑器和桌面应用；本文的网关示例采用命令行入口。Claude Code 产品介绍

可以交给它的任务： 解释陌生项目、修改实验程序、定位报错、编写测试、自动化重复操作。例如：“解释这个数据分析脚本，找出报错原因，修复后运行一次检查。”

适合谁、怎样开始： 已接触编程、科研脚本或项目开发的用户。平台已完成 Claude Code 兼容适配，可通过统一网关调用本地部署的模型。通过第 7 节的接入指南完成配置，即可在项目文件夹中开始使用。

Codex：帮助开发、检查与自动化的智能体

它是什么： OpenAI 提供的智能体工具。桌面界面可以组织任务、选择工作目录并查看文件和修改结果；代码相关任务还可以通过命令行或代码编辑器扩展完成。本文优先介绍桌面使用流程。桌面应用介绍、Codex CLI 产品介绍

可以交给它的任务： 生成或改进科研脚本、理解代码仓库、修复问题、审查修改。例如：“为这批 CSV 文件写一个汇总脚本，用示例数据验证，并说明运行方法。”

适合谁、怎样开始： 希望把自然语言需求落实为代码、文件或自动化流程的用户。新手先用桌面界面选择练习文件夹、发起任务、查看结果。Codex 需使用 Responses 接口，接入条件与配置说明见第 8 节。

我该先用哪个？

选择智能体是在选择工作方式；选择模型是在选择提供理解与推理能力的服务。 同一工具接上不同模型，表现可能不同；使用同一个模型的两款工具，也可能因为工具、插件和任务组织方式不同而产生不同结果。

桌面版与其他版本怎样区分？

“桌面版、网页版、命令行版”描述的是您从哪里操作助手，并不直接决定模型在哪里运行。

校园平台连接设置应跟着具体客户端填写。比如“桌面应用登录账号”“平台 API Key”“某个终端里的临时变量”，是不同层面的设置，不能互相替代。

3. 配置只需先认清四个信息

把智能体接入平台，可以理解成告诉助手：用什么交流格式、去哪个入口、带哪张通行证、找哪个模型。

图 2 是通用配置示意，不是某个产品的实际截图。具体字段名称与地址格式，请按后面的工具示例填写。

平台基础地址、鉴权方式与模型列表查询方法见API 使用。本教程以 deepseek-v4-flash 为例，请使用项目已授权的模型。

网关地址不是网页登录地址

这里的“网关”指模型 API 服务入口，不是电脑的网络代理设置。学校统一身份认证密码也不是 API Key。

“OpenAI 兼容”表示接口格式兼容。 使用中科大网关时，请求指向中科大提供的地址；这并不表示您正在使用 OpenAI 官网账户或 OpenAI 的模型。

4. 在平台上准备好 Key 和模型

1. 打开平台首页，通过学校统一身份认证登录。
2. 进入项目管理，创建一个用途明确的项目，例如“课程资料整理助手”。
3. 在项目详情的 API Key 管理中创建 Key，及时保存。完整 Key 仅在创建时显示。
4. 查看项目能使用的模型，记录准确的模型 ID。不了解如何选择时，可以先核对平台推荐的 deepseek-v4-flash 是否在您的可用列表中。
5. 后续完成一次调用后，回到平台查看调用统计，确认请求记在预期项目下。

具体页面与申请规则以申请流程为准。模型能力比较请看模型服务；入门阶段先用文本任务，再考虑图片、长文档和复杂推理。

Key 的保管方式： 只填入可信客户端的密钥设置；不要放进聊天提示词、课件截图、共享文档或公开代码。误泄露后应在平台撤销旧 Key，再生成新的 Key。

四款工具，选一款即可开始

首次接入建议先使用第 5 节的 dsh 桌面版，办公用户也可选择第 6 节 WorkBuddy。 配置完成后，依次进行文本问答和文件任务练习；需要工具调用时，请选择具备相应能力的模型。平台协议支持

5. 示例一：DeepSeek Harness（dsh）桌面版

本节介绍 DSH Desktop 桌面版 的接入步骤，推荐新手用安装包开始。它把 DeepSeek Harness 放进桌面窗口，并负责启动本机运行环境，无需另装 Node.js 或手动输入启动命令。模型计算仍通过本平台完成。

版本说明：配置截图展示 DSH Desktop v2.0.13 界面。DeepSeek Harness 是 DeepSeek 开源项目；桌面安装包可参考 dataelement 社区发行版。不同桌面发行版的界面可能略有差异，网关、密钥与模型字段按下方说明填写。

桌面版第一步：下载、安装、打开

1. 打开DSH Desktop 项目下载页，选择稳定发行版。
2. Windows 用户选择 Windows x64 Setup；Mac 用户按芯片选择 Apple Silicon / M 系列或 Intel 安装包。其他系统与架构以该项目当前支持列表为准。
3. 按安装提示完成安装，打开 DSH Desktop，等待本机服务启动。
4. 如果首次出现模型服务商向导，选择 “稍后配置”，随后按下一步添加本平台。

平台 API Key 应填写在平台网关对应的自定义提供方中。首次向导中的默认 DeepSeek 服务商连接 DeepSeek 官网接口，请选择“稍后配置”，再按下面的步骤添加本平台。

桌面版第二步：添加本平台

进入 设置 → 模型 → 添加自定义提供方，填写：

这里选择自定义提供方。内置 DeepSeek 提供方对应另一条服务路由；要使用学校 Key，应把 Key 与平台网关配在一起。

点击“获取可用模型”，勾选模型并添加；如果没有获取到列表，也可以手动添加准确的模型 ID，然后保存。字段与模型发现功能见dsh 配置模型。

补充配置文件参数： 图形界面中的配置项可能无法覆盖全部模型参数。如需调整上下文长度、输出词元上限等设置，可在设置窗口右上角点击“打开配置文件”，按词元成长营 DeepSeek Harness 接入指南中的详细说明补充或调整参数。

对照图中红框依次填写，API 地址保留 /v1，API 协议选择 openai-completions。模型 ID 请从项目可用列表中复制，保留完整名称及后缀。

桌面版第三步：选工作区、选模型、发消息

点击“选择工作区”，添加并选中练习文件夹；再在模型选择器中选中刚添加的本平台模型，新建会话。工作区未选中时，输入框可能不可用。dsh 使用 Web UI

发送：

请用三句话介绍大模型公共服务平台。此次只回答文字，不操作文件。

图中右下角显示当前使用的模型，红框标出收到的回答。此步骤用于检查连接；平台功能与服务范围请参阅平台介绍。

正常得到回答后，再做第 9 节的文件练习。如果出现参数不兼容，先保留错误信息，并参考官方“请求兼容性”说明；请逐项检查协议、地址和密钥。

其他方式：本机 Web UI

已经使用桌面版的读者可以跳过这一小节。需要直接运行上游 DeepSeek Harness 时，按官方安装说明准备 Node.js，在练习文件夹中打开终端并运行：

npx @deepseek-ai/dsh web

浏览器通常会打开本机界面，默认地址为 http://127.0.0.1:3080。然后按“设置 → 模型 → 添加自定义提供方”填写同一组平台网关信息，并选好工作区。桌面发行版与独立启动的 Web UI 可能使用不同的数据目录，不能假定已有 Key、会话和设置会自动同步。

6. 示例二：WorkBuddy 桌面版

第一步：打开自定义模型设置

按WorkBuddy 官方安装入口安装并打开客户端。进入 左下角账户 → 设置 → 模型 → 自定义模型 → 添加模型，提供商选择 自定义 / Custom。

腾讯云接入示例演示的是 WorkBuddy 的设置入口；本节使用的是中科大平台地址与 Key，无需照搬其腾讯云模型服务账户配置。

第二步：填写这三个值

注意地址差异： 本文 WorkBuddy 入口填完整接口，包含 /chat/completions；上一节 dsh 的 Base URL 则填到 /v1。这一差异来自客户端字段的含义，不能简单给所有软件粘贴同一个地址。WorkBuddy 官方接入示例

截图为 WorkBuddy 5.5.6。按红框填写后，可点击“测试连接”，再保存配置。图中的模型名称是该项目的配置示例，实际使用时请复制自己项目的完整模型 ID。

高级能力中的“工具调用”“图片输入”“推理模式”应按所选模型和网关的实际支持情况设置；勾选开关不会增加模型本身的能力。初次测试先使用纯文本。

“自定义协议”开关影响 URL 路径的校验与自动补全，不代表自动转换为 Anthropic 或 Responses 接口。本文使用标准 Chat Completions 路径，可先保留默认设置。WorkBuddy 模型配置说明

第三步：保存后，在对话中选中它

保存配置，回到对话页面，从模型选择框中明确选中刚添加的自定义模型，再发送上一节的三句话测试。仅保存配置，并不代表当前对话已经切换到本平台。

核对输入框下方及回答旁显示的模型名称。图中回答为模型生成的连通性测试示例，不作为平台功能说明；正式介绍请参阅平台首页。

普通问答成功后，在任务中选择或授权练习文件夹，完成第 9 节的文件练习；再到本平台查看用量是否增加。

7. 示例三：使用 Claude Code 接入平台本地模型

平台已完成 Claude Code 的兼容适配，具备完整兼容性，支持通过统一网关使用本地部署的模型。 您可以在 Claude Code 中调用平台提供的 DeepSeek、Qwen 等模型，开展代码编写、文件处理、多轮交互和工具调用任务。

这里的“本地模型”指由本平台部署和提供服务的模型。Claude Code 在您的电脑上组织任务、操作获准访问的文件，模型推理通过平台网关完成，无需在个人电脑上部署模型。

配置与使用指南

打开词元成长营 Claude Code 接入指南 →

Claude Code 的安装、网关与 API Key 配置、模型选择及使用方法，请直接参阅上述指南。配置完成后，可继续完成本教程第 9 节的实践任务，并在平台查看项目调用记录。

8. 示例四：Codex 桌面版与其他版本

本节以 Windows 桌面版为主。 日常使用从桌面图标进入：选择练习文件夹、新建任务、输入要求、检查生成文件。首次接入自定义网关还需要设置用户配置和 API Key；这一步与日常使用界面分开进行。

接入要求：Codex 使用 Responses 接口，wire_api 设置为 responses。 接入前请联系平台运维，确认该接口的开通范围、服务地址及适用模型；本节提供桌面版配置方法。Codex 配置参考

尚未获得 Responses 接入配置的用户，可先使用 dsh、WorkBuddy 或 Claude Code 调用平台模型。请保留 wire_api = "responses"，不要改为 chat。

桌面版第一步：安装并找到配置入口

从OpenAI 桌面应用官方入口安装适合系统的应用。不同版本的应用名称及入口可能调整，以官方下载页面为准。如果首次启动停在 OpenAI 登录页面，先按下面的文件路径完成自定义提供方配置，再重启应用；不要把平台网关 Key 直接填进标为“OpenAI API key”的登录框。

Windows 可用 Ctrl + , 打开设置；macOS 为 Cmd + ,。进入 “设置 → 配置 → 用户配置 → 打开 config.toml”。本节以 Codex 桌面版 26.915.4065.0 为例；其他版本可查找“自定义 config.toml 设置”，或直接用文本编辑器打开下表中的用户配置文件。应用设置、配置文件说明

Windows 用户也可在文件资源管理器地址栏输入 %USERPROFILE%\.codex，找到 config.toml 后用记事本打开。不存在时可创建，保存时确认文件名不是 config.toml.txt。

桌面版第二步：填写网关与模型

获得 Responses 接入配置后，按下方模板填写服务地址与模型 ID。已有配置请保留，并合并下面各项，避免重复定义同名字段或表。

# 下面两个根字段放在文件开头，任何 [表名] 之前。
model = "替换为已开通Responses的模型ID"
model_provider = "ustc"

[model_providers.ustc]
name = "中科大公共平台"
base_url = "https://api.llm.ustc.edu.cn/v1"
env_key = "USTC_LLM_API_KEY"
wire_api = "responses"
requires_openai_auth = false

base_url 请填写开通时提供的 Responses 基础地址；模板中的 /v1 地址用于说明配置位置。

env_key 填的是环境变量的名字 USTC_LLM_API_KEY，真实 Key 在下一步输入。requires_openai_auth = false 表示这条自定义路由使用所配置的提供方凭证。不要把 Key 字符串填到 env_key 的位置。提供方配置应放在用户配置中，当前官方说明不允许在项目配置里覆盖这一类字段。Codex 高级配置、提供方鉴权说明

桌面版第三步：让桌面应用读取 Key

本例通过名为 USTC_LLM_API_KEY 的环境变量提供学校 Key。可以把环境变量理解为“这台电脑给应用提供的一项设置”。Codex 会按照 env_key 指定的名字读取它；这是官方支持的自定义提供方鉴权方式。自定义提供方鉴权

Windows：使用系统图形设置。

1. 在开始菜单搜索并打开 “编辑帐户的环境变量”。也可以从“编辑系统环境变量 → 环境变量”进入。
2. 在上方 “用户变量” 区域点击“新建”，不要修改已有的系统路径变量。
3. 变量名填 USTC_LLM_API_KEY；变量值填本平台发放的真实 Key，不加引号或 Bearer 。
4. 保存后，彻底退出 Codex，再从开始菜单重新打开。如果仍提示缺少变量，保存工作后注销 Windows 并重新登录，再打开应用。

这一方式保存的是用户环境变量，日后从桌面图标启动也可读取。它不是密码保险箱；不要把变量值截图或复制到共享材料中。

macOS：设置桌面版启动时读取的 shell 环境。 学校统一部署时，可由管理员配置凭证。对使用默认 zsh 的用户，可用文本编辑器在 ~/.zshrc 中新增下面一行，保留原有内容，然后彻底退出并重新打开桌面应用：

export USTC_LLM_API_KEY="替换为平台API_KEY"

完成配置后，仍通过桌面窗口使用 Codex。本节所用版本会在启动时加载用户的 shell 环境；使用其他 shell 时，请写入对应的启动配置文件。若桌面应用没有读到 Key，请检查配置文件及启动脚本。仅在终端临时执行 export 的设置不会自动传递给从 Dock 打开的应用。包含 Key 的配置文件应妥善保管。

桌面版第四步：新建任务并检查结果

重新打开应用，选择本机练习文件夹并新建 Codex 任务，先发送一条简短文字请求，再完成第 9 节练习。检查任务所用模型，并到本平台核对调用记录；登录了桌面应用，并不等于已经切换到学校模型。

如果软件仍提示缺少 Key，请核对变量名并完全重启应用；如果请求 /v1/responses 返回 404，请核对开通时提供的接口地址，必要时联系平台运维。已有任务可能保留原模型设置，修改配置后请新建任务验证。

其他方式：Codex CLI 与编辑器扩展

命令行版。 喜欢终端或需要批处理时，可按Codex CLI 官方说明安装。它采用同样的用户配置；下面是只对当前终端生效的 Key 设置和启动方式：

Windows PowerShell：

$env:USTC_LLM_API_KEY = Read-Host "请输入平台 API Key"
codex

macOS / Linux（Bash、Zsh）：

export USTC_LLM_API_KEY="替换为平台API_KEY"
codex

在练习文件夹中运行这些命令。已经采用桌面版的读者可以跳过这一部分。

编辑器扩展。 已在代码编辑器中工作的用户可参考Codex 编辑器扩展。用户配置可复用，但启动环境和凭证仍需在对应客户端生效，不能只在另一个终端里设置 Key。

9. 完成您的第一个智能体任务

先选用已通过普通问答测试的工具和模型。建一个独立练习文件夹，用记事本等编辑器新建 meeting.txt，填入以下虚构内容：

课程研讨会记录
陈老师：请在周五前整理课程实验清单，由小林负责。
小林：清单完成后，我会请小周检查实验环境。
小周：可以。实验环境检查的完成日期还没有确定。
陈老师：下周一开一次进度会，具体时间待定。

先提出一个清楚、可检查的任务

把练习文件夹选为工作区，或按客户端方式授权访问，然后发送：

请阅读当前练习文件夹中的 meeting.txt，整理待办事项。

要求：
1. 用表格列出“事项、负责人、截止时间、待确认信息”。
2. 只使用原文信息，没有写明的内容标为“待确认”。
3. 将结果保存为同目录下的新文件 todo.md，保留原文件。
4. 完成后告诉我结果文件在哪里，并列出需要我确认的问题。

您会观察到四个角色各自发挥作用：您定义任务；智能体读取材料并调用模型；平台处理模型请求；模型提取内容，智能体再调用文件工具保存结果。

怎样算完成？

检查下面四点：

• 新文件 todo.md 确实存在，原始 meeting.txt 仍在。
• “课程实验清单”负责人是小林，截止时间是周五。
• “实验环境检查”的完成日期标为待确认，没有自行编造日期。
• “进度会”的具体时间及原文未明确的负责人没有被补写成确定事实。

能聊天但不能生成文件时，应分别检查：是否选好工作区、是否允许文件工具执行、所选模型是否支持工具调用。单次聊天成功不能覆盖这些检查。

10. 常见问题：先看现象，再定位

这些是排查方向，具体原因以服务端返回信息为准；平台基础错误说明见API 使用。

提交求助信息时，提供工具名称和版本、操作系统、模型 ID、接口路径、错误码及发生时间即可。隐藏 Key，不要发送包含真实密钥的完整配置截图。

11. 进阶前，记住这张小卡片

下一步可回到平台用户指南，按照自己的任务继续学习。