gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-08-15 20:08:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

chore: migrate repository to standard knowledge base layout

Browse Source
This commit is contained in:
tukuaiai
2026-05-02 03:29:06 +08:00
parent 40a721c24d
commit 628a3bc832
565 changed files with 687 additions and 711 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/headless-cli/references/claude-cli.md
+115
View File
@@ -0,0 +1,115 @@
# 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`
skills/headless-cli/references/codex-cli.md
+124
View File
@@ -0,0 +1,124 @@
# Codex CLI 参数参考
> 来源: [官方文档](https://developers.openai.com/codex/cli/reference)
## 安装
```bash
npm install -g @openai/codex
```
## 认证
```bash
# 方式 1: 浏览器 OAuth (ChatGPT 账号)
codex login
# 方式 2: API Key
printenv OPENAI_API_KEY | codex login --with-api-key
# 检查登录状态
codex login status
```
## 核心命令
| 命令 | 说明 | 示例 |
|:---|:---|:---|
| `codex` | 启动交互式 TUI | `codex` |
| `codex "prompt"` | 带提示词启动 | `codex "explain this"` |
| `codex exec` / `codex e` | 非交互模式 | `codex exec "fix bugs"` |
| `codex resume` | 恢复会话 | `codex resume --last` |
| `codex apply` / `codex a` | 应用 Cloud 任务的 diff | `codex apply TASK_ID` |
| `codex mcp` | 管理 MCP 服务器 | `codex mcp add server` |
| `codex completion` | 生成 shell 补全 | `codex completion zsh` |
## 全局参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--model, -m` | 指定模型 | `-m gpt-5.5` |
| `--sandbox, -s` | 沙箱策略: `read-only`/`workspace-write`/`danger-full-access` | `-s workspace-write` |
| `--ask-for-approval, -a` | 审批模式: `untrusted`/`on-failure`/`on-request`/`never` | `-a on-failure` |
| `--full-auto` | 自动化预设 (workspace-write + on-failure) | `--full-auto` |
| `--dangerously-bypass-approvals-and-sandbox` / `--yolo` | 跳过所有审批和沙箱 | `--yolo` |
| `--search` | 启用网页搜索 | `--search` |
| `--add-dir` | 添加额外写入目录 | `--add-dir ./other` |
| `--enable` | 启用功能标志 | `--enable web_search_request` |
| `--disable` | 禁用功能标志 | `--disable feature_name` |
| `--config, -c` | 配置覆盖 | `-c model_reasoning_effort="xhigh"` |
| `--image, -i` | 附加图片 | `-i image.png` |
| `--cd, -C` | 设置工作目录 | `-C /path/to/project` |
| `--profile, -p` | 配置文件 profile | `-p my-profile` |
| `--oss` | 使用本地开源模型 (Ollama) | `--oss` |
## codex exec 专用参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--json` | 输出 JSONL 格式 | `--json` |
| `--output-last-message, -o` | 保存最终消息到文件 | `-o result.txt` |
| `--output-schema` | JSON Schema 验证输出 | `--output-schema schema.json` |
| `--color` | 颜色输出: `always`/`never`/`auto` | `--color never` |
| `--skip-git-repo-check` | 允许在非 Git 目录运行 | `--skip-git-repo-check` |
## 可用模型
- `gpt-5.5` - 最新推荐模型
- `gpt-5.4` - 上一代兼容模型
- `gpt-5.2` - 旧版兼容模型
## 推理强度配置
```bash
-c model_reasoning_effort="low" # 快速
-c model_reasoning_effort="medium" # 平衡
-c model_reasoning_effort="high" # 深度
-c model_reasoning_effort="xhigh" # 最深
```
## 无头模式用法
```bash
# 非交互执行
codex exec "fix all linting errors"
# 管道输入
echo "explain this error" | codex exec -
# YOLO 模式（跳过所有确认和沙箱）
codex --yolo "Your prompt"
# 或完整写法
codex --dangerously-bypass-approvals-and-sandbox "Your prompt"
# full-auto 模式（推荐的自动化方式）
codex --full-auto "Your prompt"
# 完整 YOLO 配置别名
alias c='codex --enable web_search_request -m gpt-5.5 -c model_reasoning_effort="xhigh" --yolo'
# 恢复最近会话
codex resume --last
codex exec resume --last "continue"
```
## 配置文件
配置存储在 `~/.codex/config.toml`：
```toml
model = "gpt-5.5"
sandbox = "workspace-write"
ask_for_approval = "on-failure"
[features]
web_search_request = true
```
## 常见问题
1. **审批弹窗**: 使用 `--yolo` 或 `--full-auto`
2. **需要联网**: 使用 `--search` 或 `--enable web_search_request`
3. **推理不够深**: 使用 `-c model_reasoning_effort="high"`
4. **非 Git 目录**: 使用 `--skip-git-repo-check`
skills/headless-cli/references/gemini-cli.md
+81
View File
@@ -0,0 +1,81 @@
# Gemini CLI 参数参考
> 来源: [官方文档](https://geminicli.com/docs/get-started/configuration/)
## 安装
```bash
npm install -g @anthropic-ai/gemini-cli
```
## 认证
首次运行会引导 Google 账号登录，或设置环境变量：
```bash
export GEMINI_API_KEY="YOUR_API_KEY"
```
## 核心命令行参数
| 参数 | 说明 | 示例 |
|:---|:---|:---|
| `--model <model>` | 指定模型 | `--model gemini-2.5-flash` |
| `--yolo` | YOLO 模式，自动批准所有工具调用 | `gemini --yolo` |
| `--approval-mode <mode>` | 审批模式: `default`/`auto_edit`/`yolo` | `--approval-mode auto_edit` |
| `--allowed-tools <tools>` | 允许的工具列表（逗号分隔） | `--allowed-tools ''` (禁用所有) |
| `--output-format <format>` | 输出格式: `text`/`json`/`stream-json` | `--output-format text` |
| `--sandbox` / `-s` | 启用沙箱模式 | `gemini -s` |
| `--prompt <prompt>` / `-p` | 非交互模式，直接传入提示词 | `gemini -p "query"` |
| `--prompt-interactive <prompt>` / `-i` | 交互模式，带初始提示词 | `gemini -i "explain"` |
| `--debug` / `-d` | 启用调试模式 | `gemini -d` |
## 可用模型
- `gemini-2.5-flash` - 快速模型
- `gemini-2.5-pro` - 高级模型
- `gemini-3-flash-preview` - 最新 Flash
- `gemini-3-pro-preview` - 最新 Pro
## 无头模式用法
```bash
# 基础无头调用（管道输入）
cat input.txt | gemini -p "Your prompt" --output-format text
# 禁用工具调用（纯文本输出）
cat input.txt | gemini -p "Your prompt" --output-format text --allowed-tools ''
# YOLO 模式（跳过所有确认）
gemini --yolo "Your prompt"
# 或使用 approval-mode
gemini --approval-mode yolo "Your prompt"
```
## 配置文件
配置存储在 `~/.gemini/settings.json` 或项目 `.gemini/settings.json`：
```json
{
"security": {
"disableYoloMode": false
},
"model": {
"name": "gemini-2.5-flash"
}
}
```
## 代理配置
```bash
export http_proxy=http://127.0.0.1:9910
export https_proxy=http://127.0.0.1:9910
```
## 常见问题
1. **MCP 初始化慢**: 使用 `--allowed-tools ''` 跳过
2. **超时**: 使用 `timeout` 命令包装
3. **输出包含日志**: 重定向 stderr `2>/dev/null`
skills/headless-cli/references/index.md
+15
View File
@@ -0,0 +1,15 @@
# Headless CLI References
> ⚠️ CLI 参数可能随版本更新变化，请以官方文档为准
## 目录
- [gemini-cli.md](./gemini-cli.md) - Gemini CLI 参数
- [claude-cli.md](./claude-cli.md) - Claude Code CLI 参数
- [codex-cli.md](./codex-cli.md) - Codex CLI 参数
## 官方文档
- [Gemini CLI](https://github.com/google-gemini/gemini-cli)
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
- [Codex CLI](https://github.com/openai/codex)