Claude Code 使用说明

Claude Code 使用说明

版本：v2.1.88+ | 更新日期：2026年4月

一、Claude Code 简介

Claude Code 是 Anthropic 推出的官方 AI 编程代理工具，运行在终端中。它不是简单的代码补全工具，而是能够理解整个代码库、自主规划任务、执行复杂操作的AI工程师搭档。

1.1 核心能力

•读取整个代码库，跨文件编辑

•执行 Shell 命令、Git 操作

•自主规划并执行多步骤任务

•通过 MCP 协议集成外部工具

•支持浏览器自动化、数据库访问等

二、安装与配置

2.1 官方推荐安装

macOS / Linux / WSL:

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

Windows PowerShell:

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

2.2 验证安装

claude –version

2.3 配置认证

方式一：使用 Anthropic API Key

export ANTHROPIC_API_KEY=”sk-ant-xxx”

方式二：使用 Claude.ai 账户登录

claude login

三、核心斜杠命令

Claude Code 提供了 45+ 个斜杠命令，以下是常用命令列表：

命令	功能	使用频率
/help	查看所有可用命令	★★★
/clear	清空对话历史并释放上下文	★★★★★
/compact	压缩对话历史但保留摘要	★★★★
/plan	进入计划模式（只读）	★★★★
/init	初始化 CLAUDE.md 项目文档	★★★
/model	切换 AI 模型	★★★
/context	可视化上下文使用情况	★★
/cost	显示当前会话费用与时长	★★
/export	导出会话到文件或剪贴板	★★★
/copy	复制 Claude 输出的代码块	★★★
/diff	交互式查看所有修改	★★★★
/mcp	管理 MCP 服务器	★★
/skills	列出可用技能	★★

四、工作模式

Claude Code 支持三种工作模式：

模式	触发方式	说明
Normal Mode	默认启动	危险操作前弹窗请求批准
Plan Mode	Shift+Tab 两次或 /plan	只读分析，不执行任何修改
Auto-Accept	–dangerously-skip-permissions	自动批准所有操作（谨慎使用）

五、可用 Skill 列表

Claude Code 支持以下内置 Skill，可通过 /skills 查看完整列表：

Skill 名称	功能描述	触发场景
simplify	审查变更代码的可重用性、质量和效率，并修复发现的问题	代码审查、优化
loop	按间隔循环运行提示或斜杠命令（如 /loop 5m /foo，默认10分钟）	定时任务、循环执行
claude-api	使用 Claude API 或 Anthropic SDK 构建应用	API开发、SDK集成
internal:biz-prompt	企业级 SOP 提示词架构师	生成提示词、Prompt设计
internal:banana-slides	生成、创建、制作 PPT/演示文稿/幻灯片	制作PPT、生成演示文稿
internal:browser-agent	使用 WeiboAP 内置浏览器进行网页浏览和自动化交互	打开网页、浏览器操作
internal:dingding-doc	钉钉文档综合操作工具	钉钉文档、知识库管理
internal:dingding-cli	管理钉钉产品能力	钉钉表格、日历、审批等
internal:deep-research	深度搜索、查询、研究	调研、搜索、分析
internal:excel-analysis	分析 Excel 电子表格	Excel分析、数据处理
internal:expense-reimbursement	发票助手	报销、提交发票
internal:docx	综合文档创建、编辑和分析	Word文档处理
internal:file-organizer	智能文件归档整理工具	整理文件夹、归档文件
internal:notebooklm	查询 Google NotebookLM 笔记本	NotebookLM查询
internal:exchange-mail-guide	Exchange 邮箱助手	查邮件、发邮件、邮箱管理
internal:prototype-deploy	将本地项目打包部署	部署原型、获取预览链接
internal:gif-sticker-maker	将照片转换为动画 GIF 贴纸	制作GIF、表情包
internal:onboard	AI伙伴互动教程系统	学习教程、入门指南
internal:pdf-anthropic	PDF 综合操作工具包	PDF处理、分析
internal:team-power	多代理团队编排	多Agent协作
internal:weiboap-guide	WeiboAP 使用帮助助手	WeiboAP使用帮助
internal:scheduled-task	帮助用户创建和管理定时任务	定时提醒、周期任务
internal:weibo-search-guide	微博搜索助手	搜索微博、查看热搜
internal:xiaohongshu-search	小红书搜索导航技能	小红书搜索、浏览

六、常用快捷键

快捷键	功能
Esc	立即停止当前工具执行
Esc + Esc	回退对话 / 打开检查点菜单
Shift + Tab（按2次）	切换 Plan Mode
!命令	直接执行 Shell（如 !git status）
@文件名	精确注入上下文（如 @src/app.tsx）
Ctrl + G	在 Plan Mode 下修改计划
Ctrl + V	粘贴截图到对话

七、上下文管理

Claude Code 的上下文窗口有限，学会管理上下文能让你用得更顺。

7.1 关键命令

•/clear – 清空全部对话历史（切换任务前使用）

•/compact [说明] – 智能压缩历史，保留摘要

•/context – 可视化显示上下文使用比例

•/cost – 查看当前会话 token 用量

7.2 黄金法则

同一个问题修正超过两次，直接 /clear 用更精确的提示重新开始。新会话+好提示 > 长会话+累积修正。

八、模型选择

模型	适用场景	价格	备注
Claude Sonnet 4.6	日常编程，性价比最高	★★	默认推荐
Claude Opus 4.6	复杂架构推理、疑难调试	★★★★	最高智能
Claude Haiku 4.5	简单快速任务	★	最低延迟

切换模型：/model 或 claude –model claude-opus-4-6

九、截图与导出操作

9.1 粘贴截图

1. 截图到剪贴板（使用系统截图工具）：

•Windows: Win + Shift + S

•macOS: Cmd + Shift + 4 或 Cmd + Shift + 5

2. 在 Claude Code 中直接按 Ctrl + V 粘贴即可

9.2 导出会话

/export

/export > session-log.md

十、禁用 Skill

在当前项目禁用已全局安装的 Skill：

10.1 通过 settings.json 配置

创建项目级配置文件 .claude/settings.json：

{ “skills”: { “disabledSkills”: [“loop”, “skill-name-2”] } }

10.2 启动参数禁用

claude –disallowedTools “skill1,skill2,skill3”

十一、快速开始示例

1. 进入项目目录并启动：

cd /path/to/your/project claude

2. 输入需求：

分析这个目录结构，并为一个简单的 Node.js Web API 项目建议合理的文件结构

十二、相关资源

•官网：https://claude.com/product/claude-code

•文档：https://docs.anthropic.com/en/docs/claude-code

•帮助：在 Claude Code 中输入 /help