⭐ 使用建议
Claude Code CLI 命令大全
🚀 启动与基础命令
| 命令 | 功能说明 |
|---|---|
claude | 启动交互式 REPL 会话 |
claude "你的问题" | 直接提问,启动新会话 |
claude -c | 继续上一次对话(保留上下文摘要) |
claude -r | 选择并恢复历史对话 |
claude --model sonnet | 指定使用的模型 |
claude --verbose | 显示详细的工具调用日志 |
claude --version | 显示版本信息 |
🔧 管道与自动化命令
| 命令 | 功能说明 |
|---|---|
claude -p "任务描述" | 非交互模式,执行后直接输出结果 |
cat file.txt | claude -p "总结" | 管道模式,将文件内容传给 Claude |
claude -p "任务" --output-format json | JSON 格式输出 |
claude -p "任务" --max-turns 10 | 限制最大对话轮数 |
⚙️ 配置管理命令
| 命令 | 功能说明 |
|---|---|
claude config list | 列出所有配置项 |
claude config set <key> <value> | 设置配置项 |
claude mcp list | 列出已配置的 MCP 服务器 |
claude mcp add <name> <command> | 添加 MCP 服务器 |
斜杠命令(会话内使用)
💬 会话管理命令
| 命令 | 功能说明 |
|---|---|
/help | 显示帮助信息 |
/init | 初始化项目,生成 CLAUDE.md |
/compact | 压缩上下文,释放 token 空间 |
/cost | 显示当前会话的 token 消耗 |
/clear | 清除对话历史,重新开始 |
/model | 切换模型 |
/permissions | 查看和修改工具权限 |
/doctor | 诊断安装和配置问题 |
/review | 代码审查模式 |
Cline 使用技巧
⚖️ Cline vs Claude Code 对比
| 特性 | Claude Code | Cline |
|---|---|---|
| 运行环境 | 终端 CLI / VS Code 插件 | VS Code 插件 |
| 规则文件 | CLAUDE.md | .clinerules/ |
| 上下文管理 | 自动摘要,支持无限上下文 | 手动管理,有窗口限制 |
| 多 Agent | 支持 Task 子代理并行 | 不支持 |
| 适合场景 | 大规模重构、自动化 | 精细控制、计划模式 |
推荐搭配:用 Cline 的计划模式讨论方案,确认后用 Claude Code 执行大规模修改。
settings.json 配置
📁 配置文件位置
| 文件位置 | 作用范围 | 是否提交 Git |
|---|---|---|
~/.claude/settings.json | 全局配置 | 否 |
.claude/settings.json | 项目配置(团队共享) | 是 |
.claude/settings.local.json | 项目本地配置 | 否 |
CLAUDE.md 规则文件
📂 文件层级与作用范围
| 文件位置 | 作用范围 |
|---|---|
~/.claude/CLAUDE.md | 所有项目(全局规则) |
项目根目录/CLAUDE.md | 当前项目 |
子目录/CLAUDE.md | 该子目录下的文件 |
推荐的 CLAUDE.md 结构:
# 项目规则 ## 项目概述 - 项目名称和用途 - 技术栈说明 ## 代码规范 - 编码风格要求 - 命名约定 ## 常用命令 - 构建:npm run build - 测试:npm test - 启动:npm run dev ## 重要约定 - 不要修改 xxx 文件 - 错误处理统一使用 xxx 方式
提高效率技巧
⚡ 效率提升要点
- 使用
CLAUDE.md预设项目规则,减少重复说明 - 善用
/compact命令压缩上下文,节省 token - 大任务拆分为小步骤,每步完成后确认再继续
- 使用
claude -c继续上次对话,避免重复上下文 - 配置 settings.json 预设权限,减少手动确认
- 使用 Task 子代理并行处理独立任务
正确派发任务
核心原则:任务描述越清晰,AI 执行越准确。模糊的指令会导致 AI 反复确认,浪费 token。
好的任务描述包含:
- 目标 - 要实现什么功能
- 范围 - 涉及哪些文件/模块
- 约束 - 不能改动什么、要兼容什么
- 验证 - 如何确认完成
⚠️ 避免:"帮我优化一下代码" → 太模糊
推荐:"优化 src/api/user.ts 中的 getUserList 函数,将 N+1 查询改为批量查询,保持返回格式不变"
提示词模板
Bug 修复模板:
修复 [文件路径] 中的 [问题描述]。 现象:[具体表现] 期望:[正确行为] 约束:不要改动其他功能,保持向后兼容。
新功能开发模板:
在 [模块/文件] 中添加 [功能名称]。 需求:[详细描述] 技术要求:[框架/库/模式] 参考:[类似功能的文件路径]
代码审查模板:
审查 [文件路径] 的代码质量,关注: 1. 安全漏洞(SQL注入、XSS等) 2. 性能问题(N+1查询、内存泄漏) 3. 代码规范(命名、注释、错误处理) 4. 逻辑错误
突破上下文限制
🔄 上下文管理策略
- 定期压缩 - 使用
/compact命令压缩历史对话 - 任务分段 - 大任务拆分为多个独立会话
- 续接对话 - 使用
claude -c继续上次对话 - 规则预设 - 将常用规则写入 CLAUDE.md,减少每次重复说明
- 子代理 - 使用 Task 子代理处理独立子任务,不占用主上下文
Cline 用户上下文过长时的提示词:
总结当前任务关键信息我要另开窗口创建新的任务,必须生成正确的提示词使新任务窗口可以继续运行。
省钱技巧
💰 Token 节省策略
- 简单任务用 Sonnet,复杂任务用 Opus
- 善用
/compact压缩上下文 - 任务完成后用
/clear清除历史 - 写好 CLAUDE.md 减少重复说明
- 大文件操作使用
replace_in_file而非write_to_file - 避免让 AI 读取不相关的大文件
API 错误处理
🔧 常见错误速查
| 错误码 | 原因 | 解决方案 |
|---|---|---|
400 | 请求格式错误/上下文过长 | 压缩上下文或拆分文件 |
401 | API Key 无效 | 检查 Key 是否正确 |
403 | Key 未配置 | 配置 settings.json |
429 | 请求频率过高 | 等待后重试 |
500 | 服务器错误 | 稍后重试 |
详细解决方案请查看 报错解决 页面。
多工具协作
🤝 工具协作最佳实践
- Cline + Claude Code - Cline 计划模式讨论方案,Claude Code 执行修改
- ChatBox + 开发工具 - ChatBox 问答学习,开发工具写代码
- Claude Code + MCP - 通过 MCP 扩展 Claude Code 能力(文件系统、GitHub、数据库等)
- 多窗口并行 - 不同任务开不同窗口,互不干扰