AI导哈

代码配置管理工具

一个用于管理和同步Claude Code配置及加密密钥的工具，支持多机器设置和多代理集成。

  • by IrfanThomson
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 IrfanThomson/claude-code-settings

使用说明

Claude代码全局设置

此存储库包含我的Claude Code全局配置文件 安全秘密管理.

🔐 秘密管理

此仓库包含一个加密的机密管理系统，可让您安全地将配置传输到新机器。

快速入门：新机器设置

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

# 2. Get your encrypted secrets file
# (transfer secrets.env.enc from old machine or password manager)

# 3. Run automated setup
./setup.sh

就是这样！安装脚本将：

  • 解密你的秘密
  • 将它们应用于Claude代码配置
  • 复制所有设置文件
  • 设置您的多代理环境

📁 文件

配置文件

  • .claude.json -主配置（已净化-敏感数据已删除）
  • settings.json -全局设置
  • settings.local.json -本地覆盖
  • obsidian-mcp-config.json -黑曜石MCP服务器配置
  • CLAUDE.md -全球克劳德指令
  • plugins/ -插件配置

机密管理脚本

  • secrets.env.template -显示需要哪些秘密的模板
  • encrypt-secrets.sh -用密码加密您的秘密
  • decrypt-secrets.sh -解密机密以供使用
  • restore-secrets.py -将解密的机密应用于配置文件
  • setup.sh -完成新机器的自动化设置
  • extract_secrets.py -从当前配置中提取机密

🚀 使用工作流

第一次：输出你的秘密

在您当前使用克劳德代码的机器上：

cd claude-code-settings

# Extract secrets from your current config
python3 extract_secrets.py > secrets.env

# Encrypt with a strong password
./encrypt-secrets.sh

# This creates: secrets.env.enc (encrypted, safe to transfer)

转移 secrets.env.enc 致：

  • 密码管理器（1Password、Bitwarden等）
  • 私有云存储
  • U盘
  • 私有git仓库

新机器：导入您的秘密

# Clone repo
git clone https://github.com/IrfanThomson/claude-code-settings
cd claude-code-settings

# Get your encrypted secrets
# (download from password manager, cloud, etc.)

# Run automated setup
./setup.sh

# Or manual steps:
./decrypt-secrets.sh                # Decrypt secrets
python3 restore-secrets.py          # Apply to configs
cp settings.json ~/.claude/         # Copy settings
rm secrets.env                      # Secure cleanup

更新机密

添加新的MCP服务器或更新API密钥时：

cd claude-code-settings

# Re-extract secrets from current config
python3 extract_secrets.py > secrets.env

# Re-encrypt
./encrypt-secrets.sh

# Update your backup (password manager, cloud, etc.)

🛡️ 安全最佳实践

✅ 安全文件（可以提交到仓库）

  • .claude.json -山宁泰（所有秘密 REDACTED)
  • secrets.env.template -只是占位符
  • 全部 .sh 和 .py 脚本
  • settings.json 文件（无秘密）

❌ 敏感文件（切勿提交）

  • secrets.env -纯文本机密
  • secrets.env.dec -解密的秘密
  • *.backup -使用机密配置备份

⚠️ 可选：加密文件

您可以选择提交 secrets.env.enc 到一个 私人回购 因为它是密码加密的。但对于公共回购，请将其分开。

🤖 多代理设置

此配置包括：

代理 型号 类型 用途
克劳德代码 Sonnet 4.5 同步 交互式编码，git工作流
朱尔斯MCP Gemini 3思考 异步 后台任务，重构
黑曜石MCP - 整合 记笔记和知识管理
Atlassian MCP - 集成 Jira/Confluence集成

使用多个代理

# Delegate async work to Jules
"Use Jules to refactor the authentication module while I work on the UI"

# Take notes in Obsidian
"Create an Obsidian note about this implementation"

# Create Jira tickets
"Create a Jira ticket for this bug"

📝 手动设置（无脚本）

如果您更喜欢手动设置：

1.备份当前设置

cp ~/.claude.json ~/.claude.json.backup

2.还原配置文件

# Main config (will need secrets added)
cp .claude.json ~/.claude.json

# Settings
cp settings.json ~/.claude/settings.json
cp settings.local.json ~/.claude/settings.local.json
cp CLAUDE.md ~/.claude/CLAUDE.md

# Plugins
mkdir -p ~/.claude/plugins
cp plugins/*.json ~/.claude/plugins/

3.手动添加秘密

编辑 ~/.claude.json 并替换所有 REDACTED 值与您的实际值：

所需的秘密：

  • Jules API密钥：从https://jules.google.com

    • 地点： projects["/home/irfan"].mcpServers.jules.env.JULES_API_KEY

  • Jira/汇流 （如果使用Atlassian MCP）：

    • JIRA_URL, JIRA_USERNAME, JIRA_API_TOKEN
    • CONFLUENCE_URL, CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN
    • 地点： projects["/home/irfan"].mcpServers["mcp-atlassian"].env

  • OAuth帐户 （用于Claude Code身份验证）：

    • emailAddress, accountUuid, organizationUuid
    • 地点： oauthAccount.*

使用 secrets.env.template 作为所有所需秘密的参考。

🔄 跨机器同步设置

选项1:Git同步（带加密密钥）

# On Machine A (update settings)
cd claude-code-settings
python3 extract_secrets.py > secrets.env
./encrypt-secrets.sh
git add secrets.env.enc  # Only if private repo!
git add .claude.json settings.json plugins/*
git commit -m "Update settings"
git push

# On Machine B (pull updates)
cd claude-code-settings
git pull
./setup.sh

选项2：手动同步（最安全）

# Export from old machine
./encrypt-secrets.sh
# Transfer secrets.env.enc via secure channel

# Import on new machine
./decrypt-secrets.sh
python3 restore-secrets.py

🎯 已安装的MCP服务器

此配置包括：

  1. 朱尔斯MCP -异步编码代理

    • 安装位置： ~/.local/lib/mcp-servers/node_modules/@iflow-mcp/google-jules-mcp

  2. 黑曜石MCP -票据管理

    • 安装： uvx obsidian-mcp
    • 保险库：设置 OBSIDIAN_VAULT_PATH 在秘密中

  3. Atlassian MCP -Jira/汇流

    • 通过Docker运行
    • 需要Jira/Confluence API令牌

  4. Docker MCP网关 -Docker集成

    • 端口8081上的SSE连接

🆘 故障排除

“未找到secrets.env”

# Either decrypt existing secrets:
./decrypt-secrets.sh

# Or create from template:
cp secrets.env.template secrets.env
# Edit secrets.env with your values

解密时“密码错误”

  • 确保您使用的是加密中的相同密码
  • 检查 secrets.env.enc 传输过程中未损坏

“Jules没有出现在/mcp中”

  • 验证是否应用了机密： cat ~/.claude.json | grep JULES_API_KEY
  • 检查Jules MCP是否已安装： ls ~/.local/lib/mcp-servers/node_modules
  • 重新启动Claude代码

权限错误

chmod +x *.sh *.py

🔗 链接

🤝 贡献

这是一个个人配置仓库，但请随意分叉和调整以供自己使用！

要创建自己的版本，请执行以下操作：

  1. 分叉此回购
  2. 跑 python3 extract_secrets.py 在您的机器上
  3. 更新 .claude.json 使用经过净化的配置
  4. 定制 settings.json 根据您的喜好
  5. 创建您的 secrets.env.enc

生成于❤️ 使用克劳德代码

合著者：克劳德·十四行诗4.5 noreply@anthropic.com

相关 MCP