⭐ 使用建议

Claude Code CLI 命令大全

🚀 启动与基础命令
命令 功能说明
claude 启动交互式 REPL 会话
claude "你的问题" 直接提问,启动新会话
claude -c 继续上一次对话(保留上下文摘要)
claude -r 选择并恢复历史对话
claude --model sonnet 指定使用的模型(sonnet / opus / haiku)
claude --allowedTools "Bash,Read,Write" 限制可用工具范围
claude --verbose 显示详细的工具调用日志
claude --version 显示版本信息
claude --help 显示帮助信息
🔧 管道与自动化命令
命令 功能说明
claude -p "任务描述" 非交互模式,执行后直接输出结果(适合脚本/管道)
cat file.txt | claude -p "总结这个文件" 管道模式,将文件内容传给 Claude 处理
claude -p "任务" --output-format json JSON 格式输出(适合脚本解析)
claude -p "任务" --output-format stream-json 流式 JSON 输出
claude -p "任务" --max-turns 10 限制最大对话轮数
claude -p "生成测试" --allowedTools "Bash,Write" 自动化脚本中限制工具
⚙️ 配置管理命令
命令 功能说明
claude config list 列出所有配置项
claude config set <key> <value> 设置配置项
claude config get <key> 获取配置项的值
claude mcp list 列出已配置的 MCP 服务器
claude mcp add <name> <command> [args...] 添加 MCP 服务器
claude mcp remove <name> 移除 MCP 服务器

斜杠命令(会话内使用)

💬 会话管理命令
命令 功能说明
/help 显示帮助信息和可用命令列表
/init 初始化项目,自动生成 CLAUDE.md 规则文件
/compact 压缩上下文,释放 token 空间(关键省钱命令)
/cost 显示当前会话的 token 消耗和费用
/clear 清除当前对话历史,重新开始
/model 切换模型(如从 Sonnet 切到 Opus)
/quitCtrl+C 退出当前会话
🔧 配置与诊断命令
命令 功能说明
/permissions 查看和修改工具权限
/config 查看和修改配置
/doctor 诊断安装和配置问题
/mcp 查看 MCP 服务器状态
/add-dir <path> 添加额外的工作目录
/terminal-setup 设置终端集成(Shift+Enter 换行等)
📋 开发辅助命令
命令 功能说明
/review 代码审查模式
/pr-comments 查看 PR 评论
/bug 报告 Bug
/status 查看账户状态和使用量
/login 登录账户
/logout 退出登录

Cline 使用技巧

🔧 Cline 基本操作
快捷操作:
  • 点击「计划」按钮 - 切换到计划模式,与 AI 讨论任务方案后再执行
  • 点击「操作」按钮 - 切换到操作模式,让 AI 直接执行任务
  • 点击「批准」按钮 - 批准 AI 提出的操作
  • 点击「拒绝」按钮 - 拒绝 AI 提出的操作并给出反馈
  • 拖放文件 - 直接将文件拖入聊天窗口供 AI 分析
配置文件:
  • .clinerules/ - 项目规则目录,存放自定义规则文件(类似 CLAUDE.md)
  • .clineignore - 忽略文件列表,防止 AI 读取敏感文件
⚖️ Cline vs Claude Code 对比
特性 Claude Code Cline
运行环境 终端 CLI / VS Code 插件 VS Code 插件
规则文件 CLAUDE.md .clinerules/
上下文管理 自动摘要,支持无限上下文 手动管理,有上下文窗口限制
工具调用 可配置自动执行 默认需要手动批准
多 Agent 支持 Task 子代理并行 不支持
适合场景 大规模重构、自动化、CI/CD 精细控制、计划模式讨论

推荐搭配:用 Cline 的计划模式讨论方案,确认后用 Claude Code 执行大规模修改,效率最高。

settings.json 配置

📁 配置文件位置
文件位置 作用范围 是否提交 Git
~/.claude/settings.json 全局配置,影响所有项目
.claude/settings.json 项目配置,仅影响当前项目 是(团队共享)
.claude/settings.local.json 项目本地配置,仅影响当前项目 否(个人私有)

权限配置示例 - 预设常用命令权限,避免每次确认:

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git *)",
      "Bash(ls *)",
      "Read",
      "Write",
      "Edit",
      "Glob",
      "Grep",
      "WebFetch",
      "WebSearch"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  }
}

环境变量配置 - 设置 API Key 和模型:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-...",
    "ANTHROPIC_BASE_URL": "https://api.xstx.info",
    "ANTHROPIC_MODEL": "claude-sonnet-4-20250514"
  }
}
点击展开/收起 MCP 服务器配置示例
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}
点击展开/收起 Hooks 配置示例
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{
          "type": "command",
          "command": "echo "Bash tool is being used""
        }]
      }
    ],
    "PostToolUse": [],
    "Notification": [],
    "Stop": []
  }
}

Hooks 事件说明:

  • PreToolUse - 工具调用前触发(可用于拦截危险操作)
  • PostToolUse - 工具调用后触发(可用于自动格式化代码)
  • Notification - 通知事件触发(可用于发送桌面通知)
  • Stop - Agent 停止时触发(可用于自动提交代码)
🔄 模型切换方式
方式 说明
ANTHROPIC_MODEL 环境变量 在 settings.json 中设置默认模型
claude --model sonnet 命令行参数临时切换
/model 斜杠命令 会话内实时切换模型
🌐 API Provider 配置
Provider 配置方式
Anthropic API(默认) 设置 ANTHROPIC_API_KEY
Amazon Bedrock 设置 CLAUDE_CODE_USE_BEDROCK=1
Google Vertex AI 设置 CLAUDE_CODE_USE_VERTEX=1
中转站 API 设置 ANTHROPIC_BASE_URL

CLAUDE.md 规则文件

📂 文件层级与作用范围
文件位置 作用范围 是否提交 Git
~/.claude/CLAUDE.md 所有项目(全局规则)
项目根目录/CLAUDE.md 当前项目
项目根目录/.claude/CLAUDE.md 当前项目
子目录/CLAUDE.md 该子目录下的文件

推荐的 CLAUDE.md 结构:

# 项目规则

## 项目概述
- 项目名称和用途
- 技术栈说明

## 代码规范
- 编码风格要求
- 命名约定
- 文件组织结构

## 常用命令
- 构建命令:npm run build
- 测试命令:npm test
- 启动命令:npm run dev

## 重要约定
- 不要修改 xxx 文件
- 使用 xxx 框架的 xxx 模式
- 错误处理统一使用 xxx 方式

## 自主执行权限
- 允许自动执行的操作
- 禁止执行的操作
点击展开/收起 完整 CLAUDE.md 高级模板
# 全局规则 - CLAUDE.md (Global)

此文件为所有项目提供全局规则指导。

## ⚡ 自主执行权限 - 最高优先级

【唯一限制】
- 不删除.csv/.xlsx文件
- 不删除任何项目的Temp目录内容

## 🔄 API错误智能切换规则

【智能切换策略 - 遇错即换】
第1次失败:立即切换到备选工具/方法执行
第2次失败:再换另一种工具/方法
第3次失败:简化操作,拆分成更小的步骤执行
持续失败:循环尝试所有可用方案直到成功

## 🌐 通用开发规则

【语言规则】
- 始终用中文回答

【修改规则】
- 每次修改都必须先全链条理解清楚所有有关联的上下文代码和需求后再改
- 只做最少修改,完成需求
- 修改完后自行检查代码,确保能编译通过

【禁止操作】
- 禁止修改任何与需求无关的功能
- 禁止删除.csv/.xlsx文件

【任务执行】
- 所有问题直接修改代码,不要停下来询问
- 修改完后直接运行测试
- 任务中断时自动继续执行

## ⚡ 无限的上下文窗口

【自动摘要启用】
- 通过自动摘要实现无限的上下文窗口

高级技巧:在 CLAUDE.md 中配置 Skills 自动记录,让 Claude 将成功的解决方案保存到 .claude/skills/ 目录,下次遇到相同问题时自动复用。

提高效率技巧

项目初始化流程:

  1. 进入项目目录后运行 claude 启动会话
  2. 使用 /init 命令自动生成 CLAUDE.md 规则文件
  3. 根据项目需求调整 CLAUDE.md 内容
  4. 在 settings.json 中配置权限规则,避免重复确认

上下文管理:

  • 及时使用 /compact - 当对话变长时压缩上下文,可节省 30-50% token
  • 使用 /cost 监控消耗 - 定期检查 token 使用量,及时调整策略
  • 分段处理大任务 - 将大任务拆分为多个小会话,避免上下文过长
  • 善用 -c 继续对话 - claude -c 继续上一次对话,避免重复上下文

管道用法示例:

# 批量代码审查
git diff | claude -p "审查这些代码变更"

# 自动生成提交信息
git diff --staged | claude -p "生成 commit message" | git commit -F -

# 解释错误日志
cat error.log | claude -p "分析这些错误并给出解决方案"

# 批量处理文件
find . -name "*.js" | claude -p "列出所有使用了 deprecated API 的文件"
⌨️ 快捷键
快捷键 功能
Ctrl+C 中断当前操作
Ctrl+C 两次 退出会话
Shift+Enter 输入多行内容(需先运行 /terminal-setup
Esc 取消当前输入
上/下箭头 浏览历史输入

工具权限优化:在 settings.json 中预设常用命令的权限(如 Bash(npm run *)),可以避免每次都要手动确认,大幅提升工作效率。

正确派发任务

避免常见误区:不要直接说「帮我改一下代码」,要提供明确的上下文、范围和预期结果。

任务派发四原则:

  1. 先理解再修改 - 让 AI 先阅读相关代码,确认理解后再修改
  2. 明确范围 - 清楚说明要修改什么,不要修改什么
  3. 提供上下文 - 告诉 AI 项目背景、技术栈、约束条件
  4. 分步执行 - 大任务拆分为小步骤,逐步完成并验证

Bug 修复模板:

文件 xxx.ts 的第 xx 行有一个 bug:[描述问题]
预期行为:[描述预期]
实际行为:[描述实际]
请修复这个 bug,不要修改其他功能。

新功能模板:

请在 [文件/模块] 中添加 [功能描述]。
技术要求:
- [要求1]
- [要求2]
参考现有的 [类似功能] 的实现方式。
不要修改现有功能。

代码审查模板:

请审查 [文件/目录] 的代码,重点关注:
- 安全漏洞
- 性能问题
- 代码规范
- 潜在 Bug

重构模板:

请重构 [文件/模块],目标是:
- [重构目标]
保持所有现有功能不变,确保测试通过。

高级任务派发技巧:

  • 使用 TODO 清单 - 让 AI 先生成任务清单,确认后逐一执行
  • 使用计划模式 - 先让 AI 制定计划,审核后再执行
  • 增量验证 - 每完成一步就验证结果,再进行下一步

提示词模板

项目理解提示词:

请阅读这个项目的所有代码,理解项目结构和功能。
然后生成一份 README.md,包含:
- 项目概述
- 技术栈
- 目录结构说明
- 主要功能模块
- 如何运行和部署

代码解释提示词:

请解释 [文件名] 中 [函数名/类名] 的实现逻辑,
包括:输入参数、处理流程、返回值、与其他模块的关系。

测试生成提示词:

请为 [文件名] 中的 [函数名/类名] 编写单元测试。
使用 [测试框架] 框架。
覆盖以下场景:正常输入、边界条件、异常输入。

性能优化提示词:

请分析 [文件/模块] 的性能瓶颈,并提出优化建议。
重点关注:数据库查询、循环效率、内存使用、缓存策略。

安全审计提示词:

请对 [文件/目录] 进行安全审计,检查:
- SQL 注入
- XSS 攻击
- CSRF 漏洞
- 敏感信息泄露
- 权限控制问题

突破上下文限制

自动摘要机制:

Claude Code 内置自动摘要功能,当上下文接近限制时会自动压缩历史对话,理论上可以实现无限上下文。只需在 CLAUDE.md 中声明启用即可:

## ⚡ 无限的上下文窗口

【自动摘要启用】
- 通过自动摘要实现无限的上下文窗口

手动管理上下文:

🧠 上下文管理方法
方法 说明
/compact 手动触发上下文压缩,可附带提示词指导压缩重点。例如:/compact 保留所有关于数据库修改的上下文
/clear 完全清除对话历史,重新开始
claude -c 继续上一次对话(包含自动摘要)

CLAUDE.md 实现持久记忆:

CLAUDE.md 文件在每次会话开始时都会被读取,相当于 AI 的「长期记忆」。将重要的项目规则、约定、常用命令写入 CLAUDE.md,可以确保 AI 始终记住这些信息。

Skills 自动记录:

## Skills 自动记录
- 成功解决问题后自动记录到 .claude/skills/ 目录
- 下次遇到相同问题时自动复用
- 记录内容包括:问题场景、根本原因、修复模板、验证方法

Continuity Ledger(连续性账本):

## Continuity Ledger (Path: doc/ folder)

Maintain a single Continuity Ledger at: doc/CONTINUITY.md

### How it works
- Read First: At the start of every turn, read doc/CONTINUITY.md
- Create if Missing: If not exist, create immediately
- Update Logic: Update to reflect latest Goal, Decisions, State

### Formatting
- ✅ 已完成 / ▶️ 进行中 / ⏸️ 待办 / ❓ 待确认

省钱技巧

💰 模型选择策略
任务类型 推荐模型 原因
简单代码修改 Sonnet 速度快,成本低,日常开发首选
复杂架构设计 Opus 推理能力强,适合复杂任务
代码补全/格式化 Haiku 最便宜,简单任务足够
日常开发 Sonnet 性价比最高

减少 Token 消耗的 6 个方法:

  1. 善用 /compact - 对话变长时及时压缩,可节省 30-50% token
  2. 精确描述任务 - 避免模糊描述导致 AI 多次尝试
  3. 使用 -p 模式 - 单次任务用 claude -p 避免交互开销
  4. 限制工具范围 - --allowedTools 减少不必要的工具调用
  5. 分会话处理 - 不相关的任务用新会话,避免携带无关上下文
  6. 使用 /cost 监控 - 定期检查消耗,及时调整策略

权限预设省确认:

在 settings.json 中预设权限,避免每次确认消耗额外 token:

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git *)",
      "Bash(ls *)",
      "Read",
      "Write",
      "Edit"
    ]
  }
}

使用中转站省钱:通过 ANTHROPIC_BASE_URL 配置中转站 API,中转站通常提供更优惠的价格。注意选择可靠的中转站服务。

API 错误处理

🚨 常见错误码及解决方案
错误码 含义 解决方案
401 API Key 无效 检查 Key 是否正确,是否过期
403 权限不足 检查 API Key 权限设置
429 请求频率超限 等待后重试,或升级套餐
500 服务器内部错误 等待后重试
502 网关错误 等待后重试
503 服务不可用 等待后重试
529 API 过载 等待较长时间后重试

自动重试配置(写入 CLAUDE.md):

## 🔄 API错误自动重试规则 - 最高优先级

【错误自动处理机制】
当遇到以下API错误时,必须自动重试:
- 502 Bad Gateway
- 500 Internal Server Error
- 503 Service Unavailable
- 429 Too Many Requests

【自动重试策略】
1. 第一次错误:等待5秒后自动重试
2. 第二次错误:等待10秒后自动重试
3. 第三次错误:等待20秒后自动重试
4. 第四次错误:等待30秒后自动重试
5. 第五次及以后:等待60秒后继续重试

智能工具切换策略(写入 CLAUDE.md):

🔄 工具失败时的替换方案
失败工具 替换方案 1 替换方案 2 替换方案 3
Task(Agent) 直接用 Grep + Read 用 Glob 搜索 分步手动执行
Bash 拆分命令单独执行 用 Read/Write 替代 简化命令参数
Edit 用 Write 重写整个文件 分多次小 Edit 先 Read 确认再 Edit
WebFetch WebSearch 替代 简化 prompt 分段获取
Grep Glob + Read 组合 缩小搜索范围 精确指定路径

多工具协作

推荐工作流:

Claude Code (终端) + VS Code (编辑器) + Cline (VS Code 插件)

工作流程:
1. 用 Cline 的计划模式讨论方案
2. 确认方案后用 Claude Code 执行大规模修改
3. 在 VS Code 中查看 diff、微调代码
4. 用 Claude Code 运行测试和验证
🛠️ 各工具最佳使用场景
工具 最佳场景
Claude Code CLI 大规模重构、自动化脚本、CI/CD 集成、跨文件修改
Claude Code for VS Code 日常开发、代码编辑、实时预览、与编辑器深度集成
Cline 需要精细控制的任务、计划模式讨论方案、逐步审批

协作技巧:

  • Claude Code 做重活 - 大规模代码修改、跨文件重构、自动化任务
  • VS Code 做细活 - 微调代码、查看 diff、手动修正细节
  • Cline 做规划 - 用计划模式讨论方案,确认后用 Claude Code 执行

MCP 服务器扩展能力:

通过 MCP(Model Context Protocol)服务器可以扩展 Claude Code 的能力:

🔌 常用 MCP 服务器
服务器 功能
filesystem 增强的文件系统操作
github GitHub API 集成(PR、Issue 等)
puppeteer 浏览器自动化(截图、测试等)
sequential-thinking 复杂推理和分步思考
memory 知识图谱记忆
local-rag 本地文档检索增强

添加 MCP 服务器:

# 命令行方式添加
claude mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /path

# 或在 settings.json 中配置 mcpServers 字段(参考上方 settings.json 配置板块)