| name | claude-code |
| description | Claude Code CLI 完整使用指南 - 持续迭代中
包含安装、命令、工作流、Skills、子代理、MCP 集成等
|
| version | 2.0.0 |
| author | 0xCryptoZen |
| tags | ["claude","code","cli","development","ai","coding"] |
| triggers | ["claude code","claude cli","code assistant"] |
Claude Code CLI 完整指南 v2.0
持续迭代中 - 基于官方文档和实践
目录
- 安装
- 基础命令
- 工作流
- Skills
- 子代理
- MCP 集成
- 管道和自动化
- OpenClaw 集成
安装
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
验证
claude --version
claude auth status
基础命令
| 命令 | 说明 |
|---|
claude | 启动交互式 REPL |
claude "query" | 带初始提示启动 |
claude -p "query" | 单次查询后退出 |
claude -c | 继续最近的会话 |
claude -r "session" "query" | 恢复指定会话 |
claude update | 更新到最新版本 |
CLI Flags
| Flag | 说明 |
|---|
--continue, -c | 继续最近的会话 |
--dangerously-skip-permissions | 跳过所有权限提示 |
--permission-mode plan | 计划模式(只读分析) |
--allowedTools | 允许的工具列表 |
--add-dir | 添加额外工作目录 |
--debug | 启用调试模式 |
--agent | 指定子代理 |
--agents | 定义自定义子代理 |
工作流
1. 理解新代码库
claude
> give me an overview of this codebase
> explain the main architecture patterns
2. 修复 Bug
claude "I'm seeing an error when I run npm test"
claude "suggest ways to fix it"
3. 重构代码
claude "find deprecated API usage"
claude "refactor utils.js to use modern JavaScript features"
4. 编写测试
claude "write tests for the auth module"
claude "run them and fix any failures"
5. 创建 PR
claude "commit my changes with a descriptive message"
claude "create a PR for this feature"
6. Plan Mode(计划模式)
claude --permission-mode plan
claude -p --permission-mode plan "Analyze the auth system"
Skills
Skills 扩展 Claude 的能力,可以自定义指令和命令。
创建 Skill
在 ~/.claude/skills/<skill-name>/SKILL.md 创建:
---
name: my-skill
description: 当需要做某事时使用
---
你的指令内容...
Skill 位置
| 位置 | 路径 | 适用范围 |
|---|
| 个人 | ~/.claude/skills/<name>/SKILL.md | 所有项目 |
| 项目 | .claude/skills/<name>/SKILL.md | 当前项目 |
调用 Skill
"帮我做某事" (匹配 description)
/my-skill
子代理
子代理是专门处理特定任务的 AI 助手。
内置子代理
| 子代理 | 模型 | 用途 |
|---|
| Explore | Haiku | 快速代码搜索(只读) |
| Plan | 继承主对话 | 研究和规划 |
| General-purpose | 继承主对话 | 复杂多步骤任务 |
使用子代理
claude "use explore to find auth related files"
/agents
创建自定义子代理
---
name: code-reviewer
description: 检查代码安全问题
model: sonnet
tools:
- Read
- Bash
---
你是一个代码审查员...
MCP 集成
Model Context Protocol (MCP) 连接外部数据源。
配置 MCP
claude mcp
常用 MCP 服务器
- Google Drive
- Jira
- Slack
- GitHub
- 数据库
- 更多...
添加 MCP 服务器
claude mcp add <server-name>
管道和自动化
管道用法
cat logs.txt | claude -p "explain these errors"
tail -f app.log | claude -p "alert if you see anomalies"
git diff main --name-only | claude -p "review for security issues"
自动化脚本
claude -p "write tests for auth module"
claude -c "finish the feature"
OpenClaw 集成
通过 Claude Adapter 远程控制 Claude CLI。
Adapter 仓库
启动 Adapter
cd claude-adapter
npm install
npm run build
node server.js
WebSocket 控制
const WebSocket = require('ws');
const ws = new WebSocket('ws://127.0.0.1:8080');
ws.on('open', () => {
ws.send(JSON.stringify({
method: 'session.create',
params: { workingDirectory: '/path/to/project' },
id: 'create'
}));
});
ws.on('message', (data) => {
const msg = JSON.parse(data);
if (msg.event?.type === 'output_delta') {
console.log(msg.event.data);
}
});
演示脚本
node demo-control.js
最佳实践
- 明确描述任务 - 越具体越好
- 提供上下文 - 包含错误信息、文件路径
- 分步骤执行 - 复杂任务分解为小步骤
- 验证结果 - 让 Claude 运行测试验证
- 使用 CLAUDE.md - 设置项目规范
- 使用 Skills - 封装常用工作流
- 使用子代理 - 分离探索和实现
版本历史
v2.0.0 (2026-02-16)
- 添加 Skills 系统
- 添加子代理详解
- 添加 MCP 集成
- 添加 OpenClaw 集成
- 添加管道和自动化
v1.0.0 (2026-02-16)
Ralph 自动化循环
Ralph 实现自动化的 Claude Code 开发循环。
核心功能
- 自动开发循环 - 持续执行直到完成
- 智能退出检测 - 双重条件:完成指标 + EXIT_SIGNAL
- 速率限制 - 防止 API 过度使用
- 断路器 - 防止无限循环
使用方法
const { RalphLoop } = require('./dist/ralph-loop');
const loop = new RalphLoop({
maxIterations: 50,
completionIndicators: ['✅', '完成', 'DONE'],
exitSignals: ['EXIT_SIGNAL: true', 'STATUS: COMPLETE'],
rateLimit: 100,
circuitBreakerThreshold: 5
});
await loop.run('创建 Hello World 程序');
退出条件
- 需要同时满足:
- 完成指标出现
- EXIT_SIGNAL: true 出现
断路器
连续 5 次检测到完成指标时强制退出,防止无限循环。
Claude Adapter 集成
cd claude-adapter
node ralph-demo.js