{"_id":"@0x86/claude-config-manager","name":"@0x86/claude-config-manager","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@0x86/claude-config-manager","version":"1.0.0","description":"🔧 Claude Code 配置管理工具 - 支持多配置方案切换、自动备份、实时预览","type":"module","bin":{"claude-config":"dist/index.js"},"main":"./dist/index.js","scripts":{"start":"bun run index.ts","build":"bun build index.ts --compile --outfile claude-config","build:npm":"bun build index.ts --outdir ./dist --target node","prepublishOnly":"bun run build:npm","dev":"bun --watch index.ts","test":"bun test","typecheck":"tsc --noEmit"},"keywords":["claude","claude-code","config","configuration","cli","anthropic","openai","aliyun","model-switching","api-key-manager","developer-tools"],"author":{"name":"xyhuangjia","email":"xyhuangjia@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/xyhuangjia/claude-config-cli.git"},"bugs":{"url":"https://github.com/xyhuangjia/claude-config-cli/issues"},"homepage":"https://github.com/xyhuangjia/claude-config-cli#readme","engines":{"node":">=18"},"devDependencies":{"@types/bun":"latest","@types/node":"^20.0.0","typescript":"^5.0.0"},"peerDependencies":{"typescript":"^5.0.0"},"dependencies":{"@clack/prompts":"^1.1.0","picocolors":"^1.1.1"},"_id":"@0x86/claude-config-manager@1.0.0","gitHead":"101f82b373bd98cc9dc56852ac5561644c08969b","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-9ZadEvukeExyZZ7gn59blilCkjkPKbZ64xcpEcK+kzB6NWBFAvasCaC+zfpFyBVSIynH5UVP8Uzl2h5Dyr6kEw==","shasum":"2711af777848e4ac04d215fcbb10dd523dc97c27","tarball":"https://registry.npmjs.org/@0x86/claude-config-manager/-/claude-config-manager-1.0.0.tgz","fileCount":4,"unpackedSize":88020,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICROQVFDOQ3Gf3nirelY/qISkjnMfVlMAZJTkaWvHYyTAiA/1iJqBN/uwKSJ3XPCVAdrM66CfiuWAlQSxBCtr3yG3A=="}]},"_npmUser":{"name":"0x86","email":"xyhuangjia@gmail.com"},"directories":{},"maintainers":[{"name":"0x86","email":"xyhuangjia@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/claude-config-manager_1.0.0_1773814263441_0.6055175571597167"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-18T06:11:03.335Z","1.0.0":"2026-03-18T06:11:03.575Z","modified":"2026-03-18T06:11:03.739Z"},"maintainers":[{"name":"0x86","email":"xyhuangjia@gmail.com"}],"description":"🔧 Claude Code 配置管理工具 - 支持多配置方案切换、自动备份、实时预览","homepage":"https://github.com/xyhuangjia/claude-config-cli#readme","keywords":["claude","claude-code","config","configuration","cli","anthropic","openai","aliyun","model-switching","api-key-manager","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/xyhuangjia/claude-config-cli.git"},"author":{"name":"xyhuangjia","email":"xyhuangjia@gmail.com"},"bugs":{"url":"https://github.com/xyhuangjia/claude-config-cli/issues"},"license":"MIT","readme":"# Claude Code 配置管理工具\n\n一个使用 TypeScript 和 Bun 构建的交互式 CLI 工具，用于管理 Claude Code 的多个配置方案，支持快速切换不同的 API 提供商和模型映射。\n\n## ✨ 功能特性\n\n- ✅ 添加、编辑、删除、切换配置方案\n- ✅ 主菜单直接显示所有配置\n- ✅ 支持配置多个 API 提供商（阿里云、OpenAI、Anthropic 等）\n- ✅ 自定义模型映射（Opus/Sonnet/Haiku）\n- ✅ 交互式 CLI 界面（基于 @clack/prompts）\n- ✅ 配置预览功能\n- ✅ 配置立即生效\n- ✅ **自动备份初始配置**\n- ✅ **恢复初始设置功能**\n- ✅ 支持编译为独立可执行文件\n- ✅ 完整的错误处理和输入验证\n- ✅ API Key 安全显示\n- ✅ 启动时显示当前配置\n\n## 📦 安装\n\n### 方式 1: npm (推荐)\n\n```bash\n# 全局安装\nnpm install -g claude-config-cli\n\n# 运行\nclaude-config\n```\n\n### 方式 2: Bun\n\n```bash\n# 全局安装\nbun install -g claude-config-cli\n\n# 运行\nclaude-config\n```\n\n### 方式 3: 从源码安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/xyhuangjia/claude-config-cli.git\ncd claude-config-cli\n\n# 安装依赖\nbun install\n\n# 运行\nbun start\n```\n\n### 方式 4: 编译为可执行文件\n\n```bash\n# 编译\nbun run build\n\n# 运行\n./claude-config\n```\n\n### 方式 5: 下载可执行文件\n\n```bash\n# macOS/Linux\ncurl -L https://raw.githubusercontent.com/xyhuangjia/claude-config-cli/main/install.sh | bash\n\n# 或手动下载\n# 访问 https://github.com/xyhuangjia/claude-config-cli/releases\n```\n\n## 🚀 使用方法\n\n运行工具后，你会看到以下选项：\n\n```\n🔧 Claude Code 配置管理工具\n\n当前配置: 阿里云\n──────────────────────────────────────────────────\n  API Key:  sk-sp-ee...15a1\n  Base URL: https://coding.dashscope.aliyuncs.com/apps/anthropic\n  Opus:     glm-5\n  Sonnet:   qwen3.5-plus\n  Haiku:    MiniMax-M2.5\n──────────────────────────────────────────────────\n\n? 请选择配置或操作\n  📦 阿里云 ⭐\n  📦 OpenAI\n  📦 Anthropic\n  ➕ 添加新配置\n  🔄 恢复初始设置\n  🚪 退出\n```\n\n> 注：⭐ 表示当前正在使用的配置\n\n### 切换/编辑/删除配置\n\n1. 从主菜单直接选择一个配置（如\"📦 阿里云\"）\n2. 查看该配置的详细信息\n3. 选择操作：\n   - ✅ **切换到此配置** - 立即应用该配置\n   - ✏️ **编辑此配置** - 修改配置内容\n   - 🗑️ **删除此配置** - 删除该配置\n   - 🔙 **返回主菜单** - 返回主菜单\n\n### 恢复初始设置\n\n1. 选择\"🔄 恢复初始设置\"\n2. 查看备份信息（备份时间）\n3. 确认恢复操作\n4. 系统将自动恢复到工具首次运行时的配置\n\n> **说明**：工具会在首次运行时自动备份当前的 Claude Code 配置（API Key、Base URL、模型映射等），备份文件保存在 `~/.claude/original_settings_backup.json`\n\n### 添加新配置\n\n1. 选择\"➕ 添加新配置\"\n2. 输入配置名称（如\"阿里云\"、\"OpenAI\"等）\n3. 输入以下信息：\n   - **API Key** (ANTHROPIC_AUTH_TOKEN)\n   - **Base URL** (ANTHROPIC_BASE_URL)\n   - **Opus 模型** (ANTHROPIC_DEFAULT_OPUS_MODEL)\n   - **Sonnet 模型** (ANTHROPIC_DEFAULT_SONNET_MODEL)\n   - **Haiku 模型** (ANTHROPIC_DEFAULT_HAIKU_MODEL)\n4. 选择是否立即切换到此配置\n\n## 📁 配置存储\n\n所有配置存储在 `~/.claude/` 目录下：\n\n```\n~/.claude/\n├── settings.json                    # 当前使用的配置（Claude Code 读取此文件）\n├── profiles/                        # 所有配置方案\n│   ├── aliyun.json\n│   ├── openai.json\n│   └── anthropic.json\n├── current_profile.txt              # 记录当前配置名称\n└── original_settings_backup.json    # 初始配置备份（首次运行时自动创建）\n```\n~/.claude/\n├── settings.json                    # 当前使用的配置（Claude Code 读取此文件）\n├── original_settings_backup.json    # 原始配置备份（首次运行时创建）\n├── profiles/                        # 所有配置方案\n│   ├── aliyun.json\n│   ├── openai.json\n│   └── anthropic.json\n└── current_profile.txt              # 记录当前配置名称\n```\n\n## 📝 配置示例\n\n### 阿里云配置\n\n```json\n{\n  \"name\": \"阿里云\",\n  \"env\": {\n    \"ANTHROPIC_AUTH_TOKEN\": \"sk-xxx\",\n    \"ANTHROPIC_BASE_URL\": \"https://coding.dashscope.aliyuncs.com/apps/anthropic\",\n    \"ANTHROPIC_DEFAULT_OPUS_MODEL\": \"glm-5\",\n    \"ANTHROPIC_DEFAULT_SONNET_MODEL\": \"qwen3.5-plus\",\n    \"ANTHROPIC_DEFAULT_HAIKU_MODEL\": \"MiniMax-M2.5\"\n  }\n}\n```\n\n### OpenAI 配置\n\n```json\n{\n  \"name\": \"OpenAI\",\n  \"env\": {\n    \"ANTHROPIC_AUTH_TOKEN\": \"sk-xxx\",\n    \"ANTHROPIC_BASE_URL\": \"https://api.openai.com/v1\",\n    \"ANTHROPIC_DEFAULT_OPUS_MODEL\": \"gpt-4\",\n    \"ANTHROPIC_DEFAULT_SONNET_MODEL\": \"gpt-4-turbo\",\n    \"ANTHROPIC_DEFAULT_HAIKU_MODEL\": \"gpt-3.5-turbo\"\n  }\n}\n```\n\n### Anthropic 官方配置\n\n```json\n{\n  \"name\": \"Anthropic\",\n  \"env\": {\n    \"ANTHROPIC_AUTH_TOKEN\": \"sk-ant-xxx\",\n    \"ANTHROPIC_BASE_URL\": \"https://api.anthropic.com\",\n    \"ANTHROPIC_DEFAULT_OPUS_MODEL\": \"claude-3-opus-20240229\",\n    \"ANTHROPIC_DEFAULT_SONNET_MODEL\": \"claude-3-sonnet-20240229\",\n    \"ANTHROPIC_DEFAULT_HAIKU_MODEL\": \"claude-3-haiku-20240307\"\n  }\n}\n```\n\n## 🔧 技术栈\n\n- **Runtime**: [Bun](https://bun.sh/) - 快速的 JavaScript 运行时\n- **Language**: TypeScript\n- **CLI Framework**: [@clack/prompts](https://github.com/natemoo-re/clack) - 优雅的交互式 CLI 组件\n- **Colors**: [picocolors](https://github.com/alexeyraspopov/picocolors) - 终端颜色库\n\n## 🎯 快速开始\n\n```bash\n# 1. 安装依赖\nbun install\n\n# 2. 运行工具\nbun start\n\n# 3. 添加第一个配置（选择\"添加新配置\"）\n# 4. 切换到新配置\n# 5. 开始使用 Claude Code\n```\n\n## 🔒 安全特性\n\n- **API Key 安全显示**: 只显示前8位和后4位，中间用 `...` 代替\n- **输入验证**: 验证配置名称、API Key 格式等\n- **错误处理**: 完整的 try-catch 保护，防止程序崩溃\n- **文件权限**: 建议设置 `chmod 700 ~/.claude` 和 `chmod 600 ~/.claude/*`\n\n## 📌 注意事项\n\n1. **安全性**：API Key 以明文存储在配置文件中，请确保配置目录权限设置正确\n2. **当前配置保护**：删除当前配置时需要二次确认\n3. **配置立即生效**：切换配置后，Claude Code 会立即使用新配置，无需重启\n4. **保留其他设置**：切换配置时，只更新 `env` 相关字段，其他设置保持不变\n5. **配置合并**：新配置只会覆盖非空值，保留原有的其他环境变量\n\n## 🐛 故障排除\n\n### 找不到 bun 命令\n\n```bash\n# 安装 Bun\ncurl -fsSL https://bun.sh/install | bash\n```\n\n### 配置不生效\n\n1. 检查 `~/.claude/settings.json` 文件是否正确更新\n2. 确保配置文件格式正确（有效的 JSON）\n3. 重启 Claude Code（通常不需要，但如果遇到问题可以尝试）\n\n### 权限问题\n\n```bash\n# 确保配置目录权限正确\nchmod 700 ~/.claude\nchmod 600 ~/.claude/settings.json\nchmod 600 ~/.claude/profiles/*.json\n```\n\n### 配置文件损坏\n\n如果配置文件损坏，工具会自动使用默认配置，并提示错误信息。你可以：\n1. 删除损坏的配置文件\n2. 重新添加配置\n\n## 📄 许可证\n\nMIT\n\n## 🔗 相关链接\n\n- [快速开始](QUICKSTART.md) - 5分钟上手指南\n- [更新日志](CHANGELOG.md) - 版本更新记录\n- [发布指南](PUBLISHING.md) - 如何发布到 npm/GitHub\n- [配置示例](example-profiles.json) - 常见配置示例\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n### 贡献方式\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 创建 Pull Request\n\n## 📊 开发过程\n\n本项目使用 AI Team 模式开发：\n- **规划**: GLM-5 (Research Agent)\n- **编码**: GLM-4.7 (Implement Agent)\n- **检查**: GLM-5 (Check Agent)\n\n## 🔍 代码质量\n\n- ✅ TypeScript strict 模式\n- ✅ 完整的错误处理\n- ✅ 输入验证\n- ✅ 类型安全\n- ✅ 最佳实践\n\n## 📈 项目统计\n\n![GitHub stars](https://img.shields.io/github/stars/xyhuangjia/claude-config-cli?style=social)\n![npm downloads](https://img.shields.io/npm/dt/claude-config-cli)\n![GitHub license](https://img.shields.io/github/license/xyhuangjia/claude-config-cli)\n![GitHub release](https://img.shields.io/github/v/release/xyhuangjia/claude-config-cli)\n\n## ⭐ Star History\n\n如果这个工具对你有帮助，请给个 Star ⭐️\n\n## 💖 支持项目\n\n如果你觉得这个工具有用，可以：\n- ⭐ 给项目点星\n- 🐛 报告 Bug\n- 💡 提出新功能建议\n- 📖 改进文档\n- 🔀 提交 Pull Request\n","readmeFilename":"README.md","_rev":"1-f89a1b7080a3517622fb4dfc6d9c7f7a"}