qoder cli - 技术栈

一、安装

Qoder CLI 支持 macOS、Linux、Windows（推荐 Windows Terminal），提供三种安装方式：

cURL（macOS/Linux）：

bash 复制代码

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

Homebrew（macOS/Linux）：

bash 复制代码

brew install qoderai/qoder/qodercli --cask

NPM（跨平台，需 Node 环境）：

bash 复制代码

npm install -g @qoder-ai/qodercli

安装完成后验证：

bash 复制代码

qodercli --version
# 输出版本号即为安装成功

二、登录

进入你的项目目录后启动 CLI：

bash 复制代码

cd your-project
qodercli

首次使用会提示登录，在交互界面输入：

bash 复制代码

/login

支持两种登录方式：

浏览器登录（推荐）：自动跳转浏览器完成认证
Personal Access Token：在 https://qoder.com/account/integrations 获取 Token

非交互式（CI/CD）环境可使用环境变量登录：

bash 复制代码

# Linux/macOS
export QODER_PERSONAL_ACCESS_TOKEN="your_token_here"

# Windows
set QODER_PERSONAL_ACCESS_TOKEN="your_token_here"

三、TUI 交互模式

启动后进入交互界面，支持以下输入模式：

前缀	模式	说明
`>`	对话模式（默认）	直接输入文本与 AI 对话
`!`	Bash 模式	直接执行 shell 命令
`/`	斜杠命令	执行内置功能命令
`#`	记忆模式	追加内容到 AGENTS.md

常用斜杠命令

命令	功能
`/init`	初始化项目，读取上下文
`/review`	审查本地代码改动
`/quest`	基于 Spec 的自主编程任务
`/status`	查看版本、模型、账户等状态
`/usage`	查看 Credits 消耗
`/clear`	清除当前会话历史
`/compact`	总结压缩当前会话
`/model`	查看/切换模型
`/logout`	退出登录
`/quit`	退出 CLI

四、Print 模式（非交互/自动化）

适合脚本、CI/CD 场景：

bash 复制代码

qodercli --print -p "your prompt here"
qodercli --output-format=json -p "your prompt"

常用参数：

参数	说明
`--print` / `-p`	非交互模式运行
`--output-format`	输出格式：text/json/stream-json
`--yolo`	跳过权限确认（自动模式）
`--max-turns`	限制最大对话轮数
`--allowed-tools`	允许使用的工具
`--disallowed-tools`	禁止使用的工具
`-w`	指定工作区目录
`-c`	继续上次会话

五、MCP 服务集成

Qoder CLI 支持集成 MCP 工具：

bash 复制代码

# 添加 Playwright 浏览器控制
qodercli mcp add playwright -- npx -y @playwright/mcp@latest

# 列出已添加的 MCP 服务
qodercli mcp list

# 移除 MCP 服务
qodercli mcp remove playwright

六、注意事项

Windows 用户 ：工作目录名称不能含有中文字符，否则可能启动失败
CLI 默认开启自动升级 ，也可在 ~/.qoder.json 中关闭
建议先执行 /init 让 AI 读取项目上下文，再开始任务