AI能力集 -- Claude Code实战手记
Claude Code实战手记，持续更新实践和技巧
1. 引言
Claude Code实战手记，持续更新实践和技巧。
2. 安装和基本使用
基本安装和配置就不单独说了，基本步骤：通过npm安装（可设置一下国内镜像源） -> 配置API。具体步骤可见：Claude Code安装和使用。
执行claude即可执行：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
╭─── Claude Code v2.1.63 ──────────────────────────────────────────────────────────────────────────────────╮
│ │ Tips for getting started │
│ Welcome back! │ Run /init to create a CLAUDE.md file with instructions for Claude │
│ │ ───────────────────────────────────────────────────────────────── │
│ ▐▛███▜▌ │ Recent activity │
│ ▝▜█████▛▘ │ No recent activity │
│ ▘▘ ▝▝ │ │
│ │ │
│ qwen3.5-plus · API Usage Billing │ │
│ /home │ │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────╯
/model to try Opus 4.6
──────────────────────────────────────────────────────────────────────────────────────────
❯
3. 快捷键小技巧
可参考（经常翻翻）：Claude Code 常用技巧
3.1. 权限模式
跟Claude Code对话时，可以用Shift + Tab快捷键来循环切换权限模式：计划模式、自动接受模式。
也可以在配置文件.claude/settings.json里永久设置为默认，这里自动开启接受编辑模式：
1
2
3
"permissions": {
"defaultMode": "acceptEdits"
}
启用自动权限模式，则可：claude --dangerously-skip-permissions，为了方便可以在bashrc里设置一个别名：alias claudecc="claude --dangerously-skip-permissions"，但基于安全考虑，root用户下还是会提示是否接受。
精细控制权限：我不想每次人工来点击一次接受修改，所以权限进行了下述修改，并安装了开源社区的cc-safety-net插件：npm install -g cc-safety-net，然后在 .claude/settings.json 中启用。
- 内置数百种危险模式识别
- 会区分rm -rf /tmp/cache（允许）vs rm -rf /（阻止）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"permissions": {
"mode": "acceptEdits",
"allow": ["Bash(*)", "Edit(*)", "Write(*)"],
"deny": [
"Bash(rm -rf / *)",
"Bash(git push --force)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "npx -y cc-safety-net",
"timeoutSec": 15
}
]
}
]
}
}
3.2. 全局记忆设置
/memory设置记忆，可以选择全局级别还是当前项目级别。选择后会自动打开相应的CLAUDE.md文件，比如设置中文环境，增加：与用户交流始终使用中文。；也可以之间vim编辑相应CLAUDE.md文件。
3.3. 常见命令
/init：在项目根目录生成CLAUDE.md文件，用于定义项目级指令和上下文。- 会记录：常用的 bash 命令、核心代码文件、实用函数、代码风格信息
- 另外可以手动在
CLAUDE.md里面，用markdown语法增加项目特定规则，用不同级别的#增加相应小结进行规则说明
/status：查看当前模型、API Key、Base URL 等配置状态/clear：清除对话历史，开始全新对话/plan：进入规划模式，仅分析和讨论方案，不修改代码/compact：压缩对话历史，释放上下文窗口空间/config：打开配置菜单，可设置语言、主题等
4. MCP配置
MCP (Model Context Protocol) 工具是 Claude Code 的扩展功能，可以为其添加各种第三方服务的能力。Claude Code 自带基础联网搜索功能，但通过 MCP 工具可以实现深度搜索、地图服务、天气查询等高级功能。
Claude Code 支持通过 MCP 和 Skills 扩展自身能力，例如调用联网搜索获取实时信息、使用图片理解 Skill 分析图像内容等。
- MCP：安装成熟的 MCP Server，连接外部服务。例如：添加联网搜索MCP。
- Skills：编写详细的 Skill 描述文案。Claude 决定是否调用该工具，取决于对该工具用途的定义。例如：添加视觉理解能力Skill。
- Skills vs MCP：Skills 教会 Claude “怎么做”（工作流知识），MCP 给 Claude“做的工具”（外部接口）。两者互补，Skills 也可集成外部接口。
查看当前已安装的MCP工具：claude mcp list
4.1. 添加MCP示例
在MCP广场找到MCP（暂时用阿里百炼里的MCP），开通并添加： claude mcp add WebSearch https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp -t http -H "Authorization: Bearer sk-sp-xxxxxxxxxxxx(相应的API Key)"
1
2
3
4
5
6
[root@xdlinux ➜ tmpdir ]$ claude mcp add WebSearch https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp -t http -H "Authorization: Bearer sk-sp-1xxxxxxxxxxxxxxxxxxxx"
Added HTTP MCP server WebSearch with URL: https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp to local config
Headers: {
"Authorization": "Bearer sk-sp-1xxxxxxxxxxxxxxxxxxxxx"
}
File modified: /root/.claude.json [project: /home/workspace/tmpdir]
/root/.claude.json文件里，可以看到：
1
2
3
4
5
6
7
8
9
10
11
12
"/home/workspace/tmpdir": {
"allowedTools": [],
"mcpContextUris": [],
"mcpServers": {
"WebSearch": {
"type": "http",
"url": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
"headers": {
"Authorization": "Bearer sk-sp-1xxxxxxxxxxxxxxxxxxx"
}
}
},
删除MCP：claude mcp remove WebSearch
参考自：百炼 – 添加联网搜索MCP
4.2. 添加Skill示例
这里添加一份Skill，添加视觉理解能力（部分模型可能已经默认具备视觉能力了，如qwen3.5-plus，这里假设切换的模型不支持）。
1、在项目目录（按需看是否要全局目录）的.claude目录中，新建skills/image-analyzer目录，image-analyzer即Skill名
2、在该目录下创建SKILL.md文件，并写入下述内容
1
2
3
4
5
6
---
name: image-analyzer
description: 帮助没有视觉能力的模型进行图像理解。当需要分析图像内容、提取图片中的信息、文字、界面元素，或理解截图、图表、架构图等任何视觉内容时，使用此技能，传入图片路径即可获得描述信息。
model: qwen3.5-plus
---
qwen3.5-plus具有视觉理解能力，请直接使用qwen3.5-plus模型进行图片理解。
目录结构如下（我放在了全局里），claude重新进入，/skills即可看到：image-analyzer · ~26 description tokens
1
2
3
4
5
6
[root@xdlinux ➜ skills ]$ pwd
/root/.claude/skills
[root@xdlinux ➜ skills ]$ tree
.
└── image-analyzer
└── SKILL.md
删除Skills：直接删除相应文件，rm -rf /root/.claude/skills/<skill-name>
参考自：百炼 – 添加视觉理解能力
5. 提升效率思路
利用AI来提升学习和实践效率：
- 1、先用AI（
Claude Code或者DeepSeek等页面问答）生成提示词 - 2、将提示词喂给
Claude Code来生成学习资料
比如：
1、先问DeepSeek：我要分析学习claude code，本地linux安装了一份，包括各个目录信息，小技巧等，帮我生成一份提示词，用来生成供我学习的资料
生成的提示词：
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
## 角色设定
你是一位资深的Claude Code技术布道师，擅长用系统化、结构化的方式讲解复杂工具。你的讲解风格是：**由浅入深、目录清晰、重点突出、附带实操案例**。
## 背景信息
我已在本地Linux环境成功安装了Claude Code，安装目录和配置目录包括：
我希望全面学习Claude Code，从基础原理到高级技巧，真正掌握这个工具。
## 学习需求清单
请帮我生成一份详细的Claude Code学习资料，**按以下目录结构组织**，涵盖各个目录的作用、配置方法、实用技巧：
### 第一部分：Claude Code 核心原理与架构
1. **什么是Claude Code** - 与Copilot的本质区别（Agent vs 补丁工具）
2. **核心工作流程** - 感知(Observe)→思考(Think)→行动(Act)→验证(Verify)的闭环机制
3. **多Agent架构** - 主Agent如何领导Subagent处理复杂任务
...
### 第三部分：权限模式深度解析（重点）
...
### 第四部分：交互技巧与快捷键大全
...
### 第九部分：常见问题排查（Linux环境）
...
### 第十部分：学习路线图建议
...
## 输出要求
1. 内容准确、结构清晰，每个目录下用**粗体**标出关键知识点
2. 配置文件和命令示例用代码块展示
3. 适当使用表格对比（如权限模式对比、快捷键对比）
4. 融入我本地目录的实际路径作为参考
5. 篇幅适中，便于打印或保存为学习笔记
---
**请根据以上要求，生成一份完整的Claude Code学习资料，帮助我系统掌握这个终端AI编程助手。**
2、将上述提示词的markdown形式给Claude Code，让它生成资料
生成的仓库：ai-claude-code-guide
