Claude Code 命令使用指南

CLI 启动命令

基本用法

# 交互模式：进入 REPL 对话
claude

# 带初始提问启动
claude "帮我分析这个项目的架构"

# 单次查询模式（非交互，输出后退出）
claude -p "解释什么是 React Server Components"

# JSON 输出（适合脚本集成）
claude -p "列出项目依赖" --output-format json

常用选项

# 模型选择
claude -m opus              # 使用 Opus 模型
claude -m sonnet           # 使用 Sonnet 模型
claude -m haiku            # 使用 Haiku 模型
claude --model opus

# 权限模式
claude --permission-mode plan   # 计划模式
claude --permission-mode auto    # 自动模式
claude --permission-mode default # 默认模式

# 会话控制
claude -c              # 继续上一次对话
claude -r <session-id> # 恢复指定会话

# 限制输出
claude -p "任务" --max-turns 10    # 最大轮次限制
claude -p "任务" --output-format json  # JSON 输出

# 自定义提示
claude -p "审查代码" --system-prompt "你是一个安全审计专家"
claude -p "优化性能" --append-system-prompt "关注数据库查询优化"

# 工具限制
claude -p "分析代码" --allowedTools "Read,Glob,Grep"
claude -p "修复 bug" --disallowedTools "Bash"

# 调试
claude --verbose              # 详细输出
claude --add-dir /path/to/lib # 添加额外工作目录

管道输入

# 代码审查
cat src/utils.ts | claude -p "审查这段代码"
git diff | claude -p "总结这次改动"
git diff origin/main...HEAD | claude -p "审查这些变更"

---

REPL 交互命令

认证管理

命令	说明
/login	登录或切换 Anthropic 账号
/logout	退出登录
/status	查看账号、模型、会话状态

会话控制

命令	说明
/clear	清空对话历史，重新开始
/compact	压缩对话以减少上下文占用
/compact <指令>	自定义压缩，保留特定上下文
/cost	查看 token 用量和费用
/diff	查看待处理的文件变更
/undo	撤销最近的变更
/resume	恢复会话

模型切换

命令	说明
/model	交互式选择模型
/model opus	切换到 Opus（最强）
/model sonnet	切换到 Sonnet（均衡）
/model haiku	切换到 Haiku（最快最便宜）

模式切换

命令	说明
/plan	切换计划模式
/fast	切换快速模式
/think	切换深度思考模式
/vim	切换 vim 键绑定

项目配置

命令	说明
/init	初始化项目 CLAUDE.md
/memory	编辑记忆文件
/config	打开设置界面
/project	查看项目级设置
/permissions	查看和管理权限

MCP 与扩展

命令	说明
/mcp	查看 MCP 服务器状态

诊断工具

命令	说明
/doctor	运行诊断检查
/bug	报告 bug
/feedback	提交反馈
/add-dir	添加额外工作目录
/context	查看上下文来源
/statusline	配置状态栏
/terminal-setup	配置终端集成

---

键盘快捷键

快捷键	功能
Enter	发送消息
\ + Enter	换行（多行输入）
Escape	取消当前生成
Ctrl+C	取消生成或退出
Ctrl+D	退出 Claude Code
Ctrl+L	清屏
Tab	接受工具调用
Shift+Tab	自动批准本轮所有操作
↑ / ↓	浏览历史消息
@	引用文件路径（自动补全）

---

MCP 服务器命令

管理命令

# 添加 stdio 类型的 MCP 服务器
claude mcp add my-db-tool -- node /path/to/server.js

# 添加 SSE 类型的 MCP 服务器
claude mcp add --transport sse my-api https://api.example.com/mcp

# 指定作用域
claude mcp add -s user my-tool -- command    # 用户级（所有项目）
claude mcp add -s project my-tool -- command # 项目级（默认）

# 管理
claude mcp list                # 列出所有 MCP 服务器
claude mcp remove my-tool      # 移除
claude mcp reset               # 重置所有配置

常见 MCP 用例

• 数据库查询：连接 PostgreSQL/MySQL，让 Claude 直接查数据
• Jira/Linear：读取和更新项目管理工具中的任务
• Figma：读取设计稿，生成对应的前端代码
• Sentry：查看错误日志，辅助排查 bug

---

自定义命令

命令文件位置

.claude/commands/deploy.md      → /project:deploy
.claude/commands/test.md        → /project:test
.claude/commands/db/migrate.md  → /project:db:migrate
~/.claude/commands/review.md    → /user:review

命令文件格式

<!-- .claude/commands/deploy.md -->
构建项目并部署到生产服务器。

步骤：
1. 运行 `npm run build`
2. 运行测试确保没有回归
3. 部署到服务器
4. 验证部署结果

$ARGUMENTS

$ARGUMENTS 会被替换为用户输入的参数：

/project:deploy 只部署前端
# $ARGUMENTS = "只部署前端"

---

Hooks 配置

Hook 类型

Hook	触发时机	用途
PreToolUse	工具执行前	拦截危险操作、自动格式化
PostToolUse	工具执行后	自动运行 lint、记录日志
Notification	Claude 发送通知时	桌面通知、Slack 通知
Stop	Claude 停止生成时	自动运行测试
SubagentStop	子代理停止时	子任务完成后的清理

配置示例

在 .claude/settings.json 中：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write $CLAUDE_FILE_PATH"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint"
          }
        ]
      }
    ]
  }
}

---

环境变量

变量	用途
ANTHROPIC_API_KEY	API 密钥
ANTHROPIC_AUTH_TOKEN	替代认证 token
ANTHROPIC_BASE_URL	自定义 API 端点
ANTHROPIC_MODEL	覆盖默认模型
CLAUDE_CODE_USE_BEDROCK	使用 AWS Bedrock
CLAUDE_CODE_USE_VERTEX	使用 Google Vertex AI
DISABLE_PROMPT_CACHING	禁用提示缓存
CLAUDE_CODE_MAX_OUTPUT_TOKENS	最大输出 token 数

---

IDE 集成

VS Code / JetBrains

快捷键	功能
Cmd+Esc / Ctrl+Esc	快速启动 Claude Code
Cmd+Option+K / Alt+Ctrl+K	插入文件引用

在 IDE 中可以直接选中代码，右键让 Claude 解释、重构或修复。

---

CI/CD 集成

GitHub Actions 示例

- name: AI Code Review
  run: |
    git diff origin/main...HEAD | claude -p "审查这些变更，输出发现的问题" \
      --output-format json \
      --max-turns 3

作为 MCP 服务器运行

# 让其他工具通过 MCP 协议调用 Claude Code
claude mcp serve

远程控制

# 启动远程控制模式
claude remote-control