{"_id":"@0x86/cc-config","_rev":"2-27be8577f3a65139b1c5e9131181b08b","name":"@0x86/cc-config","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@0x86/cc-config","version":"1.0.0","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","_id":"@0x86/cc-config@1.0.0","maintainers":[{"name":"0x86","email":"xyhuangjia@gmail.com"}],"homepage":"https://github.com/xyhuangjia/claude-config-cli#readme","bugs":{"url":"https://github.com/xyhuangjia/claude-config-cli/issues"},"bin":{"cc-config":"dist/index.js"},"dist":{"shasum":"564522bd9624fa3222efefe351ec4ea91540d9e0","tarball":"https://registry.npmjs.org/@0x86/cc-config/-/cc-config-1.0.0.tgz","fileCount":4,"integrity":"sha512-GrWyAJQrW6SPHK3Zb8y3Q2Li8wjTNGWWBB0UMX2FVhnbv4v05PLNbRSmlZ7jp/INSXRQMQGz7v2WUJL7Sb/rRw==","signatures":[{"sig":"MEYCIQCuRK2rhuuOUSATcL6OLBG9uA0PdSuilKl5lCpdlz90+AIhANgVlY6e3LTvT5aDtK41i59ox3JTF633ZNK60EV5ZSJE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63399},"main":"./dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"647203d434863996ae68212bc0ca258b422d892b","scripts":{"dev":"bun --watch index.ts","test":"bun test","build":"bun build index.ts --compile --outfile cc-config","start":"bun run index.ts","build:npm":"bun build index.ts --outdir ./dist --target node","typecheck":"tsc --noEmit","prepublishOnly":"bun run build:npm"},"_npmUser":{"name":"0x86","email":"xyhuangjia@gmail.com"},"repository":{"url":"git+https://github.com/xyhuangjia/claude-config-cli.git","type":"git"},"_npmVersion":"11.11.0","description":"🔧 Claude Code 配置管理工具 - 支持多配置方案切换、自动备份、实时预览","directories":{},"_nodeVersion":"25.8.1","dependencies":{"picocolors":"^1.1.1"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.0.0","@types/node":"^20.0.0"},"peerDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/cc-config_1.0.0_1773931961878_0.8812749157777788","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@0x86/cc-config","version":"1.0.1","description":"🔧 Claude Code 配置管理工具 - 支持多配置方案切换、自动备份、实时预览","type":"module","bin":{"cc-config":"dist/index.js"},"main":"./dist/index.js","scripts":{"start":"bun run index.ts","build":"bun build index.ts --compile --outfile cc-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":{"picocolors":"^1.1.1"},"gitHead":"af9ad372efcb1e53ee043c3245a36dde4828f6b4","_id":"@0x86/cc-config@1.0.1","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-ytQlK8kUMwLq3GVdgIxw/HTDxaWW8dB0xYE99NW6rzBMhREcIlHK0CMrwbVDVRvsogjVXXofkZpnZ0fsuu2eGw==","shasum":"57d046ae935c5a6b12194d1ea0add4510d887cc2","tarball":"https://registry.npmjs.org/@0x86/cc-config/-/cc-config-1.0.1.tgz","fileCount":4,"unpackedSize":63573,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCh73ZEG20leCUTHzDWcnSzHG4CRS9G1BbOivzBnHgTmAIgR7YyGNwMMex003cIGQ5xx0bJRosZcC8IP90ZGlWavho="}]},"_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/cc-config_1.0.1_1773932617929_0.7457426604964714"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-19T14:52:41.784Z","modified":"2026-03-19T15:03:38.183Z","1.0.0":"2026-03-19T14:52:42.013Z","1.0.1":"2026-03-19T15:03:38.068Z"},"bugs":{"url":"https://github.com/xyhuangjia/claude-config-cli/issues"},"author":{"name":"xyhuangjia","email":"xyhuangjia@gmail.com"},"license":"MIT","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"},"description":"🔧 Claude Code 配置管理工具 - 支持多配置方案切换、自动备份、实时预览","maintainers":[{"name":"0x86","email":"xyhuangjia@gmail.com"}],"readme":"# CC Config - Claude Code 配置管理工具\n\n一个使用 TypeScript 和 Bun 构建的命令行工具，用于管理 Claude Code 的多个配置方案，支持快速切换不同的 API 提供商和模型映射。\n\n## ✨ 功能特性\n\n- ✅ 添加、编辑、删除、切换配置方案\n- ✅ 命令行操作，简洁高效\n- ✅ 支持配置多个 API 提供商（阿里云、OpenAI、Anthropic 等）\n- ✅ 自定义模型映射（Opus/Sonnet/Haiku）\n- ✅ 交互式输入 + 命令行参数双模式\n- ✅ 配置预览功能\n- ✅ 配置立即生效\n- ✅ **自动备份初始配置**\n- ✅ **恢复初始设置功能**\n- ✅ **清理所有配置功能**\n- ✅ **一键解锁 Claude Code 隐藏超能力**\n  - 循环执行模式 (/loop)\n  - 顺便执行模式 (/btw)\n  - 1M 上下文窗口 (/context1m)\n  - MCP 搜索增强 (/MCPSearch)\n- ✅ 支持编译为独立可执行文件\n- ✅ 完整的错误处理和输入验证\n- ✅ API Key 安全显示\n\n## 📦 安装\n\n### 方式 1: npm (推荐)\n\n```bash\n# 全局安装\nnpm install -g @0x86/cc-config\n\n# 运行\ncc-config\n```\n\n### 方式 2: Bun\n\n```bash\n# 全局安装\nbun install -g @0x86/cc-config\n\n# 运行\ncc-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./cc-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```bash\ncc-config help\n```\n\n### 命令列表\n\n| 命令 | 简写 | 别名 | 说明 |\n|------|------|------|------|\n| `list` | `ls`, `l` | - | 列出所有配置 |\n| `show` | `s` | `current` | 显示当前配置 |\n| `switch` | `sw` | `use` | 切换到指定配置 |\n| `add` | `a` | `new`, `create` | 添加新配置 |\n| `edit` | `e` | `update` | 编辑配置 |\n| `delete` | `d`, `rm` | `remove` | 删除配置 |\n| `restore` | `r` | - | 恢复初始设置 |\n| `clean` | `c` | `uninstall` | 清理所有配置文件 |\n| `enable` | `en` | - | 启用隐藏功能 |\n| `disable` | `dis` | - | 禁用隐藏功能 |\n| `status` | `st` | - | 查看功能状态 |\n| `version` | `-v`, `--version` | - | 查看版本号 |\n\n### 基本操作\n\n#### 1. 列出所有配置\n\n```bash\ncc-config list\n# 或使用简写\ncc-config ls\ncc-config l\n```\n\n输出示例：\n```\n配置列表\n\n⭐ 1. aliyun\n      API Key: sk-sp-ee...15a1\n      Base URL: https://coding.dashscope.aliyuncs.com/apps/anthropic\n   2. openai\n      API Key: sk-proj...abcd\n      Base URL: https://api.openai.com/v1\n```\n\n#### 2. 查看当前配置\n\n```bash\ncc-config show\n# 或使用简写\ncc-config s\n```\n\n#### 3. 切换配置\n\n```bash\ncc-config switch aliyun\n# 或使用简写\ncc-config sw aliyun\n```\n\n#### 4. 添加新配置\n\n交互式添加（会提示输入各项配置）：\n\n```bash\ncc-config add openai\n# 或使用简写\ncc-config a openai\n```\n\n或通过参数直接添加：\n\n```bash\ncc-config a openai \\\n  --key sk-xxx \\\n  --url https://api.openai.com/v1 \\\n  --opus gpt-4 \\\n  --sonnet gpt-4-turbo \\\n  --haiku gpt-3.5-turbo\n```\n\n#### 5. 编辑配置\n\n交互式编辑：\n\n```bash\ncc-config edit aliyun\n# 或使用简写\ncc-config e aliyun\n```\n\n或通过参数直接修改：\n\n```bash\ncc-config e aliyun --key sk-new-key --url https://new-url.com\n```\n\n#### 6. 删除配置\n\n```bash\ncc-config delete openai\n# 或使用简写\ncc-config d openai\ncc-config rm openai\n```\n\n#### 7. 恢复初始设置\n\n```bash\ncc-config restore\n# 或使用简写\ncc-config r\n```\n\n> **说明**：工具会在首次运行时自动备份当前的 Claude Code 配置，备份文件保存在 `~/.claude-config-manager/original_settings_backup.json`\n\n#### 8. 清理所有配置\n\n```bash\ncc-config clean\n# 或使用简写\ncc-config c\n```\n\n### 🔓 隐藏功能管理\n\nClaude Code 有一些隐藏的超能力，可以通过 cc-config 轻松开启：\n\n#### 查看所有隐藏功能状态\n\n```bash\ncc-config status\n# 或查看单个功能\ncc-config status loop\n```\n\n#### 启用隐藏功能\n\n```bash\n# 循环执行模式 - 让 Claude 重复执行任务\ncc-config enable loop\n\n# 顺便执行模式 - 在当前任务完成后顺便执行另一个任务\ncc-config enable btw\n\n# 1M 上下文窗口 - 启用超长上下文模式\ncc-config enable context1m\n\n# MCP 搜索增强 - 使用 MCP 进行高级代码搜索\ncc-config enable mcp\n\n# 自定义快捷键\ncc-config enable keybindings\n```\n\n#### 禁用隐藏功能\n\n```bash\ncc-config disable loop\ncc-config disable btw\ncc-config disable context1m\ncc-config disable mcp\ncc-config disable keybindings\n```\n\n#### 隐藏功能说明\n\n| 功能 | 命令 | 说明 |\n|------|------|------|\n| 循环执行模式 | `/loop` | 让 Claude 重复执行某个任务，直到完成或达到指定次数 |\n| 顺便执行模式 | `/btw` | 在当前任务完成后，顺便执行另一个任务 |\n| 自定义快捷键 | `/keybindings` | 查看和配置 Claude Code 的键盘快捷键（内置命令） |\n| 1M 上下文 | `/context1m` | 启用超长上下文模式，支持处理更大的代码库 |\n| MCP 搜索 | `/MCPSearch` | 使用 MCP (Model Context Protocol) 进行高级代码搜索 |\n\n> **提示**: 开启功能后，在 Claude Code 对话框中直接输入这些命令即可使用\n\n输出示例：\n```\n配置列表\n\n⭐ 1. aliyun\n      API Key: sk-sp-ee...15a1\n      Base URL: https://coding.dashscope.aliyuncs.com/apps/anthropic\n   2. openai\n      API Key: sk-proj...abcd\n      Base URL: https://api.openai.com/v1\n```\n\n#### 2. 查看当前配置\n\n```bash\ncc-config show\n```\n\n#### 3. 切换配置\n\n```bash\ncc-config switch aliyun\n```\n\n#### 4. 添加新配置\n\n交互式添加（会提示输入各项配置）：\n\n```bash\ncc-config add openai\n```\n\n或通过参数直接添加：\n\n```bash\ncc-config add openai \\\n  --key sk-xxx \\\n  --url https://api.openai.com/v1 \\\n  --opus gpt-4 \\\n  --sonnet gpt-4-turbo \\\n  --haiku gpt-3.5-turbo\n```\n\n#### 5. 编辑配置\n\n交互式编辑：\n\n```bash\ncc-config edit aliyun\n```\n\n或通过参数直接修改：\n\n```bash\ncc-config edit aliyun --key sk-new-key --url https://new-url.com\n```\n\n#### 6. 删除配置\n\n```bash\ncc-config delete openai\n```\n\n#### 7. 恢复初始设置\n\n```bash\ncc-config restore\n```\n\n> **说明**：工具会在首次运行时自动备份当前的 Claude Code 配置，备份文件保存在 `~/.claude/original_settings_backup.json`\n\n#### 8. 清理所有配置\n\n```bash\ncc-config clean\n```\n\n此命令会删除所有配置文件和备份，需要输入 \"DELETE\" 确认。\n\n### 配置选项参数\n\n添加或编辑配置时可使用以下参数：\n\n| 参数 | 别名 | 说明 |\n|------|------|------|\n| `--key` | `-k` | API Key (ANTHROPIC_AUTH_TOKEN) |\n| `--url` | `-u` | Base URL (ANTHROPIC_BASE_URL) |\n| `--opus` | `-o` | Opus 模型 |\n| `--sonnet` | `-s` | Sonnet 模型 |\n| `--haiku` | `-H` | Haiku 模型 |\n\n## 📁 配置存储\n\n配置文件分布在两个目录：\n\n### Claude Code 配置目录 (~/.claude/)\n```\n~/.claude/\n└── settings.json                    # 当前使用的配置（Claude Code 读取此文件）\n```\n\n### 配置管理工具目录 (~/.claude-config-manager/)\n```\n~/.claude-config-manager/\n├── profiles/                        # 所有配置方案\n│   ├── aliyun.json\n│   ├── openai.json\n│   └── anthropic.json\n├── current_profile.txt              # 记录当前配置名称\n└── original_settings_backup.json    # 初始配置备份（首次运行时自动创建）\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**: Node.js readline - 内置命令行交互\n- **Colors**: [picocolors](https://github.com/alexeyraspopov/picocolors) - 终端颜色库\n\n## 🎯 快速开始\n\n```bash\n# 1. 安装工具\nnpm install -g @0x86/cc-config\n\n# 2. 添加第一个配置\ncc-config add aliyun\n\n# 3. 切换到新配置\ncc-config switch aliyun\n\n# 4. 查看当前配置\ncc-config show\n\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\n### 卸载工具\n\n#### 方式 1: npm 全局安装卸载\n\n```bash\nnpm uninstall -g @0x86/cc-config\n```\n\n#### 方式 2: Bun 全局安装卸载\n\n```bash\nbun uninstall -g @0x86/cc-config\n```\n\n#### 方式 3: 从源码安装卸载\n\n```bash\n# 删除项目目录\nrm -rf claude-config-cli\n\n# 如果创建了可执行文件\nrm claude-config\n```\n\n### 清理配置文件\n\n如果你想同时清理所有配置文件（可选）：\n\n```bash\n# 使用工具内置的清理功能\ncc-config\n# 选择 \"🗑️  卸载/清理配置\"\n\n# 或手动删除\nrm -rf ~/.claude/profiles\nrm -f ~/.claude/settings.json\nrm -f ~/.claude/current_profile.txt\nrm -f ~/.claude/original_settings_backup.json\n```\n\n> **注意**：清理配置文件会删除所有保存的 API Keys 和配置方案，请谨慎操作！\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/@0x86/cc-config)\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"}