Skip to main content

一、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 工具配置

基础配置命令格式

# 通用添加命令格式
claude mcp add 工具名称 配置参数

2.3 其他实用 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.4 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.5 MCP 配置文件

MCP 工具的配置信息会保存在项目目录下的 .mcp.json 文件中,该文件会记录:
  • 已安装的工具列表
  • 工具配置参数
  • API 密钥和令牌
  • 作用域设置

2.6 使用示例

安装高德地图工具后,您可以直接询问:
  • “帮我查找北京市的天气”
  • “显示从北京到上海的路线”
  • “附近有什么餐厅?”

三、常见问题与故障排除

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 相关资源

名称描述
智谱AI开放平台智谱AI的官方开放平台,提供GLM模型的API服务和开发者工具
Z.ai Chat由GLM-4.5驱动的免费AI聊天机器人,支持文本生成、推理和深度研究
Zread AIGitHub仓库的AI代码维基,提供多语言指南、架构洞察和社区讨论
GLM-CC将GLM-4.5与Claude Code等Vibe Coding工具集成,提供一键安装脚本
Claude Code官方文档Anthropic官方的Claude Code智能编程工具文档
Claude Code最佳实践Anthropic官方的Claude Code代理编码最佳实践指南
Claude Code SDKAnthropic官方的Claude Code SDK调用,支持python和type
Node.js下载Node.js官方下载页面,提供免费、开源、跨平台的JavaScript运行时
Claude Code Router使用Claude Code作为编程基础设施基础,可自定义模型交互方式
OpcodeClaude 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 WorkflowClaude Code的自动化工作流,支持新功能的规范驱动开发和简化的错误修复流程
AgentsClaude Code的生产就绪子代理集合,包含83个专门的AI代理
OpenAI Agents.md指导编码代理的简单开放格式规范
Context Engineering关于上下文设计、编排和优化的前

*更多教程与案例

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