AI导哈

Claude Code CLI增强工具包

为Claude Code CLI提供的综合设置指南和工具包，包含配置修复、自定义MCP、技能、代理和命令，以增强Claude Code的使用体验。

  • by ajjucoder
  • Shell
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 ajjucoder/claude-code-guide

使用说明

克劳德代码指南

Claude Code CLI的全面设置指南和工具包。包括配置修复、自定义MCP、技能、代理和命令，以增强您的Claude Code体验。

快速安装

curl -sSL https://raw.githubusercontent.com/ajjucoder/claude-code-guide/main/install.sh | bash

包含什么

目录 目录
config/ 配置修复和模板（压缩修复、设置、CLAUDE.md模板）
mcps/ 定制MCP服务器以增强功能
skills/ 专门任务的定制技能
agents/ 自定义代理角色
commands/ 自定义斜线命令

特色MCP

文档加载器MCP

直接在Claude Code中阅读PDF、Word、Excel、PowerPoint和图像文件。

# Install
npm install -g @anthropic/mcp-document-loader

# Usage
mcp-cli call document-loader-mcp/read_document '{"file_path": "/path/to/file.pdf", "file_type": "pdf"}'

全部文件→

Exa MCP

基于人工智能的网络搜索和代码上下文搜索。

# Install
npm install -g @anthropic/mcp-exa

# Usage
mcp-cli call exa/web_search_exa '{"query": "Next.js 15 best practices"}'

全部文件→

MCP第一配置

让Claude Code自动使用您的MCP而不是内置工具。

步骤1：安装MCP

# Document Loader
npm install -g @anthropic/mcp-document-loader

# Exa (requires API key from exa.ai)
npm install -g @anthropic/mcp-exa

步骤2：配置settings.json

复制设置模板：

cp config/settings.json ~/.claude/settings.json

或手动添加到您的 ~/.claude/settings.json:

{
  "mcpServers": {
    "document-loader-mcp": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-document-loader"],
      "env": {}
    },
    "exa": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-exa"],
      "env": {
        "EXA_API_KEY": "your-exa-api-key-here"
      }
    }
  }
}

步骤3：配置CLAUDE.md

复制CLAUDE.md模板，使CLAUDE自动使用MCP：

cp config/CLAUDE.md.template ~/.claude/CLAUDE.md

此模板包括：

  • MCP第一政策：Claude将使用文档加载器mcp来处理文档，例如用于网络搜索
  • 自动检测规则：无需告诉克劳德“使用MCP”-它会自动执行
  • 压实固定：在自动压缩过程中保留重要上下文
  • 编码首选项：TypeScript默认值，无注释等。

步骤4：验证安装

# List MCPs
mcp-cli servers

# Expected output:
# document-loader-mcp
# exa

# Test document reading
mcp-cli call document-loader-mcp/read_document '{"file_path": "/path/to/test.pdf", "file_type": "pdf"}'

# Test web search
mcp-cli call exa/web_search_exa '{"query": "test query"}'

特性

压实固定

修复了Claude Code过于激进地自动压缩对话，丢失重要上下文的问题。

了解更多→

自定义MCP

扩展Claude Code功能的MCP服务器。

MCP 描述 文档
文档加载器mcp 读取PDF、Word、Excel、PowerPoint、图像 文档
exa-mcp 基于人工智能的网络和代码搜索 文档

浏览所有MCP→

定制技能

通用工作流程的专业技能。

浏览技能→

自定义代理

不同任务的代理角色。

浏览代理→

自定义命令

快速执行命令。

浏览命令→

手动安装

1.仅压实固定

# Append compaction instructions to your CLAUDE.md
cat config/compaction-fix.md >> ~/.claude/CLAUDE.md

2.完整设置

# Clone the repo
git clone https://github.com/ajjucoder/claude-code-guide.git
cd claude-code-guide

# Run installer
./install.sh

3.单个组件

# Install specific MCP
cp -r mcps/your-mcp ~/.claude/mcps/

# Install specific skill
cp -r skills/your-skill ~/.claude/commands/

# Install specific agent
cp agents/your-agent.md ~/.claude/commands/

对于新机器

在新机器上设置Claude Code时：

# 1. Clone this repo
git clone https://github.com/ajjucoder/claude-code-guide.git
cd claude-code-guide

# 2. Run the installer
./install.sh

# 3. Add your API keys
# Edit ~/.claude/settings.json and add your Exa API key

# 4. Verify
mcp-cli servers
mcp-cli tools

配置文件

文件 位置 目的
settings.json ~/.claude/settings.json MCP服务器配置
CLAUDE.md ~/.claude/CLAUDE.md 克劳德全球指南
项目 CLAUDE.md ./CLAUDE.md 项目具体说明

故障排除

MCP未显示

# Check if MCPs are configured
cat ~/.claude/settings.json

# Reinstall MCPs
npm install -g @anthropic/mcp-document-loader @anthropic/mcp-exa

# Restart Claude Code

“权限被拒绝”错误

# Fix permissions
chmod +x install.sh

API密钥错误（Exa）

  1. 从以下位置获取密钥 例如ai
  2. 添加到 ~/.claude/settings.json:
    "env": {
  "EXA_API_KEY": "your-actual-key"
}

贡献

找到有用的东西了吗？添加它！

  1. 分叉此回购
  2. 添加您的MCP/技能/代理/命令
  3. 更新相关README
  4. 打开PR

许可证

MIT-自由使用，根据需要进行修改。

相关 MCP