Claude Code 常用技巧 - 智谱AI开放文档

一、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 使用示例

地图查询示例
天气查询示例
网络搜索示例

安装高德地图工具后，您可以直接询问：

“帮我查找北京市的天气”
“显示从北京到上海的路线”
“附近有什么餐厅？”

三、常见问题与故障排除

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 最佳实践建议

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

6.2 相关资源

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

*更多教程与案例

更多 GLM 编程的 #入门指南、#实战教程与 #创新应用案例，请访问 GLM Coding 开发者社区

GLM Coding Plan

接入指南

学习资源

特别权益

"拼好模"活动

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

​1.1 基础快捷命令

​1.2 自动模式配置

​设置自动执行权限

​1.3 高级操作技巧

​权限模式切换

​计划模式启动

​快捷键

​1.4 全局记忆设置

​设置中文环境

​项目初始化

​设置项目特定规则

​二、MCP 工具配置与使用

​2.1 MCP 工具概述

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

​2.3 MCP 工具管理命令

​查看已安装工具

​删除工具

​作用域管理

​2.4 MCP 配置文件

​2.5 使用示例

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

​3.1 安装相关问题

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

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

​问题3: 网络连接问题

​3.2 配置相关问题

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

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

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

​3.3 使用相关问题

​问题1: 命令无响应

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

​问题3: 内存不足问题

​3.4 升级与维护

​升级 Claude Code

​清理缓存

​四、高级使用技巧

​4.1 项目工作流

​1. 新项目初始化

​2. 团队协作配置

​4.2 性能优化

​1. 减少上下文大小

​2. 批量操作

​4.3 自动化集成

​1. Git 钩子集成

​2. CI/CD 集成

​五、卸载 Claude Code

​5.1 完全卸载步骤

​1. 卸载 Claude Code

​2. 清理配置文件

​3. 手动清理残留文件

​5.2 验证卸载

​六、总结与建议

​6.1 最佳实践建议

​6.2 相关资源

​*更多教程与案例

一、Claude Code 快捷命令与配置

1.1 基础快捷命令

1.2 自动模式配置

设置自动执行权限

1.3 高级操作技巧

权限模式切换

计划模式启动

快捷键

1.4 全局记忆设置

设置中文环境

项目初始化

设置项目特定规则

二、MCP 工具配置与使用

2.1 MCP 工具概述

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

2.3 MCP 工具管理命令

查看已安装工具

删除工具

作用域管理

2.4 MCP 配置文件

2.5 使用示例

三、常见问题与故障排除

3.1 安装相关问题

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

问题2: Node.js 版本过低

问题3: 网络连接问题

3.2 配置相关问题

问题1: .bashrc 文件不生效

问题2: 权限配置不生效

问题3: MCP 工具安装失败

3.3 使用相关问题

问题1: 命令无响应

问题2: MCP 工具无法使用

问题3: 内存不足问题

3.4 升级与维护

升级 Claude Code

清理缓存

四、高级使用技巧

4.1 项目工作流

1. 新项目初始化

2. 团队协作配置

4.2 性能优化

1. 减少上下文大小

2. 批量操作

4.3 自动化集成

1. Git 钩子集成

2. CI/CD 集成

五、卸载 Claude Code

5.1 完全卸载步骤

1. 卸载 Claude Code

2. 清理配置文件

3. 手动清理残留文件

5.2 验证卸载

六、总结与建议

6.1 最佳实践建议

6.2 相关资源

*更多教程与案例