Qoder 使用：IDE、CLI、权限与自定义模型

信息层级：【有据可查】= 附官方文档或可信来源链接；【社区共识】= 社区用户普遍经验，未经官方确认；【待考察/推测】= 推测或暂未能核实，请谨慎对待。

1. 定位

【有据可查】Qoder 是阿里的 Agentic 编程平台：Qoder IDE、终端 CLI、JetBrains 集成，以及用于长任务委托的 Quest（单 Agent / 多 Agent "Experts"）；Agent 模式可自主进行项目搜索、文件编辑、终端命令与 MCP 调用。另有面向国内的 Qoder CN 系列。来源：qoder.com、Docs、Quest、Qoder CN

2. 订阅方案结构（价格以官网为准）

【有据可查】国际版采用"月度 Credits"结构：Free（有限补全/基础模型）、Pro、Pro+、Ultra 逐级增加月度 Credits，按月重置；付费用户可购买 Credits 包；新用户可能有一次性限时 Pro 试用。来源：Pricing、Credits

【待考察】Qoder CN 的套餐与计费币种可能不同，请查国内站。

3. 安装【有据可查】

来源：CLI Installation

# macOS / Linux
curl -fsSL https://qoder.com/install | bash
# Windows PowerShell
irm https://qoder.com/install.ps1 | iex
qoder --version

IDE 版从官网下载安装包。

4. 权限 / 安全模型（CLI）【有据可查】

来源：Permissions

4.1 权限模式

模式	行为
`default`	安全读取自动执行；敏感动作需确认
`accept_edits`	自动批准工作目录内安全的文件编辑；Shell 等仍正常检查
`auto`	由 Agent 侧分类器决定授权（两阶段：快速通道只能"放行"，第二阶段才能"拦截"）；连续拦截达阈值触发"熔断"转为询问
`bypass_permissions`（YOLO）	跳过审批；但删除工作目录/家目录/根目录/顶层目录的 `rm` 仍会询问且不提供"总是允许"
`dont_ask`	从不询问，需询问的一律拒绝（适合 headless）

Shift+Tab 循环切换；Ctrl+Y 直接进入 YOLO（新手慎用）。
非默认模式只在受信任目录生效；不受信任目录强制回退到 default。
组织可用 security.disableYoloMode: true 禁用 YOLO。
autoMode 分类器的自然语言规则只从用户全局设置读取，工作区文件被忽略——防止仓库"自带放行规则"。

4.2 决策顺序

4.3 配置示例（改写自官方）

// ~/.qoder/settings.json 或 项目 .qoder/settings.json
{
  "general": { "defaultPermissionMode": "default" },
  "permissions": {
    "allow": ["Read(/src/**)", "Bash(npm run test:*)", "Bash(git status)"],
    "ask":   ["Bash(git push:*)", "Bash(npm publish:*)", "WebFetch"],
    "deny":  ["Read(*.pem)", "Bash(rm -rf:*)", "Bash(sudo:*)"]
  }
}

受保护路径：.git、.vscode、.idea、.husky、多数 .qoder 配置、.bashrc/.zshrc、Git 配置、.mcp.json 等，交互模式下需显式批准。
Hooks（PreToolUse / PermissionRequest）优先级高于权限模式——即使 YOLO 下，Hook 返回 deny 仍会拦截，适合组织级强制策略。
配置来源共多层（用户 → 项目 → 本机 local → --settings → CLI 参数 → 会话命令 /allow /deny → 会话临时），高层覆盖低层。

5. 常用命令与工作流

命令 / 参数	用途	层级
`qoder`	交互 TUI	有据可查
`qoder -p "任务" --permission-mode accept_edits`	headless：文件编辑自动批准、Bash 拒绝	有据可查
`qoder -p "检查状态" --allowed-tools 'Read,Bash(git status)'`	headless 精确放行	有据可查
`--add-dir ../shared` / `/add-dir`	扩展信任目录	有据可查
`/allow Bash(npm test)`、`/deny WebFetch`	会话内添加规则（写入 settings.local.json）	有据可查
`/agents`	查看子代理	有据可查
`/model`	选择模型 / 添加自定义模型	有据可查

6. 接入自定义模型（BYOK）【有据可查】

来源：Custom Models

CLI 中：/model → Custom → Add custom model；官方提示不要手动编辑 settings.json 来添加。
IDE 中的 BYOK 设置请查对应文档。【待考察】

7. 常见报错

现象	原因	处理	层级
设置了 auto/yolo 却仍是 default	当前目录不受信任	信任目录或 `--add-dir`	有据可查
headless 下命令全被拒	`ask` 在 headless 中变 `deny`	用 `--allowed-tools` 精确放行	有据可查
切换 auto 被拒绝	无可用分类器模型	检查账户/模型可用性	有据可查
分类器不可达	动作被拒（非安全裁决）	稍后重试	有据可查
宽泛 `Bash(*)` 仍弹窗	安全检查与 ask 优先级更高	正常现象	有据可查

8. 适合人群

✅ 想要 IDE + CLI + 长任务委托（Quest）一体的开发者
✅ 重视精细权限规则与组织级策略的团队
✅ 国内用户可关注 Qoder CN

9. 本篇无法核实/需谨慎的点

Qoder CN 与国际版的套餐、模型、功能差异。
IDE 端权限与 CLI 是否完全一致。
具体 Credits 消耗规则（按模型/任务不同）。

小白练习：把本文流程逐项走通

练习目标：分清 IDE 与 CLI 的设置，完成一次可控任务。

上文已介绍概念、配置和操作示例。下面侧重第一次实际操作时的顺序、检查点和结果核对；需要查具体参数时回到对应小节。命令逐条输入，看到上一条的结果后再继续。

先选国际版或 CN 版，再选择 IDE 或 CLI。不同产品入口的套餐和设置分别核对。
安装后打开练习项目；CLI 用户先查看版本和帮助。确认当前工作目录，再启动交互会话。
先检查权限模式与可信目录。只读探索通过后，再允许小范围文件编辑。
接入自定义模型时按原文使用模型菜单，逐项填写来源、协议、地址与凭据，并测试连接。
先提出一个能在几分钟内检查的小任务。完成后查看文件列表和 diff，运行原有测试。
非交互任务没有人回答询问弹窗，需按官方文档明确允许的工具；不要为了跑通任务直接放开所有工具。

继续浏览制器坊返回顶部 ↑