Claude Code常用操作指南

一、启动与基础用法

交互模式

claude                    # 在当前目录启动交互式会话
claude "分析这个项目"      # 带初始 prompt 启动

非交互模式（管道/脚本）

claude -p "解释这段代码"                    # 输出结果后退出
claude -p --output-format json "查版本"     # JSON 格式输出
claude -p --model opus "复杂任务..."        # 指定模型
cat file.txt | claude -p "总结一下"         # 管道输入

---

二、会话管理

命令	说明
claude	新建会话
claude -c / claude --continue	继续最近一次会话
claude -r / claude --resume	打开会话选择器，选一个恢复
claude --resume <session-id>	按 ID 恢复指定会话
claude --resume <关键词>	模糊搜索恢复会话
claude --fork-session -r	从旧会话分叉出新会话（不覆盖原会话）
claude -n "我的任务"	给本次会话命名（便于后续识别）
claude --no-session-persistence -p "..."	不保存本次会话到磁盘

交互模式内

• /resume — 列出并恢复历史会话
• /name <名称> — 重命名当前会话

---

三、模型与性能控制

参数	说明
--model <模型名>	指定模型，如 sonnet、opus、haiku 或完整名称
--effort <level>	推理深度：low / medium / high / xhigh / max
--fallback-model <模型>	主模型过载时自动回退（仅 -p 模式）
--max-budget-usd <金额>	API 花费上限（仅 -p 模式）

示例：

claude --model opus --effort high
claude -p --model sonnet --max-budget-usd 5 "生成测试"

---

四、权限控制

参数 / 模式	说明
--permission-mode default	默认：危险操作需确认
--permission-mode acceptEdits	自动接受文件编辑
--permission-mode auto	全自动（跳过所有确认）
--permission-mode plan	仅规划模式，不执行修改
--permission-mode bypassPermissions	绕过所有权限检查
--dangerously-skip-permissions	极不安全，仅限无网络沙箱
--add-dir <目录>	允许访问额外目录

---

五、工具控制

# 只允许特定工具
claude --allowedTools "Bash(git *) Edit Read"

# 禁用特定工具
claude --disallowedTools "Bash(rm *) WebSearch"

# 指定工具列表
claude --tools "Bash,Edit,Read,Glob,Grep"

---

六、配置与设置

claude --settings ./my-settings.json          # 加载额外设置文件
claude --setting-sources user,project,local   # 指定设置来源

交互模式内：

• /config — 打开配置界面，修改主题/模型/权限等
• /update-config — 编辑 settings.json 配置 hook、权限等

---

七、MCP 服务器（外部工具集成）

claude --mcp-config ./mcp.json           # 加载 MCP 配置
claude --strict-mcp-config --mcp-config  # 仅用指定 MCP，忽略其他

交互模式内：

• claude mcp — 管理 MCP 服务器
• /mcp — 交互式管理 MCP

---

八、插件

claude --plugin-dir ./my-plugin          # 本地插件目录
claude --plugin-url https://...          # 从 URL 加载插件

交互模式内：

• claude plugin / claude plugins — 管理插件

---

九、IDE 与远程控制

命令	说明
claude --ide	自动连接 IDE
claude --remote-control [名称]	启动可远程控制的会话
claude --chrome	启用 Chrome 集成

---

十、Git Worktree 隔离

claude -w                  # 自动创建 git worktree 并在隔离环境工作
claude -w "feature-x"      # 指定 worktree 名称
claude --tmux -w           # 同时创建 tmux 会话

---

十一、交互模式斜杠命令

在交互式会话中可使用的常用命令：

命令	说明
/help	查看帮助
/clear	清空当前会话上下文
/resume	浏览并恢复历史会话
/name <名称>	重命名当前会话
/config	打开设置界面
/model <模型>	切换模型
/fast	切换快速模式（仅 Opus 4.6）
/memory	查看/管理持久记忆
/init	为当前项目生成 CLAUDE.md
/review	代码审查当前分支
/security-review	安全审查当前分支
/simplify	审查代码的质量和复用性
/loop [间隔] <命令>	定时重复执行命令
/agents	管理后台 Agent
/cost	查看当前会话费用
/todos	查看任务列表
/status	显示当前会话状态

---

十二、健康检查与更新

claude doctor           # 诊断 Claude Code 健康状态
claude update           # 检查并安装更新
claude install stable   # 安装稳定版（或 latest / 特定版本）
claude --version / -v   # 查看版本号

---

十三、调试

claude -d                # 开启调试日志
claude -d "api,hooks"    # 按类别过滤调试日志
claude --debug-file ./debug.log   # 调试日志写入文件
claude --verbose         # 详细输出模式

---

十四、其他常用参数

参数	说明
--system-prompt <提示词>	自定义系统提示词
--append-system-prompt <追加>	追加内容到系统提示词
--agents <json>	定义自定义 Agent
--session-id <uuid>	指定会话 UUID
--disable-slash-commands	禁用所有斜杠命令
--bare	极简模式：跳过 hooks/LSP/插件等
--betas <header>	发送 Beta 头（API Key 用户）

---

十五、认证

claude auth              # 管理认证
claude setup-token       # 设置长期令牌（需订阅）

---

提示: 在交互模式中输入 /help 可随时查看内置帮助。所有会话历史本地存储在 ~/.claude/ 目录下。