Files
vibe-coding-cn/skills/headless-cli/references/claude-cli.md
T
tukuaiai 5f8b0776e0 refactor: skills 目录扁平化,移除分类子目录
- 将 00-元技能、01-AI工具、02-数据库、03-加密货币、04-开发工具、05-生产力 下的技能移至 skills/ 根目录
- 更新 skills/README.md 使用表格进行说明性分类
- 更新 AGENTS.md 目录结构说明
2026-02-12 01:57:48 +08:00

116 lines
3.2 KiB
Markdown

# Claude Code CLI 参数参考
> 来源: [官方文档](https://docs.anthropic.com/en/docs/claude-code/cli-reference)
## 安装
```bash
npm install -g @anthropic-ai/claude-code
```
## 认证
需要 Anthropic API Key 或 Claude Pro/Max 订阅:
```bash
export ANTHROPIC_API_KEY="YOUR_API_KEY"
```
## 核心命令
| 命令 | 说明 | 示例 |
|:---|:---|:---|
| `claude` | 启动交互式 REPL | `claude` |
| `claude "query"` | 带初始提示词启动 | `claude "explain this"` |
| `claude -p "query"` | Print 模式,执行后退出 | `claude -p "review code"` |
| `claude -c` | 继续最近的对话 | `claude -c` |
| `claude -c -p "query"` | 继续对话(Print 模式) | `claude -c -p "run tests"` |
| `claude -r "id" "query"` | 恢复指定会话 | `claude -r "abc123" "continue"` |
| `claude update` | 更新到最新版本 | `claude update` |
| `claude mcp` | 配置 MCP 服务器 | `claude mcp add server` |
## CLI 参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--model` | 指定模型 | `--model claude-sonnet-4` |
| `--output-format` | 输出格式: `text`/`json`/`stream-json` | `--output-format json` |
| `--max-turns` | 限制对话轮数 | `--max-turns 3` |
| `--dangerously-skip-permissions` | 跳过所有权限确认 (YOLO) | 见下方 |
| `--allowedTools` | 允许的工具列表 | `--allowedTools "Write" "Bash(git *)"` |
| `--disallowedTools` | 禁止的工具列表 | `--disallowedTools "Bash(rm *)"` |
| `--add-dir` | 添加额外工作目录 | `--add-dir ./apps ./lib` |
| `--verbose` | 启用详细日志 | `--verbose` |
| `--continue` | 继续最近对话 | `--continue` |
| `--resume` | 恢复指定会话 | `--resume abc123` |
## 可用模型
- `claude-sonnet-4` - 平衡模型 (默认)
- `claude-opus-4` - 最强模型
- `claude-opus-4.5` - 最新最强
## 无头模式用法
```bash
# Print 模式(非交互,执行后退出)
claude -p "review this code" --output-format text
# 管道输入
cat input.txt | claude -p "explain these errors"
# YOLO 模式(跳过所有权限确认)
claude --dangerously-skip-permissions "Your prompt"
# 别名设置
alias cc='claude --dangerously-skip-permissions'
# 继续对话 + Print 模式(适合脚本)
claude -c -p "show progress"
```
## 交互式命令 (Slash Commands)
| 命令 | 说明 |
|:---|:---|
| `/help` | 显示所有命令 |
| `/config` | 配置设置 |
| `/allowed-tools` | 配置工具权限 |
| `/mcp` | 管理 MCP 服务器 |
| `/vim` | 启用 vim 编辑模式 |
## 配置文件
- 用户设置: `~/.claude/settings.json`
- 项目设置: `.claude/settings.json`
- 本地设置: `.claude/settings.local.json`
```json
{
"model": "claude-sonnet-4",
"permissions": {
"allowedTools": ["Read", "Write", "Bash(git *)"],
"deny": ["Read(./.env)", "Bash(rm *)"]
}
}
```
## 上下文文件 (CLAUDE.md)
- 全局: `~/.claude/CLAUDE.md`
- 项目: `./CLAUDE.md`
- 子目录: 组件特定指令
## 深度思考触发词
强度递增:
- `think` - 基础思考
- `think hard` - 深入思考
- `think harder` - 更深入
- `ultrathink` - 最深度思考
## 常见问题
1. **权限弹窗**: 使用 `--dangerously-skip-permissions`
2. **上下文过长**: 使用 `/compact``/clear`
3. **回退更改**: 使用 `/rewind`