帮助中心上手装好、登录 Agent
装好、登录 Agent
上手

装好、登录 Agent

你电脑上的 Agent(比如 Claude Code、Codex)怎么装、怎么登录,以及 QU Studio 怎么用你的 Agent。

小去是默认名字,你可以在它的页面里改;改了以后 App 里处处跟着变。

要装什么

小去和干活的会话靠的是你电脑上的 Agent 程序。主要支持这两家,有一个能用就行:

Agent官方安装说明登录命令
Claude CodeClaude Code 安装说明claude auth login
Codex CLICodex CLI 说明codex login

小去只能跑在 Claude Code 或 Codex 上。别的走 ACP 的 Agent(比如 Gemini CLI、OpenCode)在「设置 › Agent › 更多 Agent」里能找到;它们能开会话,但接不了小去交的任务,也叫不了帮手。

怎么装、怎么登录

  1. 按官网说明装好。QU Studio 不替你装,也不带安装包。
  2. 在终端里登录:运行上面的登录命令,用你自己的账号登录。可以用订阅(Claude Pro / Max、ChatGPT 套餐),也可以用你自己的 API Key,按各家官网说明来。
  3. 回到 QU Studio 检查:「设置 › Agent」里点「重新检测」,看到「已登录」就好了。没装的那一行有「怎么装」,没登录的有「复制登录命令」,复制后到终端里粘贴运行。

装了好几台电脑(见 多台电脑)的,每台都要各自装、各自登录。电脑页里每台写着装了哪些 Agent、登没登录。

新会话用哪个模型

  • 「设置 › Agent › 模型预设」:每套预设写着哪家、模型、思考强度、快速、权限。你开的、小去开的会话都先用标着「默认」的那套,开的时候还能换。
  • 每套预设可以写「什么时候用」,比如「改文案、补测试这类小改动」「Claude 的额度快用完时」。小去派活、会话叫帮手时照它挑一套;没写的不会被自己挑中。
  • 预设里写的模型这台电脑上没有时,改用默认模型,不报错。
  • 预设会盖过你在 Claude Code 里自己设的默认模型。
  • 别的几处模型在哪改,见 用量与额度 · 模型在哪改。

接别家的模型(DeepSeek、Kimi、GLM……)

DeepSeek、Kimi、GLM、Qwen、MiniMax 这几家都有兼容 Anthropic 的接口,可以让 Claude Code 去调它们,引擎还是 Claude Code,小去派活、插话、在终端里接手都照常。做法是给模型预设填一个「引擎配置档」,只有用这套开的会话换过去,别的会话不受影响。

  1. 自己写一个 Claude Code 设置文件,比如 ~/.claude/deepseek.json,接口地址、密钥、模型名写在 env 里(以对方文档为准):

``json { "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "你在 DeepSeek 申请的 Key", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat" } } ``

  1. 「设置 › Agent › 模型预设」加一套:用 Claude Code,模型选 Opus(会按上面那几项换成对方的模型),「引擎配置档」填这个文件的完整路径。
  2. 开会话时选这套;想让小去派活时用它,在「什么时候用」里写清。
  • QU Studio 只把这个路径交给 Claude Code,不读这个文件,不经手你的 Key;Key 也可以不写在文件里,放在你自己的环境变量。
  • Codex 也能接:在 ~/.codex/config.toml 里写好 [model_providers.<名字>],预设的「引擎配置档」填这个名字。
  • 用这套开的会话,花费是按 Anthropic / OpenAI 的价格算的,不准,所以只记 token,不显示金额;对方的额度也读不到。
  • 这套只在你设它的这台电脑上管用;开在别的电脑上的会话不带配置档。
  • 带配置档的会话不开快速模式(别家的模型没有);预设里没选权限时按「每次都问」起,不跟着这个文件里的 permissions.defaultMode。
  • 这个文件里别写 disableAllHooks:它会把 QU 的安全钩子一起关掉。

我们怎么用你的 Agent

QU Studio 只调用你电脑上自己装、自己登录的 Agent(比如 Claude Code、Codex),用的是你自己的账号。具体来说:

  • 只检测、只调用:检测只看程序在不在(--version)、登没登录(用 Agent 自己的官方命令或接口),然后在你的电脑上按你的要求调用它。
  • 不安装、不打包、不改它们:用的就是你装的那一份,原样运行;不移除、不限制它们自带的任何登录方式。
  • 不读你的账号文件:不读取、不复制、不保存 ~/.claude、~/.codex/auth.json 这类凭据文件,也不经手你的密码、令牌。
  • 不在 App 里登录:QU Studio 里没有 Claude 或 ChatGPT 的登录入口。登录只在 Agent 自己的流程里完成;检测到「没登录」时,只提示你去终端登录。
  • 用量算你自己的:用量直接算在你自己的 Claude / ChatGPT 账号或 API Key 上。QU Studio 不收费、不代付、不转售用量。
  • 不改你的环境:不替你改网络、代理、账号设置。连不上时会说清原因,由你处理。

Claude Code 是 Anthropic 的产品,Codex 是 OpenAI 的产品。QU Studio 是独立产品,和这两家没有合作关系,也没有得到它们的背书。

用量要心里有数

  • 订阅的额度是按普通个人使用设计的。小去可以同时开好几个会话、会话还能叫帮手,长时间干活时额度会比你自己用时消耗得快。可以在电脑页给每台设「同时最多跑几个任务」。
  • 有几样功能会另外调模型、花你的用量,都能关或换成便宜的模型: - 猜下一句、自动起任务名:「设置 › Agent」里能关,模型在「猜下一句、起任务名用的模型」里换,默认用快、便宜的; - 空闲时整理记忆:「设置 › 记忆与隐私」里能关,模型在「整理记忆用的模型」里换,一天最多一次。用 API Key 这类按量付费的登录时读不到剩余额度,不会自动整理。
  • 左下角能看这台电脑上各家账号的限额还剩多少,用量页能看按天、按项目、按模型的明细。
  • 一家的额度快用完时,会话里会提一句换到另一家接着做;选模型里也能随时直接选另一家的模型,从下一句起换,前面的对话一起带过去。见 会话。

常见问题

装了,但 QU Studio 显示「没找到」 QU Studio 会读你登录 shell 里的 PATH,也会看几个常见的安装位置。先开一个新的终端窗口,运行 claude --version 或 codex --version 确认能跑;能跑还显示没找到,回到「设置 › Agent」点「重新检测」。

电脑上装了好几份 Codex QU Studio 用版本最新的那一份(包括 ChatGPT App 自带的那份)。终端里那份更旧时,「设置 › Agent」里会提示你。

显示「登录状态不明」 查不出登录状态时,可以先开个会话试试;真没登录,Agent 会在会话里报错,到终端登录后再试。

用 Codex 时要我在 App 里登录 ChatGPT 吗? 不用,也没有这个入口。在终端里运行 codex login 登录就行。

一定要买订阅吗? 不一定。Claude Code、Codex 都支持用你自己的 API Key 登录,按各家官网说明设好就能用。