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

目录

配置文件总览

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

类别 文件/目录 作用 重要性
全局指令 CLAUDE.md 定义 Claude 的行为规则、工具栈、工作流 ⭐⭐⭐
主配置 settings.json 环境变量、MCP 服务器、插件、Hooks ⭐⭐⭐
本地配置 settings.local.json 权限白名单、环境变量（本地覆盖） ⭐⭐⭐
MCP 配置 .mcp.json MCP 服务器定义 ⭐⭐⭐
规则文件 rules/common/*.md 编码风格、安全、测试、Git 等规则 ⭐⭐
Hooks hooks/* 会话启动、工具调用前后的自动化脚本 ⭐⭐
插件 plugins/ 已安装的插件和 marketplace ⭐⭐
技能 skills/ 可调用的技能（Skill） ⭐⭐
Agent agents/ 自定义 Agent 定义 ⭐⭐
记忆 projects/C--/memory/ 跨会话持久化记忆 ⭐
定时任务 scheduled_tasks.json 定时执行的任务 ⭐

核心配置文件详解

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 在代码审查、编码风格、安全检查等方面的行为准则。

文件列表:

文件 内容 关键规则
agents.md Agent 编排策略 11 个可用 Agent，支持并行执行
code-review.md 代码审查标准 4 级严重性：CRITICAL/HIGH/MEDIUM/LOW
coding-style.md 编码风格 不可变性、KISS、DRY、YAGNI
development-workflow.md 开发工作流 研究→规划→TDD→审查→提交
git-workflow.md Git 规范 Conventional Commits 格式
hooks.md Hook 系统 PreToolUse/PostToolUse/Stop
patterns.md 设计模式 Repository 模式、API 响应格式
performance.md 性能优化 模型选择策略、上下文管理
security.md 安全检查 提交前必须检查 8 项安全清单
testing.md 测试要求 最低 80% 覆盖率、TDD 工作流

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

6. hooks/* — Hook 脚本

路径: ~/.claude/hooks/

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

Hook 触发时机 作用
cbm-code-discovery-gate PreToolUse (Grep/Glob) 代码发现门控，优化搜索行为
cbm-session-reminder SessionStart 会话启动时显示提醒信息
kb-session-recall SessionStart 会话启动时加载知识库列表

触发场景: 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/

已启用插件:

插件 标识 用途
ECC ecc@ecc Chrome DevTools 集成
last30days last30days@last30days-skill 30 天数据统计
fund-weekly-review fund-weekly-review@fund-weekly-review 基金每周复盘
agent-skills agent-skills@addy-agent-skills Agent 技能集

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

8. skills/ — 技能目录

路径: ~/.claude/skills/

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

技能列表:

技能 类型 用途
agent-reach 目录 Agent 数据获取框架
codebase-memory 目录 代码库记忆管理
learned 目录 已学习的知识
project-docs-scaffold 目录 项目文档脚手架
developer 符号链接 开发者技能集
git-essentials 符号链接 Git 基础操作
using-coze-cli 符号链接 Coze CLI 使用指南
fund-weekly-review.md 文件 基金复盘技能

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

9. scheduled_tasks.json — 定时任务

路径: ~/.claude/scheduled_tasks.json

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

当前任务:

任务 Cron 用途
每周股票行情分析 3 10 * * 1 每周一 10:03 执行基金分析

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

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

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

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

当前记忆:

文件 内容
vs-code-preference.md 用户喜欢用 VS Code
fund-weekly-review.md 每周复盘基金
tool-stack.md Headroom、Agent-Reach、last30days-skill
rtk-token-saver.md RTK CLI 信息
MEMORY.md 记忆索引文件

迁移注意: 直接复制即可

功能模块说明

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 的能力

当前服务器:

服务器 功能 依赖
headroom RTK 代理，输出过滤 D:\tools\headroom-venv\
codebase-memory-mcp 代码库记忆 D:\Programs\codebase-memory-mcp\

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，支持并行执行

Agent 用途 触发时机
planner 实现规划 复杂功能请求
architect 系统设计 架构决策
tdd-guide 测试驱动开发 新功能、Bug 修复
code-reviewer 代码审查 代码修改后
security-reviewer 安全分析 安全敏感代码
build-error-resolver 修复构建错误 构建失败时
e2e-runner E2E 测试 关键用户流程
refactor-cleaner 死代码清理 代码维护
doc-updater 文档更新 更新文档
rust-reviewer Rust 代码审查 Rust 项目
harmonyos-app-resolver HarmonyOS 开发 HarmonyOS 项目

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 Code
npm install -g @anthropic-ai/claude-code

步骤 3：复制配置文件

# 复制核心配置
cp E:/claude-config-backup/core/CLAUDE.md ~/.claude/
cp E:/claude-config-backup/core/settings.json ~/.claude/
cp E:/claude-config-backup/core/settings.local.json ~/.claude/
cp E:/claude-config-backup/core/.mcp.json ~/.claude/
cp E:/claude-config-backup/core/scheduled_tasks.json ~/.claude/

# 复制规则
cp -r E:/claude-config-backup/rules/* ~/.claude/rules/common/

# 复制 hooks
cp -r E:/claude-config-backup/hooks/* ~/.claude/hooks/

# 复制插件配置
cp E:/claude-config-backup/plugins/installed_plugins.json ~/.claude/plugins/
cp E:/claude-config-backup/plugins/known_marketplaces.json ~/.claude/plugins/
cp -r E:/claude-config-backup/plugins/fund-weekly-review ~/.claude/plugins/

# 复制技能
cp -r E:/claude-config-backup/skills/* ~/.claude/skills/

# 复制记忆
mkdir -p ~/.claude/projects/C--/memory/
cp -r E:/claude-config-backup/projects-memory/* ~/.claude/projects/C--/memory/

# 复制 agent skills
mkdir -p ~/.agents/skills/
cp -r E:/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/

# 安装 headroom
pip install headroom
# 或使用 venv
python -m venv D:/tools/headroom-venv
D:/tools/headroom-venv/Scripts/pip install headroom

# 安装 codebase-memory-mcp
# 从 GitHub 下载可执行文件

# 安装 agent-reach
pip install agent-reach

# 安装共享知识库
# 复制 D:/tools/shared-knowledge/ 目录

步骤 6：重新安装插件

# 在 Claude Code 中重新启用插件
claude plugin install ecc
claude plugin install last30days-skill
claude plugin install fund-weekly-review
claude plugin install agent-skills

步骤 7：验证配置

# 启动 Claude Code
claude

# 测试 RTK
rtk git status

# 测试知识库
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 守护进程正在运行。

更新记录

日期 内容
2026-07-01 初始版本，完整备份所有配置

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

# 大数据 # 搜索引擎
Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

Codex、ChatGPT 和程序员效率提升：为什么 AI 编程不是简单“自动写代码”（plus pro充值）

提到 Codex 和 ChatGPT，很多程序员第一反应是：“是不是可以自动帮我写代码？这个理解不能说错，但太浅了。如果只是让 AI 写一个函数、写一段 SQL、写一个表单组件，那确实属于代码生成。但真正有价值的 AI 编程，不应该只停留在“生成代码片段”这个层面。因为真实开发不是写几个函数那么简单。理解需求；拆解功能；设计接口；设计数据库；判断技术方案；编写代码；处理异常；补充测试；排查报错；做

avatar DeepSeek技术社区
cover

AI Coding 如何减少 Token 消耗：8 种实测有效的省钱方法

avatar DeepSeek技术社区

CC Switch + Codex 配置教程：统一管理 GPT、Claude 与多模型 API

当你只使用一个模型时，手动配置 Codex 还算简单。但如果你同时使用 GPT、Claude、DeepSeek、通义千问等多个模型，手动维护 API Key、Base URL 和模型名称就会变得混乱。

avatar DeepSeek技术社区