开发日常
开发工具篇
AI工具

Claude Code操作教程

# Claude Code 操作教程

# 安装 Claude Code

# windows

安装 Node.js (opens new window) 18+。
Windows 用户需安装 Git for Windows (opens new window)。
在命令行界面，执行以下命令安装 Claude Code：

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

安装结束后，执行以下命令，若显示版本号则安装成功：

claude --version

卸载

# 卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code

# 验证是否卸载成功（若提示命令不存在则卸载成功）
claude --version

1
2
3
4
5

如需彻底清理本地配置和会话数据，可删除以下目录：

~/.claude/（Windows 下为 C:\Users\<用户名>\.claude\）：存放配置、会话记录、skills 等
~/.claude.json（Windows 下为 C:\Users\<用户名>\.claude.json）：存放 MCP 服务器、项目配置等

# python 环境安装

参考文档：2026年Python3.14.x安装与环境配置保姆级教程（Windows版）_python3.14安装教程-CSDN博客 (opens new window)

# 配置环境变量（api）

默认是 Claude 官方的环境配置，中国区域内会不允许连接访问

cc-switch 管理工具安装：

CC Switch 官方网站 - AI 编程工具统一管理平台 (opens new window)

各大厂商官方接入文档

# 常用指令

官方文档：CLI 参考 - Claude Code Docs (opens new window)

# 启动与退出

# 启动交互式会话
claude

# 使用初始提示启动会话
claude "explain this project"

# 通过 SDK 查询后退出（非交互式）
claude -p "explain this function"

# 处理管道内容
cat logs.txt | claude -p "explain"

1
2
3
4
5
6
7
8
9
10
11

退出当前会话：

/exit 或者连续按两次 ctrl + c

# 会话恢复

常用的恢复命令有：

claude -c — 继续当前目录最近一次的会话
claude --resume — 从所有历史会话中挑选恢复
claude --resume <name> — 直接恢复命名的会话
/resume — 在会话内恢复历史会话

# 常用斜杠命令（会话内）

命令	作用
`/help`	查看帮助信息
`/exit`	退出当前会话
`/clear`	清空上下文，重新开始对话
`/compact [instructions]`	压缩历史记录为摘要，可选专注于指定内容
`/context`	显示当前消耗的上下文
`/resume`	恢复历史会话
`/rename <name>`	重命名当前会话
`/branch [name]`	分支当前会话，尝试不同方法
`/export [file]`	导出当前对话到剪贴板或文件
`/mcp`	查看 MCP 服务器状态
`/doctor`	检查安装和设置健康状况
`/add-dir <path>`	添加额外的工作目录

# 常用 CLI 命令

命令	作用
`claude --version`	查看版本号
`claude update`	更新到最新版本
`claude doctor`	打印安装和设置诊断信息
`claude auth login`	登录 Anthropic 账户
`claude auth logout`	登出账户
`claude auth status`	查看身份验证状态
`claude mcp list`	列出所有配置的 MCP 服务器
`claude mcp add <name> <url>`	添加 MCP 服务器
`claude mcp remove <name>`	删除 MCP 服务器

# 常用 CLI 标志

标志	作用
`-c` / `--continue`	继续最近的会话
`--resume`	打开会话选择器
`-n <name>`	为会话命名
`-p "query"`	非交互式查询后退出
`--model <model>`	指定模型
`--add-dir <path>`	添加额外工作目录
`--bare`	最小模式，跳过 hooks/skills/MCP 等加载，启动更快
`--debug`	启用调试模式
`--dangerously-skip-permissions`	跳过权限提示（慎用）

# skills 安装

官方介绍：使用 skills 扩展 Claude - Claude Code Docs (opens new window)

简单理解：Skill = 给 Claude Code 增加一个可复用的专业能力包。

技能市场，Skill.sh 网站：The Agent Skills Directory (opens new window)

例如：

Superpowers（完整开发流程）
find-skills（自动查找skill）
everything-claude-code（多角色协作）
ui-ux-pro-max-skill（UI 设计）
sanyuan-skills（代码审查）
web-access（网页浏览与操作）
skill-creator（自制 Skill）

Claude Code 启动时只读取每个 Skill 的简介（description），当发现你的任务匹配时才加载完整内容，因此几乎不浪费上下文窗口。

# Skills 和 CLAUDE.md 的区别

很多新手容易搞混。

功能	CLAUDE.md	Skills
项目规则	✅	❌
编码规范	✅	✅
自动触发	❌	✅
可单独调用	❌	✅
大量知识库	不推荐	推荐
上下文占用	一直占用	按需加载

例如，你的Java项目：

CLAUDE.md
├─ 项目介绍
├─ 技术栈
├─ 编码规范

Skills
├─ springboot
├─ mybatis
├─ kafka
├─ vue3

1
2
3
4
5
6
7
8
9
10

# Skills 常用命令

# 安装全局 Skill，并跳过确认
npx skills add <skill-url> -g -y
## 例如
npx skills add https://github.com/vercel-labs/skills --skill find-skills -g

---
# 安装指定 Skill
npx skills add <skill-url> --skill <skill-name> -g
## 例如
npx skills add https://github.com/vercel-labs/skills --skill find-skills -g

---
# 查看全局已安装的 Skills
npx skills list -g
## 输出示例，~ 代表：当前用户的 Home（用户主目录 C:\Users\乔），Agents 代表关联的 agent（如果没有则代表没关联上）
C:\Users\乔>npx skills list -g 
Global Skills 

find-skills ~\.claude\skills\find-skills Agents: Claude Code 

# 关联 Skill 到 Claude Code
npx skills link <skill-name> --agent "Claude Code"
## 例如
npx skills link find-skills --agent "Claude Code"

---
# 删除全局 Skill
npx skills remove <skill-name> -g
## 例如
npx skills remove find-skills -g

---
# 查看 Skills CLI 帮助
npx skills --help
## 或者查看某个命令：
npx skills add --help

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# grill-me（理清开发需求）

安装指令

npx skills add https://github.com/mattpocock/skills --skill grill-me

# find-skills（自动查找skill）

安装指令

# 全局安装，跳过确认
npx skills add https://github.com/vercel-labs/skills --skill find-skills -g -y

1
2

# skill-creator（自制 Skill）

安装指令

# 全局安装，跳过确认
npx skills add https://github.com/anthropics/skills --skill skill-creator -g -y

1
2

# archify

地址：archify/README_ZH.md at main · tt-a1i/archify · GitHub (opens new window)

快速开始

安装

npx skills add tt-a1i/archify -g

显式、非交互地安装到 Cursor：

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

如果只想临时体验：

npx skills use tt-a1i/archify@archify --agent codex

# ui-ux-pro-max-skill（UI 设计）

地址：nextlevelbuilder/ui-ux-pro-max-skill (opens new window)

安装指令

npx skills add nextlevelbuilder/ui-ux-pro-max-skill --skill ui-ux-pro-max -g -y

# sanyuan-skills（代码审查）

安装指令

npx skills add sanyuan/sanyuan-skills -g -y

# web-access（网页浏览与操作）

安装指令

npx skills add vercel-labs/agent-browser --skill agent-browser -g -y

# Superpowers（完整开发流程）

地址：obra/superpowers (opens new window)

包含多个子技能：brainstorming、systematic-debugging、writing-plans、test-driven-development、requesting-code-review、verification-before-completion 等。

安装指令

npx skills add obra/superpowers -g -y

# everything-claude-code（多角色协作）

安装指令

npx skills add anthropics/skills --skill everything-claude-code -g -y

# MCP 安装

官方文档：通过 MCP 将 Claude Code 连接到工具 - Claude Code Docs (opens new window)

简单理解：MCP = 给 Claude Code 接入外部工具/数据源的标准协议。

MCP（Model Context Protocol）是一个开源的 AI 工具集成标准，Claude Code 通过它连接到数百个外部工具和数据源（如 JIRA、GitHub、Sentry、PostgreSQL、Figma、Slack 等）。连接后，Claude 可以直接读取和操作这些系统，而不需要你手动复制粘贴数据。

# MCP 安装范围

MCP 服务器可以在三个不同的范围级别进行配置：

范围	加载位置	与团队共享	存储位置
本地（local，默认）	仅当前项目	否	`~/.claude.json`
项目（project）	仅当前项目	是，通过版本控制	项目根目录的 `.mcp.json`
用户（user）	你的所有项目	否	`~/.claude.json`

使用 -s 或 --scope 标志指定范围。

# 添加远程 HTTP 服务器（推荐）

HTTP 是连接远程 MCP 服务器的推荐方式，云服务最广泛支持。

# 基本语法
claude mcp add --transport http <name> <url>

# 真实示例：连接到 Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 带有 Bearer 令牌的示例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

1
2
3
4
5
6
7
8
9

# 添加本地 stdio 服务器

Stdio 服务器作为本地进程运行，适合需要直接系统访问或自定义脚本的工具。

# 基本语法（注意 -- 分隔符）
claude mcp add [options] <name> -- <command> [args...]

# 真实示例：添加 Airtable 服务器
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

1
2
3
4
5
6

重要：--（双破折号）将 Claude 自己的选项与运行服务器的命令和参数分开。-- 之后的所有内容都原封不动地传递给服务器。

# 从 JSON 配置添加 MCP 服务器

如果服务器说明提供了 mcpServers JSON 块（如 Claude Desktop 的配置），可以用 claude mcp add-json 添加：

# 从 JSON 添加
claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

# 添加项目范围（与团队共享）
claude mcp add-json --scope project shared-server \
  '{"type":"http","url":"https://example.com/mcp"}'

1
2
3
4
5
6

# 管理 MCP 服务器

# 列出所有配置的服务器（显示连接状态）
claude mcp list

# 获取特定服务器的详细信息
claude mcp get notion

# 删除服务器
claude mcp remove notion

# 在会话内检查服务器状态
/mcp

1
2
3
4
5
6
7
8
9
10
11

claude mcp list 会在每个服务器旁边显示健康状态，例如 ✔ Connected、! Needs authentication 或 ✘ Failed to connect。

# 常用 MCP 服务器示例

# Notion（笔记/知识库）
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Asana（项目管理，SSE 传输）
claude mcp add --transport sse asana https://mcp.asana.com/sse

# Stripe（支付）
claude mcp add --transport http stripe https://mcp.stripe.com

# HubSpot（CRM，用户范围）
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

1
2
3
4
5
6
7
8
9
10
11

# MCP 常用环境变量

环境变量	作用
`MCP_TIMEOUT`	MCP 服务器启动超时（毫秒），如 `MCP_TIMEOUT=10000 claude`
`MCP_TOOL_TIMEOUT`	工具执行超时（毫秒）
`MAX_MCP_OUTPUT_TOKENS`	MCP 工具输出令牌限制，默认 25000，如 `MAX_MCP_OUTPUT_TOKENS=50000`
`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`	空闲超时（毫秒），设为 `0` 禁用

# MCP 与 Skills 的区别

功能	Skills	MCP
本质	可复用的专业能力包（知识/流程）	外部工具/数据源连接器
触发方式	按需自动加载	始终可用（连接后）
安装方式	`npx skills add`	`claude mcp add`
典型场景	代码审查、UI 设计、开发流程	JIRA、GitHub、数据库、Figma
上下文占用	按需加载，几乎不占用	工具列表占用，调用时占用

# 会话管理

官方文档：管理会话 - Claude Code Docs (opens new window)

简单理解：会话 = 与项目目录关联的已保存对话，可随时恢复、分支或切换。

Claude Code 在你工作时将会话本地存储，因此你可以从中断处恢复、分支以尝试不同的方法，或在任务之间切换。

# 恢复会话

在 CC-Switch 的会话列表上方，你可以输入关键词进行搜索。支持的搜索内容包括会话 ID、标题、摘要、项目目录或源文件路径。例如，想找回与"登录页面"相关的会话，直接搜 "login" 即可快速定位。

在 cc-switch 中，有会话管理功能

先进入到需要会话的项目目录（软件中可点击复制目录路径）
可点击复制恢复会话指令

例如：claude --resume xxxx

# 命令行恢复方式

命令	功能
`claude --continue`（或 `claude -c`）	恢复当前目录中最近的会话
`claude --resume`	打开会话选择器
`claude --resume <name>`	直接恢复命名的会话
`claude --resume <session-id>`	按 ID 恢复会话（可跨目录）
`claude --resume <transcript-path>`	恢复指定 `.jsonl` 文本记录文件中的对话
`claude --from-pr <number>`	打开会话选择器，筛选链接到该 PR 的会话
`/resume`	从活跃会话内切换到不同的对话

# 命名会话

为会话设置描述性名称，便于在会话选择器中查找和按名称恢复。

时间	如何设置名称
启动时	`claude -n auth-refactor`
在会话期间	`/rename auth-refactor`（名称也会显示在提示栏上）
从会话选择器	突出显示会话并按 `Ctrl+R`
在计划接受时	在 Plan Mode 中接受计划会从计划内容命名会话

命名后，使用 claude --resume <name> 或 /resume <name> 返回到它。

# 使用会话选择器

在会话内运行 /resume，或不带参数运行 claude --resume，打开交互式会话选择器。常用快捷键：

快捷键	操作
`↑` / `↓`	在会话之间导航
`→` / `←`	展开或折叠分组的会话
`Enter`	恢复突出显示的会话
`Space`	预览会话内容
`Ctrl+R`	重命名突出显示的会话
`/` 或可打印字符	进入搜索模式并过滤会话
`Ctrl+A`	显示此计算机上所有项目的会话
`Ctrl+W`	显示当前存储库所有 worktrees 的会话
`Ctrl+B`	过滤到当前 git 分支的会话
`Esc`	退出会话选择器或搜索模式

# 分支会话

分支创建迄今为止对话的副本并将你切换到其中，保持原始对话完整。用于尝试不同的方法而不会丢失原路径。

# 在会话内分支
/branch try-streaming-approach

# 从命令行分支（继续最近会话并分叉）
claude --continue --fork-session

1
2
3
4
5

/branch 确认会打印两个会话 ID：新分支和原始分支。原始分支在磁盘上保持不变，可通过 /resume <original-name> 返回。

# 管理会话内的上下文

命令	作用
`/clear`	以空上下文重新开始（之前的对话可通过 `/resume` 恢复）
`/compact [instructions]`	用摘要替换历史记录，可选专注于指定内容
`/context`	显示当前消耗的上下文

# 导出和定位会话数据

# 导出当前对话到剪贴板或文件
/export
/export conversation.txt

1
2
3

会话文本记录默认存储为 JSONL，位置：~/.claude/projects/<project>/<session-id>.jsonl，其中 <project> 是工作目录路径（非字母数字字符替换为 -）。

# 从脚本访问对话

# 向现有会话发送后续提示并捕获结构化响应
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

1
2

# 常见问题

# Skill 安装成功但 Claude 不自动调用？

可能原因：

Skill 未关联 Claude Code
当前 Claude 会话未重新启动
Prompt 未命中 Skill 的 description
安装的是项目级 Skill，而不是全局 Skill

可以先检查：

npx skills list -g

确认输出包含：

Agents: Claude Code

如果没有，可执行：

npx skills link <skill-name> --agent "Claude Code"

然后重新启动 Claude Code。

# 学习参考

上次更新: 2026/9/29 14:06:54

← JMeter使用小记 Qoder Cli操作教程→