精选案例 · Agent 自动化 / 科研阅读与计算
词元计划 Agent 工具接入指南
本文档系统总结了15个常见Agent工具与编程助手（如Claude Code、GitHub Copilot、Kilo Code等）接入中国科学技术大学词元计划校内LLM API的方法。…
案例速读
文档从基础配置到每个具体工具的接入方式均给出详细参数和文件路径（如Claude Code的ANTHROPIC_BASE_URL环境变量，Kilo Code的~/.config/kilo/opencode.json配置），并附模型状态、上下文长度、多模态支持等选型参数表，适合校内师生快速按身份选择模型并完成配置，实用性强。 建议从 「title: 词元计划 Agent 工具接入指南sidebar_position: 1」、「词元计划 Agent 工具接入指南」、「基础配置」、「模型清单与关键参数」 进入正文，先确认真实任务和模型辅助过程。
- 重点看 OpenAI兼容端点配置模式可复用至任何支持自定义provider的工具、环境变量注入API Key的做法可推广到其他需要保护密钥的场景、模型选型建议（根据身份权限选择对应模型）可指导校内资源分配。结合 Agent 自动化 / 科研阅读与计算 / Agent工具接入 / API配置 和「中国科学技术大学师生、开发者、AI编程助手用户」，它更适合作为任务检索后的精读材料。
- 正文目录和原始材料仍然是判断依据；导读只帮助你更快定位阅读重点。
- 首读入口
- title: 词元计划 Agent 工具接入指南sidebar_position: 1
- 读者
- 中国科学技术大学师生、开发者、AI编程助手用户
- 复用
- OpenAI兼容端点配置模式可复用至任何支持自定义provider的工具
- 结构
- 6 个目录入口
原文内容
title: 词元计划 Agent 工具接入指南 sidebar_position: 1
词元计划 Agent 工具接入指南
本文档汇总 15 个常见 Agent 工具与编程助手接入词元计划 API 的方法。每篇子文档介绍一个工具的用途，并说明如何使用学校内部申请的词元计划 API Key，把该工具切换到词元计划提供的模型服务。
基础配置
词元计划 API 使用 OpenAI 兼容格式，部分工具也可通过 Anthropic 兼容端点接入。除文档中特别说明外，默认使用以下参数：
| 参数 | 值 |
|---|---|
| OpenAI 兼容端点 | https://api.llm.ustc.edu.cn/v1 |
| Anthropic 兼容端点 | https://api.llm.ustc.edu.cn/v1/anthropic；Claude Code 校内镜像请按对应文档使用 https://api.llm.ustc.edu.cn/ |
| API Key | 请在 https://llm.ustc.edu.cn 申请 |
| 身份类型 | 可用模型 |
|---|---|
| 教职工 | 全部模型可用 |
| 本科生/研究生 | deepseek-v4-flash-ascend、qwen3.6-chat、qwen3.6-reasoner、qwen-chat、qwen-reasoner |
| 第一批测试用户 | deepseek-v4-pro、deepseek-v4-flash-ascend、qwen3.6-chat、qwen3.6-reasoner、qwen-chat、qwen-reasoner |
| 部分第五批测试用户 | qwen3.6-chat、qwen3.6-reasoner、qwen-chat、qwen-reasoner |
模型清单与关键参数
下表列出当前可在 Agent 工具中配置的模型名称，并根据模型服务页补充可确认的上下文长度、图文理解能力和选型建议。
| 模型 | 状态 | 服务侧定位 | 推荐用途 | Context Window | 最大输出 token | 多模态 | 工具调用 | 推理能力 | 备注 |
|---|---|---|---|---|---|---|---|---|---|
deepseek-v4-flash |
可用 | DeepSeek-V4-Flash，284B 总参数 / 13B 激活，FP8，高效通用层主力模型。 | 日常问答、文本生成、摘要翻译、长文档处理、高并发 API 调用。 | 1M | - | 文本 | 支持 | 通用能力强。教职工默认调用模型；学生账号请改用 deepseek-v4-flash-ascend。 |
面向高效通用、长文本和高并发服务，仅教职工权限可用。 |
deepseek-v4-flash-ascend |
可用 | DeepSeek-V4-Flash 的 Ascend 服务版本。 | 学生账号默认可用的 DeepSeek V4 Flash 版本，适合日常问答、文本处理和长文档任务。 | 1M | - | 文本 | 支持 | 通用能力强。 | 华为平台。 |
deepseek-v4-pro |
可用 | DeepSeek-V4-Pro，1.6T 总参数 / 49B 激活，FP8，高阶推理层模型。 | 科研论文分析、复杂逻辑推理、多材料联合分析、高质量科研写作。 | 1M | - | 文本 | 支持 | 强，适合复杂推理和多步骤分析。 | 适合高复杂度科研分析与深度内容生成。 |
qwen-chat |
可用 | Qwen3.6-35B-A3B 的 chat 接入名，35B 总参数 / A3B 激活，BF16，高效通用 / VL 图文理解模型。 | 日常问答、文本生成、长文本总结、常规 Agent 任务。 | 262K | - | 文本、图片 | 支持 | 通用对话。 | - |
qwen-reasoner |
可用 | Qwen3.6-35B-A3B 的 reasoner 接入名，35B 总参数 / A3B 激活，BF16，高效通用 / VL 图文理解模型。 | 复杂问答、教学辅助、结构化输出、常规推理任务。 | 262K | - | 文本、图片 | 支持 | 支持推理类任务。 | - |
qwen3.6-chat |
可用 | Qwen3.6-27B 的 chat 接入名，BF16，能力增强 / VL 图文理解模型。 | 日常问答、文本生成、长文本总结、常规 Agent 任务。 | 262K | - | 文本、图片 | 支持 | 常规任务能力均衡。 | - |
qwen3.6-reasoner |
可用 | Qwen3.6-27B 的 reasoner 接入名，BF16，能力增强 / VL 图文理解模型。 | 教学辅助、编程支持、复杂图文分析、复杂问答、结构化输出。 | 262K | - | 文本、图片 | 支持 | 适合中等复杂度任务和结构化分析。 | - |
qwen3.5-non-thinking |
Deprecated | Qwen3.5 非 thinking 模型。 | 兼容旧配置。 | 262K | - | 文本、图片 | 支持 | 非 thinking。 | 已废弃，建议迁移到新版模型。 |
qwen3.5-thinking |
Deprecated | Qwen3.5 thinking 模型。 | 兼容旧配置。 | 262K | - | 文本、图片 | 支持 | thinking。 | 已废弃，建议迁移到新版模型。 |
填写参数时建议重点确认：
Context Window：模型一次请求可处理的最大上下文长度。- 最大输出 token：单次响应可生成的最大 token 数。
- 多模态：是否支持图片、音频、视频等非文本输入。
- 工具调用：是否支持 function calling / tool use，Agent 工具通常依赖这一能力。
- 推理能力：是否支持 thinking / reasoning mode，以及是否需要回传
reasoning_content。 - 流式输出：是否支持 streaming，CLI 和 Agent 场景通常建议开启。
- 兼容端点：确认该模型应使用 OpenAI 兼容端点还是 Anthropic 兼容端点。
文档目录
| 工具 | 文档内容 | 接入方式摘要 |
|---|---|---|
| Claude Code | 终端 AI 编程助手，支持项目内代码理解、编辑和工具调用。 | 通过 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和模型环境变量接入 Anthropic 兼容端点。 |
| GitHub Copilot | VS Code Copilot Chat 插件方式，把词元计划模型加入 Copilot 模型选择器。 | 安装插件后，在 VS Code 命令面板执行 词元计划: Set API Key 保存校内 API Key。 |
| GitHub Copilot CLI | GitHub Copilot CLI 的 BYOK 接入方式。 | 使用 COPILOT_PROVIDER_TYPE=anthropic、COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_API_KEY 和 COPILOT_MODEL 配置。 |
| Kilo Code | 支持 CLI 和编辑器扩展的 AI 编程助手。 | 在 ~/.config/kilo/opencode.json 中配置 OpenAI-compatible custom provider、词元计划 Base URL、校内 API Key 和账号权限内可用模型。 |
| WorkBuddy / CodeBuddy | 桌面端 AI Agent / 编程助手，可通过本地模型配置文件添加自定义模型。 | 在 .codebuddy/models.json 中配置词元计划 Chat Completions URL、USTC_LLM_API_KEY 和账号权限内可用模型。 |
| OpenCode | 终端和网页形式的开源 AI 编程助手。 | 在 opencode.json 中配置 ustc-llm OpenAI-compatible provider、词元计划 Base URL、校内 API Key 和模型列表。 |
| Oh My Pi | 终端 AI 编程 Agent，支持自定义 models.yml。 |
在 ~/.omp/agent/models.yml 中配置词元计划 OpenAI 兼容端点、USTC_LLM_API_KEY 和 DeepSeek V4 thinking/tool-call 兼容参数。 |
| OpenClaw | 可接入飞书、微信等渠道的个人 AI 助手。 | 在 OpenClaw 配置文件的 models.providers 中添加 ustc-llm 自定义 OpenAI-compatible provider。 |
| AstrBot | 一站式聊天 Agent，可接入 QQ、微信、飞书、Telegram 等平台。 | 在 Web UI 的模型提供商页面新增词元计划，填入校内 API Key 并设为默认模型。 |
| Deep Code | 面向词元计划 V4 适配的终端 AI 编程助手。 | 在 ~/.deepcode/settings.json 中填写 BASE_URL、API_KEY 和模型名称。 |
| Hermes Agent | Nous Research 的自我进化 Agent，支持技能沉淀和跨会话偏好学习。 | 运行 hermes model / hermes setup，在向导中选择 Custom Endpoint（自定义 OpenAI-compatible 端点），填写校内 API Key、Base URL 和模型。 |
| nanobot | 轻量级聊天智能体，可接入常用聊天工具。 | 在 ~/.nanobot/config.json 中配置 ustc-llm provider、校内 API Key、apiBase 和默认模型。 |
| Crush | Charm 开发的终端 AI 编程 Agent，支持 LSP、MCP 和多模型切换。 | 在 ~/.config/crush/crush.json 中添加 OpenAI-compatible 供应商，并用环境变量传入校内 API Key。 |
| Reasonix | 面向 DeepSeek 系列模型优化的终端编程 Agent。 | 首次运行 npx reasonix code 后，在 ~/.reasonix/config.json 中确认校内 API Key、Base URL 和默认模型。 |
| Langcli | 支持 CLI 和 Zed ACP Agent 的 AI 编程助手。 | 在 ~/.langcli/settings.json 中配置 modelProviders.openai、词元计划 Base URL、envKey 和账号权限内可用模型。 |
使用建议
- 除非对应文档明确说明工具自带词元计划集成，否则统一按自定义 OpenAI-compatible provider 配置；不要把 DeepSeek 等第三方内置 provider 当作词元计划校内端点。
- 如果工具只支持 OpenAI-compatible provider，请使用
https://api.llm.ustc.edu.cn/v1。 - 如果工具要求 Anthropic Messages API 或 Claude 模型名，请使用
https://api.llm.ustc.edu.cn/v1/anthropic，并参考对应文档中的模型映射说明。 - 发布前请逐篇确认 API Key 只以占位符或环境变量出现，不要写入真实密钥。