Qoder CLI 完全指南

curl -fsSL https://qoder.com/install | bash

brew install qoderai/qoder/qodercli --cask

npm install -g @qoder-ai/qodercli

# 启动 Qoder CLI
qodercli

# 在交互式提示符中输入 /login
/login

# 选择登录方式：
#   - login with browser    → 打开浏览器完成认证
#   - login with personal access token → 粘贴 Token

export QODER_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

set QODER_PERSONAL_ACCESS_TOKEN="your_personal_access_token_here"

# 指定工作区目录启动
qodercli -w /Users/demo/projects/my-app

# 继续上次的会话
qodercli -c

# 恢复指定会话
qodercli -r xxxxxxxx-c09a-40a9-82a7-a565413fa393

# 仅允许指定工具（限制 AI 能力范围）
qodercli --allowed-tools=Read,Write

# 设置最大对话轮数
qodercli --max-turns=10

# 跳过权限检查（仅在可信环境使用）
qodercli --yolo

# 基本的非交互式运行
qodercli -q -p "分析这个项目的主要架构"

# 指定 JSON 格式输出
qodercli --print --output-format=json -p "列出所有 TODO 注释"

# 指定 stream-json 实时流式输出
qodercli --print --output-format=stream-json -p "重构这个函数"

# 在名为 feature-a 的 worktree 中启动会话
qodercli --worktree feature-a

# 直接指定任务
qodercli --worktree feature-a "Implement the login fix"

# 自动生成 worktree 名称
qodercli --worktree

{
  "permissions": {
    "allow": [
      "Read(/src/**)",           // 允许读取 src 目录下所有文件
      "Edit(/src/**)",           // 允许编辑 src 目录下所有文件
      "Bash(npm run test:*)",   // 允许运行测试命令
      "mcp__context7__*"        // 允许 context7 MCP 所有工具
    ],
    "ask": [
      "Bash(npm publish:*)",    // 发布包前需要确认
      "WebFetch"                // 网络请求需要确认
    ],
    "deny": [
      "Read(*.pem)",            // 禁止读取密钥文件
      "Bash(rm -rf:*)",         // 禁止危险删除
      "Edit(/.git/**)"          // 禁止修改 Git 内部文件
    ]
  }
}

# 添加 Playwright 浏览器自动化服务
qodercli mcp add playwright -- npx -y @playwright/mcp@latest

# 添加 Context7 知识库服务
qodercli mcp add context7 -- npx -y @upstash/context7-mcp@latest

# 添加 DeepWiki 服务
qodercli mcp add deepwiki -- npx -y mcp-deepwiki@latest

# 管理服务
qodercli mcp list    # 列出所有已配置的服务
qodercli mcp remove playwright  # 移除服务

# 用户级 - 适用于所有项目的全局记忆
~/.qoder/AGENTS.md

# 项目级 - 适用于当前项目，通常提交到 Git
${project}/AGENTS.md

# 本地项目级 - 仅在当前机器生效，通常加入 .gitignore
${project}/AGENTS.local.md

# 方式一：使用内置更新命令（最简单）
qodercli update

# 方式二：通过 cURL 重新安装
curl -fsSL https://qoder.com/install | bash -s -- --force

# 方式三：通过 Homebrew 升级
brew update && brew upgrade

# 方式四：通过 NPM 升级
npm install -g @qoder-ai/qodercli

{
  "general": {
    "enableAutoUpdate": false
  }
}