# claude_config

**Repository Path**: liugdbot_mine/claude_config

## Basic Information

- **Project Name**: claude_config
- **Description**: claude code开发配置，跨平台使用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code 配置一键部署

一套开箱即用的 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 配置方案，通过符号链接将配置部署到 `~/.claude/`；支持跨平台部署；

部署后你将获得：

- 自动代码格式化（prettier / black / gofmt / rustfmt）
- 跨平台通知提示音
- 自定义 Agent（架构师、代码审查员）
- 工程师专业版输出样式
- 2 个插件市场（可选）

## 快速开始

### 前置条件

- [Git](https://git-scm.com/) 2.13+（支持 `--recurse-submodules`）
- [Node.js](https://nodejs.org/) 18+（settings.json 智能合并需要）
- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) 已安装
- bun（可选）

### 第 1 步：克隆仓库

```bash
# macOS / Linux / Windows Git Bash
git clone --recurse-submodules <仓库地址> ~/claude_config
cd ~/claude_config
```

> 如果克隆时忘记加 `--recurse-submodules`，后续执行 `git submodule update --init` 即可。不影响核心功能，插件市场会以占位目录形式存在。

### 第 2 步：配置 API

编辑 `src/settings.json.template`，将 `{{...}}` 占位符替换为你的实际配置：

| 占位符 | 说明 | 示例（智谱BigModel）|
|--------|------|---------------------|
| `{{ANTHROPIC_BASE_URL}}` | API 地址 | `https://open.bigmodel.cn/api/paas/v4` |
| `{{ANTHROPIC_AUTH_TOKEN}}` | API Token | 你的智谱 API Key（在 [open.bigmodel.cn](https://open.bigmodel.cn/) 获取） |
| `{{ANTHROPIC_MODEL}}` | 主模型 | `glm-5` |
| `{{ANTHROPIC_DEFAULT_HAIKU_MODEL}}` | 快速模型 | `glm-5` |
| `{{ANTHROPIC_DEFAULT_SONNET_MODEL}}` | 标准模型 | `glm-5` |
| `{{ANTHROPIC_DEFAULT_OPUS_MODEL}}` | 高级模型 | `glm-5.1` |
| `{{ANTHROPIC_REASONING_MODEL}}` | 推理模型 | `glm-5.1` |

> 部署脚本会智能合并模板与已有配置——更新时不会覆盖你已填写的值。

### 第 3 步：部署

**macOS / Linux：**

```bash
chmod +x deploy.sh && ./deploy.sh
```

**Windows（需管理员权限）：**

```powershell
# 右键 PowerShell → 以管理员身份运行
powershell -ExecutionPolicy Bypass -File deploy.ps1
```

部署完成后重启 Claude Code 即可生效。

## 包含的功能

| 功能 | 说明 | 额外依赖 |
|------|------|---------|
| 自动格式化 | Write/Edit 后自动调用 prettier/black/gofmt/rustfmt | 对应项目需安装格式化工具 |
| 通知提示音 | 需要用户确认时发出系统提示音 | 无 |
| 架构师 Agent | 系统设计、技术选型、重构方案 | 无 |
| 代码审查员 Agent | 代码质量、安全性、规范性审查 | 无 |
| 工程师专业版输出 | 遵循 SOLID/KISS/DRY/YAGNI 的专业回复样式 | 无 |
| 插件市场 | 官方插件、社区插件 | 见下方"插件市场"章节 |

## 配置说明

### settings.json 智能合并

部署脚本使用 `src/scripts/merge-settings.js` 处理 settings.json：

- **首次部署**：从模板生成，`{{...}}` 占位符保持原样
- **更新部署**：已替换的值（如 API Token）会被保留，不会被模板覆盖
- **新增配置项**：模板中的新字段会自动添加
- **用户自定义字段**：你手动添加的字段也会保留

### 环境变量

可通过 `CLAUDE_CONFIG_DIR` 自定义部署目标目录，默认为 `~/.claude`：

```bash
# macOS / Linux
CLAUDE_CONFIG_DIR=~/.claude_custom ./deploy.sh

# Windows
$env:CLAUDE_CONFIG_DIR = "$HOME\.claude_custom"
.\deploy.ps1
```

## 插件市场（可选）

项目通过 git submodule 引入了 2 个插件市场仓库：

| 市场 | 来源 | 说明 |
|------|------|------|
| claude-plugins-official | [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | Anthropic 官方插件 |
| everything-claude-code | [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) | 社区综合插件集 |

**初始化方法（已初始化可跳过）：**

```bash
git submodule update --init
```

初始化后重新运行部署脚本，占位目录会自动升级为符号链接。

> 未初始化时，部署脚本会创建占位目录，不影响核心功能使用。

## 文件结构

```
claude_config/
├── deploy.sh                  # macOS/Linux 部署脚本
├── deploy.ps1                 # Windows 部署脚本
├── src/                       # 配置源文件（符号链接到 ~/.claude/）
│   ├── settings.json.template # 主配置模板
│   ├── scripts/               # 部署工具脚本
│   ├── CLAUDE.md              # 全局 AI 指令
│   ├── agents/                # 自定义 Agent 定义
│   ├── hooks/                 # Hook 脚本（格式化、通知）
│   ├── output-styles/         # 输出样式
│   ├── statusline/            # 状态栏启动器
│   ├── skills/                # 自定义技能（预留）
│   └── plugins/               # 插件市场 + 市场配置
└── CLAUDE.md                  # 项目说明
```