快速开始
安装 CLI-JAW 并在 5 分钟内启动您的第一个 AI 代理会话。
前提条件
- Node.js 20+ — nodejs.org
- npm(随 Node.js 一起安装)
- 至少订阅一个 AI CLI(例如:Claude Code 需要 Claude Pro 或更高订阅,Codex 需要 ChatGPT Pro 或更高订阅,Gemini CLI 需要 Google AI)
默认高级模型为 Claude
claude-opus-4-8 和 Codex gpt-5.5。自 6 月起,如果要使用订阅计划赠送的 Claude 用量,请选择 claude-e。安装
macOS / Linux
npm install -g cli-jaw
Windows
Windows 需要 WSL(适用于 Linux 的 Windows 子系统)。请先安装 WSL,然后从开始菜单打开 Ubuntu 并在其中运行命令。
# In WSL Ubuntu terminal:
npm install -g cli-jaw
详细的 Windows 指南:Windows Setup
初始设置
jaw init
设置向导将引导您完成以下步骤:
- 选择您的主要 CLI(Claude Code、Codex、Gemini CLI 等)
- 设置 API 密钥
- 配置服务器端口(默认:3457)
API 密钥配置
API 密钥存储在 ~/.cli-jaw/settings.json 中:
{
"anthropic": { "apiKey": "sk-ant-..." },
"openai": { "apiKey": "sk-..." },
"google": { "apiKey": "AIza..." }
}
验证安装
jaw doctor
此命令会检查您的设置并报告任何问题。
故障排除
| 错误 | 解决方法 |
|---|---|
command not found: jaw | 确保 npm 全局 bin 目录在您的 PATH 中。运行 npm bin -g 查看路径。 |
EACCES permission denied | 使用 sudo npm install -g cli-jaw 或修复 npm 权限。 |
node: command not found | 从 nodejs.org 安装 Node.js 20+ |