千手

安装与配置

第一步：安装千手

# 打开 windows 终端中的 powershell 终端
# windows 上安装 nodejs
# 右键按 Windows 按钮，点击「终端」

# 然后依次执行下面的
winget install --exact --source winget --id Git.Git # 或者参考 https://git-scm.com/install/windows 用其他办法安装 Git
winget install --exact --source winget --id OpenJS.NodeJS # 或者参考 https://nodejs.org/zh-cn/download 用其他办法安装 Node.js
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# 然后关闭终端窗口，新开一个终端窗口

# 安装 qianshou
npm install -g qianshou --registry=https://registry.npmmirror.com

# 初始化配置
node --eval "
    const homeDir = os.homedir();
    const filePath = path.join(homeDir, '.claude.json');
    if (fs.existsSync(filePath)) {
        const content = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
        fs.writeFileSync(filePath, JSON.stringify({ ...content, hasCompletedOnboarding: true }, null, 2), 'utf-8');
    } else {
        fs.writeFileSync(filePath, JSON.stringify({ hasCompletedOnboarding: true }), 'utf-8');
    }"

使用 npm 全局安装千手命令行工具

第二步：配置认证（智谱示例，windows 推荐使用 WSL ）

export QS_AUTH_TOKEN=...
export QS_BASE_URL=https://open.bigmodel.cn/api/anthropic
#https://api.kimi.com/coding/
export API_TIMEOUT_MS="3000000"
export QS_DISABLE_NONESSENTIAL_TRAFFIC=1
export QS_SMALL_MODEL="glm-4.5-air"
export QS_MIDDLE_MODEL="glm-4.7"
export QS_BIG_MODEL="glm-5.1"
export QS_MODEL="glm-5.1"
export ENABLE_TOOL_SEARCH=false
#然后运行：
#qianshou --permission-mode bypassPermissions 

设置您的 API 密钥和模型选择

第三步：启动使用

cd 你的工作目录
qianshou --permission-mode bypassPermissions

启动交互式模式，开始与千手对话。建议保存为 下载qianshou.sh 或 下载qianshou.bat 格式

📋 系统要求

运行时：Bun >= 1.3.11 或 Node.js >= 18

操作系统：macOS、Linux 或 Windows 10+

🎯 办公模式

启用桌面办公版，处理文档和文件：

新增 export QS_OFFICE=1
                ... 其它相关配置
qianshou --permission-mode bypassPermissions

🔧 高级配置

千手支持丰富的配置选项，可以通过环境变量或配置文件进行自定义：

• 自定义模型 QS_MODEL=model-name