Claude Code 使用指南
Claude Code (opens new window) 是 Anthropic 提供的 终端 / IDE 里的智能编程 Agent：能读仓库、改多文件、跑命令、配合 Git 工作流，用自然语言描述任务即可。本文整理安装、常用启动方式、会话内 / 命令清单、项目配置与插件等入门用法；细节与命令以 官方文档 (opens new window) 为准，产品迭代快，遇歧义请查官网。
# 1. 适用场景
- 适合：在真实仓库里改代码、跑测试、提交；希望「说清楚要做什么」由 Agent 拆解并执行多步操作。
- 与纯聊天区别：深度绑定当前目录与工具链，可编辑文件、执行 shell、走 Git。
- 与 Cursor 里装插件的关系：可并行使用；若在终端里用 Claude Code，可同时参考本站 Superpowers 使用指南 等工作流类插件说明。
# 2. 账号与计费
多数环境需要 Claude 订阅 或 Anthropic Console 账号；终端与 VS Code 等也支持 第三方模型提供方 (opens new window)。首次运行会引导登录，具体以 定价与条款 (opens new window) 页面为准。
# 3. 安装（推荐用官方原生方式）
官方 README 写明：通过 npm 全局安装已标记为 deprecated，优先用下列方式（摘自 GitHub README (opens new window) 与 Setup 文档 (opens new window)）。
# 3.1 macOS / Linux（推荐）
curl -fsSL https://claude.ai/install.sh | bash
# 3.2 Homebrew（macOS / Linux）
brew install --cask claude-code
说明：存在 claude-code（偏稳定通道）与 claude-code@latest（紧跟最新）等 cask 差异；Homebrew 安装不会像原生安装那样自动后台更新，需自行 brew upgrade。
# 3.3 Windows（PowerShell，推荐）
irm https://claude.ai/install.ps1 | iex
Windows 需已安装 Git for Windows (opens new window)。也可用 WinGet：
winget install Anthropic.ClaudeCode
# 3.4 不推荐：npm 全局（已弃用）
npm install -g @anthropic-ai/claude-code
仅在你清楚维护方式时使用；新环境请改用上文原生或包管理器安装。
# 3.5 验证
安装完成后在终端执行：
claude --version
（若命令名或子命令有变动，以 claude --help 与官方 CLI 参考 (opens new window) 为准。）
# 4. 第一次运行
在项目根目录进入交互会话（官方习惯用法）：
cd /path/to/your-project
claude
2
首次会提示 登录；按屏幕说明完成即可。更多「从探索仓库到提交修复」可走官方 Quickstart (opens new window)。
# 5. 会话内斜杠命令（/）
进入 claude 交互会话后，可用 / 命令控制模型、权限、上下文、插件等。安装 CLI、选择安装渠道仍以本文第 3 节为准，本节只整理会话里输入的命令（与安装步骤不重复）。
怎么查自己环境有哪些命令：在提示符输入 /，会列出当前账号、平台、套餐下对你可用的全部命令；继续输入字母可筛选。官方完整说明与参数格式见 Commands (opens new window)（官方用 <arg> 表示必填、[arg] 表示可选）。
下列按用途分类摘录（[Skill] 表示捆绑技能，本质是交给 Claude 的一段「剧本」，也可能在相关任务时被自动唤起）。并非每个用户都能看到每一条（例如 /desktop 仅 macOS/Windows，/upgrade 与部分隐私项与套餐相关）。
# 5.1 项目与记忆
| 命令 | 作用 |
|---|---|
/init | 为项目生成 CLAUDE.md 引导；设置环境变量 CLAUDE_CODE_NEW_INIT=1 可走交互流程（顺带梳理 skills、hooks、个人记忆等） |
/memory | 编辑 CLAUDE.md 记忆文件、开关 auto-memory、查看自动记忆条目 |
/add-dir <path> | 为当前会话增加可访问的工作目录（注意：多数 .claude/ 配置不会从新增目录里被发现） |
# 5.2 会话、历史与导出
| 命令 | 作用 |
|---|---|
/clear | 清空对话历史、释放上下文（别名 /reset、/new） |
/compact [instructions] | 压缩对话，可选附带「希望保留侧重点」的说明 |
/context | 可视化上下文占用，并给出优化建议 |
/copy [N] | 复制最近第 N 条助手回复到剪贴板；有代码块时可交互选块，w 可写入文件（SSH 下有用） |
/branch [name] | 从当前位置分叉对话（别名 /fork） |
/resume [session] | 按 ID/名称恢复会话，或打开选择器（别名 /continue） |
/rewind | 回退对话和/或代码到检查点（别名 /checkpoint） |
/export [filename] | 导出当前会话为纯文本 |
/rename [name] | 重命名当前会话，名称显示在提示条 |
/diff | 交互式 diff：未提交变更与各轮助手修改 |
# 5.3 设置、模型与界面
| 命令 | 作用 |
|---|---|
/config | 打开设置（主题、模型、输出风格 (opens new window) 等）（别名 /settings） |
/status | 打开设置里的 Status 标签：版本、模型、账号、连接等；可在回答进行中打开 |
/model [model] | 选择或切换模型；支持左右键调 effort 的模型上立即生效 |
/effort [low\|medium\|high\|max\|auto] | 设置推理/用力档位 (opens new window)；max 等为会话或长期策略见文档 |
/fast [on\|off] | 开关 fast mode (opens new window) |
/theme | 切换配色（含无障碍、ANSI 等） |
/color [color\|default] | 仅当前会话的提示条颜色 |
/statusline | 配置底部 status line (opens new window) |
/terminal-setup | 配置终端快捷键（如 Shift+Enter）；仅在部分终端显示 |
/keybindings | 打开或创建快捷键配置文件 |
# 5.4 权限、安全与隐私
| 命令 | 作用 |
|---|---|
/permissions | 管理允许/询问/拒绝等工具规则与工作目录（别名 /allowed-tools） |
/sandbox | 开关沙箱 (opens new window)（仅部分平台） |
/security-review | 基于当前分支 git diff 做安全审查 |
/privacy-settings | 查看/更新隐私设置（部分套餐可见） |
# 5.5 插件、MCP、Hooks、IDE
| 命令 | 作用 |
|---|---|
/plugin | 管理 Plugins (opens new window)（市场、安装、更新等） |
/reload-plugins | 不重开会话即重载插件 |
/mcp | 管理 MCP 连接与 OAuth |
/hooks | 查看 Hooks (opens new window) 配置 |
/ide | 管理 IDE 集成与状态 |
/chrome | 配置 Claude in Chrome (opens new window) |
# 5.6 捆绑技能（[Skill]）与工作流
| 命令 | 作用 |
|---|---|
/batch <任务描述> | 大规模并行改造：调研后拆成多单元，每单元在独立 git worktree 里后台代理并开 PR（需 git 仓库）。例：/batch migrate src/ from Solid to React |
/debug [description] | 打开调试日志、结合会话日志排查问题（若未用 claude --debug 启动，从执行 /debug 起开始记日志） |
/simplify [focus] | 对近期改动做多代理审查并自动修复；可加关注面，如 /simplify focus on memory efficiency |
/claude-api | 载入 Claude API 参考（多语言 SDK、流式、批处理等）；项目里出现 anthropic / @anthropic-ai/sdk 时也可能自动激活 |
/loop [interval] [prompt] | 会话内定时重复执行提示；可省略间隔由 Claude 自控；无 prompt 时可跑维护检查或读 .claude/loop.md |
/plan [description] | 直接进入 plan mode，可带初始任务说明，如 /plan fix the auth bug |
/ultraplan <描述> | 在 ultraplan (opens new window) 会话起草计划，浏览器里评审后再远程或拉回终端执行 |
# 5.7 远程、桌面、GitHub 与计划任务
| 命令 | 作用 |
|---|---|
/desktop | 将当前会话转到 Desktop 应用（macOS/Windows；别名 /app） |
/remote-control | 允许从 claude.ai 遥控本会话（别名 /rc） |
/teleport | 把 网页端 Claude Code 会话拉进当前终端（别名 /tp，需 claude.ai 订阅等条件） |
/remote-env | 配置 --remote 网页会话的默认远程环境 |
/schedule [description] | 创建/管理 云端定时任务（与 Web scheduled tasks (opens new window) 相关） |
/web-setup | 用本机 gh 凭据把 GitHub 接到网页端；/schedule 可能需要 |
/autofix-pr [prompt] | 为当前分支关联的 PR 开网页会话，CI 失败或 review 评论时自动推修复（需 gh CLI 等） |
/install-github-app | 引导安装 Claude GitHub Actions (opens new window) 应用 |
/install-slack-app | 浏览器完成 Slack OAuth，安装 Slack 集成 |
# 5.8 账号、用量与第三方模型
| 命令 | 作用 |
|---|---|
/login | 登录 Anthropic 账号 |
/logout | 登出 |
/cost | Token 用量统计（订阅细则见 costs (opens new window)） |
/usage | 套餐用量与限流状态 |
/extra-usage | 配置超出限额时的额外用量策略 |
/upgrade | 打开升级套餐页面 |
/passes | 邀请好友试用（账户符合条件时才显示） |
/setup-bedrock | 交互配置 Amazon Bedrock（需 CLAUDE_CODE_USE_BEDROCK=1 才可见） |
/setup-vertex | 交互配置 Google Vertex AI（需 CLAUDE_CODE_USE_VERTEX=1 才可见） |
# 5.9 其它常用
| 命令 | 作用 |
|---|---|
/help | 帮助与命令列表 |
/exit | 退出 CLI（别名 /quit） |
/doctor | 诊断安装与配置是否正常 |
/feedback [report] | 提交反馈（别名 /bug） |
/insights | 基于历史会话生成交互与摩擦点分析 |
/stats | 用量、会话、 streak、模型偏好等可视化 |
/release-notes | 交互式查看各版本更新说明 |
/powerup | 互动小教程与动效，了解功能 |
/skills | 列出可用 Skills (opens new window) |
/agents | 管理 sub-agents (opens new window) 配置 |
/tasks | 管理后台任务（同 /bashes） |
/btw <问题> | 侧车式提问 (opens new window)，不混入主对话 |
/mobile | 显示下载 iOS/Android 客户端的二维码（别名 /ios、/android） |
/voice | 开关语音口述 |
/stickers | 订购贴纸（周边） |
# 5.10 已弃用或移除（了解即可）
| 命令 | 说明 |
|---|---|
/review | 已弃用：请安装官方 code-review 插件 (opens new window) |
/vim | v2.1.92+ 移除：改用 /config → Editor mode |
/pr-comments | v2.1.91+ 移除：改为直接让 Claude 查看 PR 评论 |
# 5.11 MCP 动态命令
已连接的 MCP 服务器可暴露以 /mcp 开头的提示命令，格式为文档中的 /mcp____ 占位（实际名称由服务器注册）。详见 MCP prompts (opens new window)。
# 6. 常用使用方式
# 6.1 交互式 REPL
直接运行 claude，在会话里用自然语言下指令，例如：
- 解释某目录下的模块职责
- 为某模块补测试并跑通
- 根据报错栈定位并修改
# 6.2 单次任务（带初始提示）
claude "用一句话描述你想做的事"
适合简短、目标明确的任务。
# 6.3 管道与脚本（-p 非交互）
适合日志分析、CI、批量审查等（示例来自官方概览）：
tail -200 app.log | claude -p "若发现异常请总结要点"
git diff main --name-only | claude -p "检查这些变更的安全风险"
2
3
完整参数见 CLI reference (opens new window)。
# 6.4 Git 相关
可直接让 Claude Code 暂存、写提交说明、建分支、协助 PR 等，例如：
claude "用清晰的中文/英文写提交信息并提交当前改动"
（实际能力受权限与当前仓库状态约束。）
# 7. 项目内配置：CLAUDE.md
在仓库根目录放置 CLAUDE.md (opens new window)，用于会话开始时注入团队规范、技术栈、常用命令、禁止事项等；也可在已进入 claude 会话时用 /init 辅助初始化（见上文第 5.1 节）。官方还支持 自动记忆（auto memory），会在工作中沉淀构建命令、调试结论等（见文档「Memory」章节）。
# 8. 插件（Plugins）
在 Claude Code 内可使用 /plugin 系列命令管理插件（安装市场、安装包、更新等），与你在 Superpowers 等文中看到的 superpowers@claude-plugins-official 安装方式一致。具体子命令以当前版本内置帮助为准。
# 9. MCP、Skills、Hooks（进阶）
- MCP：Model Context Protocol (opens new window) 用于接入外部数据源与工具（文档、工单、Slack 等）。
- 自定义命令 / Skills：可把重复流程固化为可分享指令（见 Skills 文档 (opens new window)）。
- Hooks：在编辑、提交等动作前后执行 shell（见 Hooks (opens new window)）。
# 10. 其它入口（与终端同源能力）
| 入口 | 说明 |
|---|---|
| VS Code / Cursor 扩展 | 在扩展视图（如 Cmd+Shift+X / Ctrl+Shift+X）搜索 Claude Code 安装；用命令面板打开 Claude Code 相关面板（官方文档 VS Code (opens new window)） |
| Desktop 客户端 | 独立应用，适合可视化 diff、多会话等，见 Desktop 文档 (opens new window) |
| 浏览器 | claude.ai/code (opens new window)，免本地环境时可使用 |
| JetBrains | 插件市场安装 Claude Code 插件 |
各端共享同一套引擎时，CLAUDE.md、部分设置与 MCP 可跨环境使用（以官方说明为准）。
# 11. 内置反馈与社区
- 遇到问题可在会话中使用
/bug向官方反馈（见 GitHub README）。 - 社区：Claude Developers Discord (opens new window)。
- 源码与 Issue：https://github.com/anthropics/claude-code (opens new window)
# 12. 延伸阅读（官方）
- Overview (opens new window)
- Commands（斜杠命令完整表） (opens new window)
- Setup（安装、卸载、排错） (opens new window)
- Common workflows (opens new window)
- Best practices (opens new window)
- Troubleshooting (opens new window)
本文为入门向笔记；产品命令与权限以 Anthropic 当前文档与客户端提示为准。