开发者文档 · 本机值守

支持的 AI 工具

值守会话可以跑在你自己选的 AI 编程工具和大模型上:默认 Claude Code,也可以换成 Codex、Gemini CLI 等,或接入 DeepSeek、Kimi、GLM、通义千问等国产大模型。

支持情况

平台、审批和安全拦截与用哪种 AI 无关;换的只是你电脑上实际干活的工具,消耗的也是你自己在该工具上的额度。

工具切换命令状态
Claude Codeyqpj-agent runner claude已验证(默认)
Codex(OpenAI)yqpj-agent runner codex已接入,验证中
Gemini CLI(Google)yqpj-agent runner gemini已接入,验证中
opencodeyqpj-agent runner opencode已接入,验证中
Cursor CLIyqpj-agent runner cursor已接入,验证中
Qwen Code(阿里)yqpj-agent runner qwen已接入,验证中
其它工具yqpj-agent runner custom --cmd '<命令模板>'自行接入
「验证中」表示已按该工具官方文档接好,但还没有在真实项目里跑通过一单。想先试的话欢迎使用,遇到问题在项目群里反馈,我们会尽快修正。

支持哪些大模型

先分清两件事:上表是AI 编程工具,负责读代码、执行命令、改文件;DeepSeek、Kimi、GLM 这些是大模型,是工具背后的「大脑」。国产大模型不用单独接入,装进现有工具里就能用。

目前最省事的做法:用 Claude Code,把接口地址换成模型厂商提供的兼容地址。下面几家都在官方文档里给出了这种用法:

大模型接口地址(ANTHROPIC_BASE_URL)密钥变量官方说明
DeepSeekhttps://api.deepseek.com/anthropicANTHROPIC_API_KEYDeepSeek 文档
Kimi(月之暗面)https://api.moonshot.ai/anthropicANTHROPIC_AUTH_TOKENKimi 文档
GLM(智谱,国内)https://open.bigmodel.cn/api/anthropicANTHROPIC_AUTH_TOKEN智谱文档
GLM(Z.ai,海外)https://api.z.ai/api/anthropicANTHROPIC_AUTH_TOKENZ.ai 文档
通义千问(阿里百炼)Coding Plan:https://coding.dashscope.aliyuncs.com/apps/anthropic;按量计费的地址带你自己的业务空间编号,见官方说明ANTHROPIC_AUTH_TOKEN百炼文档
MiniMax(海外)https://api.minimax.io/anthropicANTHROPIC_AUTH_TOKENMiniMax 文档
豆包(火山方舟)接入方式核实中,暂可用 opencode 或自定义命令接入—
GPT(OpenAI)用 Codex:yqpj-agent runner codex—
Gemini(Google)用 Gemini CLI:yqpj-agent runner gemini—

配置示例(以 DeepSeek 为例,模型名填该厂商文档里当前推荐的编程模型):

yqpj-agent runner claude --model <模型名> \
  --env ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic \
  --env ANTHROPIC_API_KEY=<你的 DeepSeek 密钥>

这些设置只对值守会话生效,不影响你平时自己打开的 Claude Code。密钥只保存在本机 ~/.yqpj-agent/runner.env(仅你自己可读),不会上传平台。

各家的模型名和套餐变化很快,配置时以对应官方文档和控制台为准;同一家国内站和海外站的地址、密钥不通用。这些模型同样处于「验证中」,跑通后我们会在这里标注。opencode、Qwen Code 也能接入这些模型,具体方法见各工具文档。

怎么切换

  1. 先在电脑上安装并登录对应工具,确认在终端里能直接运行;
  2. 执行切换命令,可以同时指定模型:
yqpj-agent runner codex --model gpt-5
  1. 执行 yqpj-agent doctor 自检,确认找到了工具和版本。

设置对这台电脑上的所有项目生效,下一张单就会使用新工具。不带参数执行 yqpj-agent runner 可查看当前设置。平台的处理端卡片会显示每个项目当前用的工具、模型和版本。

接入其它工具

只要工具能在终端里非交互地执行一个任务,就可以用 custom 接入。命令模板里可以用这些占位符:

占位符含义
{prompt}值守规约 + 本次任务的全文
{prompt_file}同样内容的文件路径(工具支持从文件读提示词时用)
{model}你设置的模型,没设时连同前面的选项一起省略
{cwd}项目仓库目录
yqpj-agent runner custom --cmd 'my-ai run --yes --prompt-file {prompt_file}'

工具必须以「全自动」方式运行(无需逐条确认就能改文件、执行命令),否则无人值守时会卡住。

与 Claude Code 的差异

  • 续用会话:Claude Code 可以接着同一项目上次的会话继续处理;其它工具每次新开会话,靠值守规约和仓库现状接上。
  • 处理过程实时摘要:目前只有 Claude Code 能在 H5「处理过程」里逐步显示;其它工具只显示开始和结束。
  • 常驻值守与中转唤醒:依赖 Claude App 侧边栏,只适用于 Claude Code;其它工具使用后台调度。

审批、敏感信息审核、部署闸门等安全机制在平台上强制执行,用哪种工具都一样,详见 权限与安全。