> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigmodel.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code 常用技巧

## 一、Claude Code 快捷命令与配置

### 1.1 基础快捷命令

| 命令                        | 用途          | 说明                   |
| ------------------------- | ----------- | -------------------- |
| `/bug`                    | 报告错误        | 将对话发送给 Anthropic 团队  |
| `/clear`                  | 清除对话历史      | 清空当前会话的所有记录          |
| `/compact [instructions]` | 压缩对话        | 可选择性压缩并聚焦特定说明        |
| `/config`                 | 查看/修改配置     | 管理 Claude Code 的设置   |
| `/cost`                   | 显示令牌使用统计    | 查看 API 调用成本和用量       |
| `/doctor`                 | 检查安装健康状况    | 诊断安装和配置问题            |
| `/help`                   | 获取使用帮助      | 显示所有可用命令             |
| `/init`                   | 初始化项目       | 使用 CLAUDE.md 指南初始化项目 |
| `/memory`                 | 编辑记忆文件      | 管理 CLAUDE.md 记忆文件    |
| `/pr_comments`            | 查看拉取请求评论    | 显示 PR 相关评论           |
| `/review`                 | 请求代码审查      | 对当前代码进行审查            |
| `/status`                 | 查看账户和系统状态   | 显示当前状态信息             |
| `/vim`                    | 进入 vim 模式   | 切换插入和命令模式            |
| `/resume`                 | 查看历史对话记录    | 恢复之前的会话              |
| `/mcp`                    | 查看 MCP 工具状态 | 显示已安装的 MCP 工具        |

### 1.2 自动模式配置

#### 设置自动执行权限

由于 Claude Code 默认在执行命令时需要用户确认，可以通过以下命令启用自动模式：

```
# 启用自动权限模式
claude --dangerously-skip-permissions
```

### 1.3 高级操作技巧

#### 权限模式切换

* **Shift+Tab**: 循环切换权限模式
* ⏵⏵ accept edits on - 自动接受模式
* ⏸ plan mode on - 计划模式

#### 计划模式启动

```
# 以计划模式启动新会话
claude --permission-mode plan
```

#### 快捷键

* **@文件名**: 精准引用分析文件
* **#** : 快速编辑 CLAUDE.md 文件
* **!** : 执行 bash 命令
* **+Enter**: 换行输入
* **Ctrl+L**: 清屏

### 1.4 全局记忆设置

#### 设置中文环境

```
# 使用 /memory 命令设置全局记忆
/memory

# 在打开的编辑器中设置以下内容：
与用户交流始终使用中文。
```

#### 项目初始化

```
# 使用 /init 命令初始化项目
/init
```

Claude Code 会自动分析项目结构并生成中文内容的 CLAUDE.md 文件，该文件会记录：

* 常用的 bash 命令
* 核心代码文件
* 实用函数
* 代码风格信息

一般用于已经存在的项目中，与 memory 一样都是编辑 CLAUDE.md 文件

#### 设置项目特定规则

使用 # 号开头直接添加规则，编写的命令 CLAUDE.md 的模板格式如下：

````
# 项目说明

## 项目概述
[在此处简要描述项目的主要功能和目标]

## 技术栈
- 编程语言：[如：Python, JavaScript, Java等]
- 框架：[如：React, Django, Spring等]
- 数据库：[如：MySQL, PostgreSQL, MongoDB等]
- 其他依赖：[如：Redis, Docker等]

## 开发环境设置
1. 安装依赖：
   ```bash
   [安装命令]
   ```

2. 配置环境变量：
   ```bash
   [环境变量配置]
   ```

3. 启动开发服务器：
   ```bash
   [启动命令]
   ```

## 项目结构
```
[项目目录结构]
```

## 重要配置文件
- `config/` - 配置文件目录
- `src/` - 源代码目录
- `tests/` - 测试文件目录
- `docs/` - 文档目录

## 开发规范
1. 代码风格：[如：ESLint, Prettier等]
2. 提交规范：[如：Conventional Commits]
3. 分支管理：[如：Git Flow]

## 常用命令
- 运行测试：`[测试命令]`
- 代码检查：`[lint命令]`
- 构建项目：`[构建命令]`
- 部署命令：`[部署命令]`

## 注意事项
- [重要的开发注意事项]
- [常见问题及解决方案]
- [性能优化建议]

## 联系方式
- 项目负责人：[姓名]
- 技术支持：[联系方式]
````

## 二、MCP 工具配置与使用

### 2.1 MCP 工具概述

MCP (Model Context Protocol) 工具是 Claude Code 的扩展功能，可以为其添加各种第三方服务的能力。Claude Code 自带基础联网搜索功能，但通过 MCP 工具可以实现深度搜索、地图服务、天气查询等高级功能。

### 2.2 其他实用 MCP 工具（除 GLM Coding Plan 覆盖的）

```
# EdgeOne Pages 网页部署工具
claude mcp add edgeone-pages -- npx edgeone-pages-mcp

# Context7 上下文管理工具
claude mcp add context7 -- npx -y @upstash/context7-mcp

# spec-driven 规范驱动工作流
claude mcp add spec-driven -- npx -y mcp-server-spec-driven-development@latest

# Figma 原型设计工具
claude mcp add Framelink -- npx -y figma-developer-mcp --figma-api-key=your_key --stdio
```

### 2.3 MCP 工具管理命令

#### 查看已安装工具

```
# 列出所有已安装的 MCP 工具
claude mcp list

# 查看 MCP 工具状态
/mcp
```

#### 删除工具

```
# 删除指定的 MCP 工具
claude mcp remove context7
claude mcp remove gaode-map
```

#### 作用域管理

```
# 项目级别安装 (仅当前项目可用)
claude mcp add 工具名 --scope project /path/to/project

# 用户级别安装 (所有项目可用)
claude mcp add 工具名 --scope user
```

### 2.4 MCP 配置文件

MCP 工具的配置信息会保存在项目目录下的 `.mcp.json` 文件中，该文件会记录：

* 已安装的工具列表
* 工具配置参数
* API 密钥和令牌
* 作用域设置

### 2.5 使用示例

<Tabs>
  <Tab title="地图查询示例">
    安装高德地图工具后，您可以直接询问：

    * "帮我查找北京市的天气"
    * "显示从北京到上海的路线"
    * "附近有什么餐厅？"
  </Tab>

  <Tab title="天气查询示例">
    安装墨迹天气工具后，您可以：

    * "查询今天的天气情况"
    * "明天会下雨吗？"
    * "未来一周的天气预报"
  </Tab>

  <Tab title="网络搜索示例">
    安装高级搜索工具后，您可以：

    * "搜索最新的科技新闻"
    * "查找某个技术文档"
    * "了解某个公司的背景信息"
  </Tab>
</Tabs>

## 三、常见问题与故障排除

### 3.1 安装相关问题

#### 问题1: npm 权限错误 (EACCES)

**现象**: `npm install -g @anthropic-ai/claude-code` 提示权限不足

**解决方案**:

```
# Linux/macOS
sudo npm install -g @anthropic-ai/claude-code

# 或者配置 npm 使用用户目录
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
```

#### 问题2: Node.js 版本过低

**现象**: 安装时提示 Node.js 版本不符合要求

**解决方案**:

```
# 使用 nvm 管理 Node.js 版本
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重启终端后安装最新 Node.js
nvm install node
nvm use node
```

#### 问题3: 网络连接问题

**现象**: 下载安装脚本失败或超时

**解决方案**:

```
# 设置 npm 镜像源
npm config set registry https://registry.npmmirror.com

# 使用代理 (如果需要)
npm config set proxy http://your-proxy:port
npm config set https-proxy http://your-proxy:port
```

### 3.2 配置相关问题

#### 问题1: .bashrc 文件不生效

**现象**: 配置的快捷命令无法使用

**解决方案**:

```
# 检查 .bashrc 是否存在
ls -la ~/.bashrc

# 如果不存在，创建它
echo 'alias claudecc="claude --dangerously-skip-permissions"' > ~/.bashrc

# 重新加载配置
source ~/.bashrc

# 或检查 .bash_profile 是否包含加载 .bashrc 的语句
echo 'if [ -f ~/.bashrc ]; then . ~/.bashrc; fi' >> ~/.bash_profile
```

#### 问题2: 权限配置不生效

**现象**: 自动模式仍然需要确认

**解决方案**:

```
# 确保使用正确的参数
claude --dangerously-skip-permissions

# 检查是否有其他配置覆盖
claude --config
```

#### 问题3: MCP 工具安装失败

**现象**: 添加 MCP 工具时报错

**解决方案**:

```
# 检查网络连接
ping open.bigmodel.cn

# 验证 API 密钥是否正确
# 替换为您的实际密钥
claude mcp add --transport http gaode-map https://open.bigmodel.cn/api/mcp-broker/proxy/gaode-map/mcp --header "Authorization: Bearer your-real-token"

# 查看详细错误信息
claude mcp list
```

### 3.3 使用相关问题

#### 问题1: 命令无响应

**现象**: 输入命令后程序卡住

**解决方案**:

```
# 强制退出当前会话
Ctrl+C

# 重启 Claude Code
claude

# 检查系统状态
claude --status
```

#### 问题2: MCP 工具无法使用

**现象**: 安装的 MCP 工具无法正常工作

**解决方案**:

```
# 检查工具状态
/mcp

# 重新安装工具
claude mcp remove tool-name
claude mcp add tool-name [parameters]

# 清理缓存
rm -rf ~/.claude/cache
```

#### 问题3: 内存不足问题

**现象**: 处理大文件时程序崩溃

**解决方案**:

```
# 增加内存限制 (如果支持)
export NODE_OPTIONS="--max-old-space-size=4096"

# 分批处理大文件
# 使用 @ 引用文件而不是直接粘贴
@large-file.txt
```

### 3.4 升级与维护

#### 升级 Claude Code

```
# 升级到最新版本
npm update -g @anthropic-ai/claude-code

# 检查当前版本
claude --version
```

#### 清理缓存

```
# 清理 Claude Code 缓存
rm -rf ~/.claude/cache

# 清理 npm 缓存
npm cache clean --force
```

## 四、高级使用技巧

### 4.1 项目工作流

#### 1. 新项目初始化

```
# 创建项目目录
mkdir my-project
cd my-project

# 初始化项目
/init

# 设置项目规则
# 在这个项目中使用 React + TypeScript
# 请遵循 Prettier 配置
# 所有 API 调用需要错误处理
```

#### 2. 团队协作配置

```
# 创建团队共享的 CLAUDE.md
# 团队编码规范
# 项目架构说明
# 常用命令和脚本

# 安装团队共享的 MCP 工具
claude mcp add shared-tool --scope project
```

### 4.2 性能优化

#### 1. 减少上下文大小

```
# 使用 /compact 压缩对话
/compact 保留核心功能

# 定期清除历史
/clear
```

#### 2. 批量操作

```
# 使用脚本批量处理
# 创建 process.sh
#!/bin/bash
for file in *.js; do
    claude --input="优化 $file" --file="$file"
done
```

### 4.3 自动化集成

#### 1. Git 钩子集成

```
# 在 .git/hooks/pre-commit 中添加
#!/bin/bash
claude --input="检查代码质量" --file="$@"
```

#### 2. CI/CD 集成

```
# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Setup Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run Review
        run: claude --review
```

## 五、卸载 Claude Code

### 5.1 完全卸载步骤

#### 1. 卸载 Claude Code

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

#### 2. 清理配置文件

**⚠️ 重要提示**: 大多数安装失败都是由于旧版本文件未完全清除导致的。必须彻底删除以下位置的残留文件：

**Windows 系统**:

```
# 删除主目录下的配置文件
rm -rf ~/.claude
rm -f ~/.claude*
rm -f ~/.bashrc*
```

**Linux/macOS 系统**:

```
# 删除所有 Claude 相关文件
rm -rf ~/.claude*
rm -rf ~/.claude

# 清理 npm 全局包
npm uninstall -g @anthropic-ai/claude-code
npm cache clean --force
```

#### 3. 手动清理残留文件

检查并删除以下位置的文件：

* `C:\Users\用户名.claude`
* `C:\Users\用户名.claude*`
* 项目目录中的 `.mcp.json`
* 项目目录中的 `CLAUDE.md`

### 5.2 验证卸载

```
# 检查是否还有残留
which claude
ls -la ~/.claude*

# 检查 npm 全局包
npm list -g --depth=0 | grep claude
```

## 六、总结与建议

### 6.1 最佳实践建议

1. **环境准备**: 确保使用最新稳定的 Node.js 版本
2. **权限管理**: 合理配置自动模式和权限级别
3. **工具配置**: 根据需要选择性安装 MCP 工具
4. **项目管理**: 为每个项目配置专属的 CLAUDE.md
5. **定期维护**: 定期升级和清理缓存

### 6.2 相关资源

| 名称                                                                                  | 描述                                                                |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [智谱开放平台](https://www.bigmodel.cn/)                                                  | 智谱AI的官方开放平台，提供 GLM 模型的 API 服务和开发者工具                               |
| [智谱 Chat](https://chat.z.ai/)                                                       | 由 GLM 模型驱动的免费AI聊天机器人，支持文本生成、推理和深度研究                               |
| [Zread AI](https://zread.ai/)                                                       | GitHub 仓库的 AI 代码维基，提供多语言指南、架构洞察和社区讨论                              |
| [GLM-CC](https://github.com/MetaGLM/glm-cc)                                         | 将 GLM 与 Claude Code 等 Vibe Coding 具集成，提供一键安装脚本                    |
| [Claude Code官方文档](https://docs.claude.com/zh-CN/docs/claude-code/overview)          | Anthropic 官方的 Claude Code 智能编程工具文档                                |
| [Claude Code最佳实践](https://www.anthropic.com/engineering/claude-code-best-practices) | Anthropic 官方的 Claude Code 代理编码最佳实践指南                              |
| [Claude Code SDK](https://github.com/anthropics/claude-code-sdk-python)             | Anthropic 官方的 Claude Code SDK 调用，支持 python 和 type                 |
| [Node.js下载](https://nodejs.org/en/download/)                                        | Node.js 官方下载页面，提供免费、开源、跨平台的 JavaScript 运行时                        |
| [Claude Code Router](https://github.com/musistudio/claude-code-router)              | 使用 Claude Code 作为编程基础设施基础，可自定义模型交互方式                              |
| [Opcode](https://github.com/getAsterisk/opcode)                                     | Claude Code 的强大 GUI 应用和工具包，支持创建自定义代理、管理交互会话等                      |
| [CCPM](https://github.com/automazeio/ccpm)                                          | 使用 GitHub Issues 和 Git worktrees 的 Claude Code 项目管理系统             |
| [CCPlugins](https://github.com/brennercruvinel/CCPlugins)                           | 实际节省时间的 Claude Code 框架，内置高级工程师生成提示                                |
| [Sniffly](https://github.com/chiphuyen/sniffly)                                     | 分析 Claude Code 日志的工具，提供使用统计、错误分析和可共享仪表板                           |
| [Claude Code Log](https://github.com/daaain/claude-code-log)                        | 将 Claude Code JSONL 转录转换为可读 HTML，支持 TUI 和交互式过滤                    |
| [Awesome Claude Code](https://github.com/hesreallyhim/awesome-claude-code)          | 精选的 Claude Code 命令、文件和工作流列表                                       |
| [Spec Kit](https://github.com/github/spec-kit)                                      | 帮助您开始规范驱动开发的工具包                                                   |
| [CC-SDD](https://github.com/gotalab/cc-sdd)                                         | 为 Claude Code、Cursor 和 Gemini CLI 安装 AI-DLC 与 SDD 工作流，提供 10 个斜杠命令 |
| [Claude Code Spec Workflow](https://github.com/Pimzino/claude-code-spec-workflow)   | Claude Code 的自动化工作流，支持新功能的规范驱动开发和简化的错误修复流程                        |
| [Agents](https://github.com/wshobson/agents)                                        | Claude Code 的生产就绪子代理集合，包含83 个专门的 AI 代理                            |
| [OpenAI Agents.md](https://github.com/openai/agents.md)                             | 指导编码代理的简单开放格式规范                                                   |
| [Context Engineering](https://github.com/davidkimai/Context-Engineering)            | 关于上下文设计、编排和优化的前                                                   |

## \*更多教程与案例

<Tip>
  更多 GLM 编程的 #入门指南、#实战教程 与 #创新应用案例，请访问 [GLM Coding 开发者社区](https://zhipu-ai.feishu.cn/wiki/TrlMwahsfihLrKkZsy0cpuTenCz)
</Tip>