1. 安装与检查
安装 Claude Code
npm install -g @anthropic-ai/claude-code如果国内网络下载慢，可临时使用镜像源：
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com检查环境
| 命令 | 用途 |
|---|---|
claude --version | 查看当前 Claude Code 版本。 |
claude doctor | 诊断安装、登录、权限和配置问题。 |
claude update | 手动更新 Claude Code。 |
2. 启动命令
交互模式
| 命令 | 用途 |
|---|---|
claude | 在当前项目目录启动 Claude Code 交互会话。 |
claude "解释这个项目" | 启动会话，并把引号内文本作为初始提示。 |
claude -c | 继续当前目录最近一次会话。 |
claude --resume | 打开历史会话选择器。 |
claude --resume <session-id> | 按 session id 恢复指定会话。 |
claude --model sonnet | 启动时指定模型，可用别名或完整模型名。 |
启动时权限参数
| 参数 | 用途 |
|---|---|
--permission-mode <mode> | 设置启动权限模式，例如 default、acceptEdits、plan、auto、dontAsk、bypassPermissions。 |
--allowedTools <tools> | 启动时允许指定工具列表，多个工具用逗号分隔。 |
--disallowedTools <tools> | 启动时禁止指定工具列表，优先用于屏蔽高风险工具。 |
--tools <tools> | 指定当前会话可用工具集合。 |
--add-dir <path> | 额外授予 Claude 访问指定目录的权限。 |
--dangerously-skip-permissions | 跳过权限确认。只建议在隔离容器或可信自动化环境中使用。 |
权限启动示例
先规划，不直接改文件
claude --permission-mode plan适合大改动前让 Claude 先读代码、拆方案、列风险。
自动接受编辑
claude --permission-mode acceptEdits适合你已经明确任务边界，希望减少每次文件编辑确认的场景。
限制可用工具
claude --allowedTools Read,Edit,Bash用于只开放必要工具。工具名以当前版本和 /permissions 中显示为准。
屏蔽高风险工具
claude --disallowedTools Bash适合只想让 Claude 阅读、分析和改文件，但暂时不让它运行命令。
允许访问额外目录
claude --add-dir ../shared-libs当项目依赖工作区外的共享代码时，可以额外开放目录。
谨慎跳过权限确认
claude --dangerously-skip-permissions这个参数会显著降低人工确认保护。仅在隔离环境、临时容器或你完全信任任务输入时使用。
3. 使用过程中的斜杠命令
在 Claude Code 输入框开头键入 /，可以打开当前版本支持的命令菜单。以下是常见命令分组。
项目与配置
/init：初始化项目说明，生成或更新CLAUDE.md。/memory：查看和编辑记忆文件。/mcp：管理 MCP 服务器连接和认证。/permissions：查看或调整工具权限规则。/config：打开配置面板。
会话与模型
/model：切换当前会话模型。/status：查看账号、模型、目录和配置状态。/cost：查看当前会话 token 与费用估算。/context：查看上下文窗口占用。/compact：压缩长会话，保留关键上下文。
清理与审查
/clear：清空当前对话，开启新会话。/resume：恢复历史会话。/review：请求 Claude 对当前改动做代码审查。/help：查看帮助和命令说明。/doctor：诊断当前环境问题。
4. 高频快捷键与输入方式
快捷键
| 快捷键 | 用途 |
|---|---|
Esc | 中断当前回复或工具调用，适合及时纠偏。 |
Ctrl+C | 中断当前操作；无运行任务时可清空输入或退出。 |
Ctrl+R | 反向搜索历史输入。 |
Ctrl+O | 打开 transcript viewer，查看更详细的工具调用过程。 |
Ctrl+T | 显示或隐藏任务列表。 |
Shift+Tab | 切换输入或权限相关模式，具体状态以底部提示为准。 |
输入方式
/：打开命令和技能菜单，继续输入可过滤。!：运行 Shell 命令，并把输出带回上下文，例如! npm test。@：触发文件路径补全，明确指定要看的文件。#：快速把规则、偏好或项目知识写入记忆。Shift+Enter、Ctrl+J或\+Enter：输入多行内容。Ctrl+B：把长时间运行的 Bash 命令或后台任务放到后台。
5. 使用小技巧
新项目先初始化
第一次进入项目后先运行 /init。把技术栈、目录结构、构建命令、测试命令和代码规范写进 CLAUDE.md，后续 Claude 会更稳定地按项目习惯工作。
大改动先要计划
不要一开始就让 Claude 改很多文件。先输入「先不要改文件，列出实现计划、涉及文件和风险」，确认后再让它执行。
明确验证方式
让 Claude 修改代码时，同时告诉它验证命令，例如 npm test、pnpm typecheck、cargo test。也可以在会话里直接输入 ! npm test。
长会话及时压缩
当会话变长、回答开始跑偏或上下文快满时，先用 /context 看占用，再用 /compact 压缩关键内容。
文件引用要具体
用 @ 指定文件，比笼统说「看一下代码」更高效。例如输入 @src/api.ts 帮我解释这个模块。
需要深度思考时说清楚
复杂架构、疑难 bug 或高风险重构，可以在提示里写 think、think harder 或 ultrathink，让 Claude 分配更多推理预算。
参考来源
本页内容参考 Claude Code CLI reference、Slash commands、Interactive mode。整理日期：2026-06-04。