企业官网建设流程全解析

生成日期：2026-07-01
用途：更换电脑时迁移 Claude Code 配置

目录

• 配置文件总览
• 核心配置文件详解
• 功能模块说明
• 迁移步骤
• 备份目录结构

配置文件总览

Claude Code 的配置存储在~/.claude/目录下，主要包含以下类型的文件：

核心配置文件详解

1.CLAUDE.md— 全局指令文件

路径:~/.claude/CLAUDE.md

作用: 这是 Claude Code 最重要的配置文件，定义了 Claude 的行为准则。每次会话启动时自动加载。

当前配置内容:

• RTK (Rust Token Killer): CLI 输出过滤工具，所有 shell 命令默认加rtk前缀，节省 60-90% token
• 共享知识库: SQLite + FTS5 全文搜索，路径D:/tools/shared-knowledge/knowledge.db
  • py kb.py remember "内容"— 存储
  • py kb.py recall "关键词"— 搜索
  • py kb.py list— 列出
  • py kb.py forget <id>— 删除
  • py kb.py stats— 统计

迁移注意: 需要修改知识库路径和 RTK 路径

2.settings.json— 主配置文件

路径:~/.claude/settings.json

作用: Claude Code 的核心配置，包含环境变量、MCP 服务器、插件启用状态、Hooks 定义。

结构说明:

{"env":{// 环境变量 — API 代理配置"ANTHROPIC_BASE_URL":"http://127.0.0.1:8788",// 本地代理地址"ANTHROPIC_AUTH_TOKEN":"sk-xxx",// API 认证令牌"ANTHROPIC_DEFAULT_OPUS_MODEL":"mimo-v2.5-pro",// 默认 Opus 模型"ANTHROPIC_MODEL":"mimo-v2.5-pro",// 默认模型"ANTHROPIC_TARGET_API_URL":"https://api.xiaomimimo.com/anthropic"// 目标 API},"enabledPlugins":{// 已启用的插件"ecc@ecc":true,// ECC 插件"last30days@last30days-skill":true,// last30days 技能"fund-weekly-review@fund-weekly-review":true,// 基金复盘"agent-skills@addy-agent-skills":true// Agent 技能集},"mcpServers":{// MCP 服务器定义"headroom":{"command":"D:\\tools\\headroom-venv\\Scripts\\headroom.exe","args":["mcp","serve","--proxy-url","http://127.0.0.1:8788"],"cwd":"D:\\tools","env":{"HEADROOM_DATA_DIR":"D:\\tools\\headroom-data"}}},"hooks":{// 自动化 Hooks"PreToolUse":[...],// 工具调用前"SessionStart":[...]// 会话启动时}}

迁移注意:

• API 密钥需要更换
• MCP 服务器路径需要修改
• 插件可能需要重新安装

3.settings.local.json— 本地配置文件

路径:~/.claude/settings.local.json

作用: 本地覆盖配置，主要用于权限白名单。优先级高于settings.json。

核心内容:

{"env":{"ANTHROPIC_BASE_URL":"https://api.xiaomimimo.com/anthropic","ANTHROPIC_API_KEY":"sk-xxx","ANTHROPIC_MODEL":"mimo-v2.5-pro","ENABLE_TOOL_SEARCH":"true"},"permissions":{"allow":["Bash(git *)",// 允许所有 git 命令"Bash(node *)",// 允许所有 node 命令"Bash(python *)",// 允许所有 python 命令"Bash(py *)",// 允许所有 py 命令"Bash(curl *)",// 允许所有 curl 命令"WebFetch(domain:github.com)",// 允许访问 GitHub// ... 更多权限规则]}}

权限规则格式:

• Bash(命令前缀 *)— 允许匹配的 Bash 命令
• Read(路径)— 允许读取指定路径
• WebFetch(domain:域名)— 允许访问指定域名
• WebSearch— 允许网络搜索
• mcp__服务器名__工具名— 允许 MCP 工具

迁移注意: 权限规则可根据新电脑环境调整

4..mcp.json— MCP 服务器配置

路径:~/.claude/.mcp.json

作用: 定义全局 MCP 服务器（独立于 settings.json 中的 MCP 配置）。

当前配置:

{"mcpServers":{"codebase-memory-mcp":{"command":"D:/Programs/codebase-memory-mcp/codebase-memory-mcp.exe"}}}

迁移注意: 需要修改可执行文件路径

5.rules/common/*.md— 规则文件

路径:~/.claude/rules/common/

作用: 定义 Claude 在代码审查、编码风格、安全检查等方面的行为准则。

文件列表:

迁移注意: 这些是通用规则，通常不需要修改

6.hooks/*— Hook 脚本

路径:~/.claude/hooks/

作用: 在特定时机自动执行的脚本。

触发场景:startup（首次启动）、clear（清屏）、compact（压缩上下文）

迁移注意: 脚本内容通常不需要修改

7.plugins/— 插件目录

路径:~/.claude/plugins/

作用: 存储已安装的插件和 marketplace 配置。

目录结构:

plugins/ ├── installed_plugins.json# 已安装插件列表├── known_marketplaces.json# 已知 marketplace├── fund-weekly-review/# 基金复盘插件│ ├── manifest.json# 插件清单│ └── skill.md# 技能定义├── data/# 插件数据│ ├── agent-skills-addy-agent-skills/ │ ├── ecc-ecc/ │ └── last30days-last30days-skill/ ├── repos/# 插件仓库│ └── agent-skills/ ├── cache/# 插件缓存└── marketplaces/# marketplace 定义└── ECC/

已启用插件:

迁移注意: 插件可能需要重新安装，但配置可以保留

8.skills/— 技能目录

路径:~/.claude/skills/

作用: 存储可调用的技能（通过/skill-name触发）。

技能列表:

迁移注意: 符号链接需要重新创建，指向~/.agents/skills/

9.scheduled_tasks.json— 定时任务

路径:~/.claude/scheduled_tasks.json

作用: 定义定时执行的任务。

当前任务:

迁移注意: 任务依赖 agent-reach 和雪球数据源

10.projects/C--/memory/— 项目记忆

路径:~/.claude/projects/C--/memory/

作用: 跨会话的持久化记忆，以 Markdown 文件存储。

当前记忆:

迁移注意: 直接复制即可

功能模块说明

1. RTK (Rust Token Killer)

功能: CLI 输出过滤工具，减少 60-90% token 消耗

工作原理: 所有 shell 命令默认加rtk前缀，RTK 会智能过滤命令输出，只保留关键信息。

支持的命令:

• rtk cargo build/test/clippy— Rust 构建
• rtk vitest run— 测试
• rtk git *— Git 操作
• rtk gh *— GitHub CLI
• rtk pnpm *— 包管理
• rtk ls/read/grep/find— 文件操作

依赖:~/.headroom/bin/rtk.exe

2. MCP 服务器

功能: Model Context Protocol 服务器，扩展 Claude 的能力

当前服务器:

3. 共享知识库

功能: 与 Hermes Agent 共用的 SQLite + FTS5 知识库

路径:D:/tools/shared-knowledge/knowledge.db

操作:

py D:/tools/shared-knowledge/kb.py remember"内容"# 存储py D:/tools/shared-knowledge/kb.py recall"关键词"# 搜索py D:/tools/shared-knowledge/kb.py list# 列出py D:/tools/shared-knowledge/kb.py forget<id># 删除py D:/tools/shared-knowledge/kb.py stats# 统计

4. Agent 系统

功能: 11 个专业 Agent，支持并行执行

5. Hook 系统

功能: 在特定时机自动执行脚本

Hook 类型:

• PreToolUse: 工具调用前（验证、参数修改）
• PostToolUse: 工具调用后（自动格式化、检查）
• Stop: 会话结束时（最终验证）
• SessionStart: 会话启动时（初始化）

6. 插件系统

功能: 扩展 Claude Code 的能力

已启用插件:

• ECC: Chrome DevTools 集成，可控制浏览器
• last30days: 30 天数据统计
• fund-weekly-review: 基金每周复盘
• agent-skills: Agent 技能集

7. 定时任务

功能: 定时执行 Claude 任务

当前任务: 每周一 10:03 执行股票行情分析，使用 agent-reach 从雪球获取数据

迁移步骤

步骤 1：备份（已完成）

所有配置文件已备份到E:\claude-config-backup\

步骤 2：在新电脑上安装 Claude Code

# 安装 Claude Codenpminstall-g@anthropic-ai/claude-code

步骤 3：复制配置文件

# 复制核心配置cpE:/claude-config-backup/core/CLAUDE.md ~/.claude/cpE:/claude-config-backup/core/settings.json ~/.claude/cpE:/claude-config-backup/core/settings.local.json ~/.claude/cpE:/claude-config-backup/core/.mcp.json ~/.claude/cpE:/claude-config-backup/core/scheduled_tasks.json ~/.claude/# 复制规则cp-rE:/claude-config-backup/rules/* ~/.claude/rules/common/# 复制 hookscp-rE:/claude-config-backup/hooks/* ~/.claude/hooks/# 复制插件配置cpE:/claude-config-backup/plugins/installed_plugins.json ~/.claude/plugins/cpE:/claude-config-backup/plugins/known_marketplaces.json ~/.claude/plugins/cp-rE:/claude-config-backup/plugins/fund-weekly-review ~/.claude/plugins/# 复制技能cp-rE:/claude-config-backup/skills/* ~/.claude/skills/# 复制记忆mkdir-p~/.claude/projects/C--/memory/cp-rE:/claude-config-backup/projects-memory/* ~/.claude/projects/C--/memory/# 复制 agent skillsmkdir-p~/.agents/skills/cp-rE:/claude-config-backup/agents/* ~/.agents/skills/

步骤 4：修改路径配置

需要修改以下文件中的路径：

1. CLAUDE.md— 修改知识库路径和 RTK 路径
2. settings.json— 修改 MCP 服务器路径
3. .mcp.json— 修改 codebase-memory-mcp 路径
4. settings.local.json— 更新 API 密钥（如果更换）

步骤 5：安装依赖

# 安装 RTK# 从 https://github.com/... 下载 rtk.exe 到 ~/.headroom/bin/# 安装 headroompipinstallheadroom# 或使用 venvpython-mvenv D:/tools/headroom-venv D:/tools/headroom-venv/Scripts/pipinstallheadroom# 安装 codebase-memory-mcp# 从 GitHub 下载可执行文件# 安装 agent-reachpipinstallagent-reach# 安装共享知识库# 复制 D:/tools/shared-knowledge/ 目录

步骤 6：重新安装插件

# 在 Claude Code 中重新启用插件claude plugininstallecc claude plugininstalllast30days-skill claude plugininstallfund-weekly-review claude plugininstallagent-skills

步骤 7：验证配置

# 启动 Claude Codeclaude# 测试 RTKrtkgitstatus# 测试知识库py D:/tools/shared-knowledge/kb.py stats# 测试 MCP# 在 Claude Code 中执行 MCP 工具调用

备份目录结构

E:\claude-config-backup\├── Claude-Config-Guide.md# 本文档├── core/# 核心配置文件│ ├── CLAUDE.md# 全局指令│ ├── settings.json# 主配置│ ├── settings.local.json# 本地配置│ ├── .mcp.json# MCP 配置│ └── scheduled_tasks.json# 定时任务├── rules/# 规则文件 (10 个)│ ├── agents.md │ ├── code-review.md │ ├── coding-style.md │ ├── development-workflow.md │ ├── git-workflow.md │ ├── hooks.md │ ├── patterns.md │ ├── performance.md │ ├── security.md │ └── testing.md ├── hooks/# Hook 脚本 (3 个)│ ├── cbm-code-discovery-gate │ ├── cbm-session-reminder │ └── kb-session-recall ├── plugins/# 插件配置│ ├── installed_plugins.json │ ├── known_marketplaces.json │ └── fund-weekly-review/ ├── skills/# 技能文件 (8 个)│ ├── agent-reach/ │ ├── codebase-memory/ │ ├── learned/ │ ├── project-docs-scaffold/ │ ├── developer/ │ ├── git-essentials/ │ ├── using-coze-cli/ │ └── fund-weekly-review.md ├── agents/# Agent 技能 (4 个)│ ├── agent-reach/ │ ├── developer/ │ ├── git-essentials/ │ └── using-coze-cli/ └── projects-memory/# 项目记忆 (5 个)├── MEMORY.md ├── vs-code-preference.md ├── fund-weekly-review.md ├── tool-stack.md └── rtk-token-saver.md

常见问题

Q: 迁移后插件不生效？

A: 插件需要重新安装，配置文件只是记录了启用状态。运行claude plugin install <name>重新安装。

Q: MCP 服务器连接失败？

A: 检查settings.json和.mcp.json中的路径是否正确，确保可执行文件存在。

Q: RTK 命令不工作？

A: 确保~/.headroom/bin/rtk.exe存在，或修改CLAUDE.md中的 RTK 路径。

Q: 知识库为空？

A: 知识库是 SQLite 文件，需要单独复制D:/tools/shared-knowledge/knowledge.db。

Q: 定时任务不执行？

A: 检查scheduled_tasks.json中的 cron 表达式，确保 Claude Code 守护进程正在运行。

更新记录

提示: 定期备份配置文件，特别是在修改重要配置后。