Kc's blog

Appearance

kc_shen2026-04-11
3251
13.3m

Claude Code 使用指南 ​

Claude Code 是 Anthropic 提供的 终端 / IDE 里的智能编程 Agent：能读仓库、改多文件、跑命令、配合 Git 工作流，用自然语言描述任务即可。本文整理安装、常用启动方式、会话内 / 命令清单、项目配置与插件等入门用法；细节与命令以 官方文档 为准，产品迭代快，遇歧义请查官网。

1. 适用场景 ​

  • 适合：在真实仓库里改代码、跑测试、提交；希望「说清楚要做什么」由 Agent 拆解并执行多步操作。
  • 与纯聊天区别：深度绑定当前目录与工具链，可编辑文件、执行 shell、走 Git。
  • 与 Cursor 里装插件的关系：可并行使用；若在终端里用 Claude Code，可同时参考本站 Superpowers 使用指南 等工作流类插件说明。

2. 账号与计费 ​

多数环境需要 Claude 订阅 或 Anthropic Console 账号；终端与 VS Code 等也支持 第三方模型提供方。首次运行会引导登录，具体以 定价与条款 页面为准。

3. 安装（推荐用官方原生方式） ​

官方 README 写明：通过 npm 全局安装已标记为 deprecated，优先用下列方式（摘自 GitHub README 与 Setup 文档）。

3.1 macOS / Linux（推荐） ​

bash
curl -fsSL https://claude.ai/install.sh | bash

3.2 Homebrew（macOS / Linux） ​

bash
brew install --cask claude-code

说明：存在 claude-code（偏稳定通道）与 claude-code@latest（紧跟最新）等 cask 差异；Homebrew 安装不会像原生安装那样自动后台更新，需自行 brew upgrade。

3.3 Windows（PowerShell，推荐） ​

powershell
irm https://claude.ai/install.ps1 | iex

Windows 需已安装 Git for Windows。也可用 WinGet：

powershell
winget install Anthropic.ClaudeCode

3.4 不推荐：npm 全局（已弃用） ​

bash
npm install -g @anthropic-ai/claude-code

仅在你清楚维护方式时使用；新环境请改用上文原生或包管理器安装。

3.5 验证 ​

安装完成后在终端执行：

bash
claude --version

（若命令名或子命令有变动，以 claude --help 与官方 CLI 参考 为准。）

4. 第一次运行 ​

在项目根目录进入交互会话（官方习惯用法）：

bash
cd /path/to/your-project
claude

首次会提示 登录；按屏幕说明完成即可。更多「从探索仓库到提交修复」可走官方 Quickstart。

5. 会话内斜杠命令（/） ​

进入 claude 交互会话后，可用 / 命令控制模型、权限、上下文、插件等。安装 CLI、选择安装渠道仍以本文第 3 节为准，本节只整理会话里输入的命令（与安装步骤不重复）。

怎么查自己环境有哪些命令：在提示符输入 /，会列出当前账号、平台、套餐下对你可用的全部命令；继续输入字母可筛选。官方完整说明与参数格式见 Commands（官方用 <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打开设置（主题、模型、输出风格 等）（别名 /settings）
/status打开设置里的 Status 标签：版本、模型、账号、连接等；可在回答进行中打开
/model [model]选择或切换模型；支持左右键调 effort 的模型上立即生效
/effort [low|medium|high|max|auto]设置推理/用力档位；max 等为会话或长期策略见文档
/fast [on|off]开关 fast mode
/theme切换配色（含无障碍、ANSI 等）
/color [color|default]仅当前会话的提示条颜色
/statusline配置底部 status line
/terminal-setup配置终端快捷键（如 Shift+Enter）；仅在部分终端显示
/keybindings打开或创建快捷键配置文件

5.4 权限、安全与隐私 ​

命令作用
/permissions管理允许/询问/拒绝等工具规则与工作目录（别名 /allowed-tools）
/sandbox开关沙箱（仅部分平台）
/security-review基于当前分支 git diff 做安全审查
/privacy-settings查看/更新隐私设置（部分套餐可见）

5.5 插件、MCP、Hooks、IDE ​

命令作用
/plugin管理 Plugins（市场、安装、更新等）
/reload-plugins不重开会话即重载插件
/mcp管理 MCP 连接与 OAuth
/hooks查看 Hooks 配置
/ide管理 IDE 集成与状态
/chrome配置 Claude in Chrome

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 会话起草计划，浏览器里评审后再远程或拉回终端执行

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 相关）
/web-setup用本机 gh 凭据把 GitHub 接到网页端；/schedule 可能需要
/autofix-pr [prompt]为当前分支关联的 PR 开网页会话，CI 失败或 review 评论时自动推修复（需 gh CLI 等）
/install-github-app引导安装 Claude GitHub Actions 应用
/install-slack-app浏览器完成 Slack OAuth，安装 Slack 集成

5.8 账号、用量与第三方模型 ​

命令作用
/login登录 Anthropic 账号
/logout登出
/costToken 用量统计（订阅细则见 costs）
/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
/agents管理 sub-agents 配置
/tasks管理后台任务（同 /bashes）
/btw <问题>侧车式提问，不混入主对话
/mobile显示下载 iOS/Android 客户端的二维码（别名 /ios、/android）
/voice开关语音口述
/stickers订购贴纸（周边）

5.10 已弃用或移除（了解即可） ​

命令说明
/review已弃用：请安装官方 code-review 插件
/vimv2.1.92+ 移除：改用 /config → Editor mode
/pr-commentsv2.1.91+ 移除：改为直接让 Claude 查看 PR 评论

5.11 MCP 动态命令 ​

已连接的 MCP 服务器可暴露以 /mcp 开头的提示命令，格式为文档中的 /mcp____ 占位（实际名称由服务器注册）。详见 MCP prompts。

6. 常用使用方式 ​

6.1 交互式 REPL ​

直接运行 claude，在会话里用自然语言下指令，例如：

  • 解释某目录下的模块职责
  • 为某模块补测试并跑通
  • 根据报错栈定位并修改

6.2 单次任务（带初始提示） ​

bash
claude "用一句话描述你想做的事"

适合简短、目标明确的任务。

6.3 管道与脚本（-p 非交互） ​

适合日志分析、CI、批量审查等（示例来自官方概览）：

bash
tail -200 app.log | claude -p "若发现异常请总结要点"

git diff main --name-only | claude -p "检查这些变更的安全风险"

完整参数见 CLI reference。

6.4 Git 相关 ​

可直接让 Claude Code 暂存、写提交说明、建分支、协助 PR 等，例如：

bash
claude "用清晰的中文/英文写提交信息并提交当前改动"

（实际能力受权限与当前仓库状态约束。）

7. 项目内配置：CLAUDE.md ​

在仓库根目录放置 CLAUDE.md，用于会话开始时注入团队规范、技术栈、常用命令、禁止事项等；也可在已进入 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 用于接入外部数据源与工具（文档、工单、Slack 等）。
  • 自定义命令 / Skills：可把重复流程固化为可分享指令（见 Skills 文档）。
  • Hooks：在编辑、提交等动作前后执行 shell（见 Hooks）。

10. 其它入口（与终端同源能力） ​

入口说明
VS Code / Cursor 扩展在扩展视图（如 Cmd+Shift+X / Ctrl+Shift+X）搜索 Claude Code 安装；用命令面板打开 Claude Code 相关面板（官方文档 VS Code）
Desktop 客户端独立应用，适合可视化 diff、多会话等，见 Desktop 文档
浏览器claude.ai/code，免本地环境时可使用
JetBrains插件市场安装 Claude Code 插件

各端共享同一套引擎时，CLAUDE.md、部分设置与 MCP 可跨环境使用（以官方说明为准）。

11. 内置反馈与社区 ​

12. 延伸阅读（官方） ​

本文为入门向笔记；产品命令与权限以 Anthropic 当前文档与客户端提示为准。

最近更新