{"id":36615437,"url":"https://github.com/icepie/nicecode-tools","last_synced_at":"2026-01-18T16:00:47.143Z","repository":{"id":332012737,"uuid":"1130771074","full_name":"icepie/nicecode-tools","owner":"icepie","description":"A powerful toolkit for nicecode users :)","archived":false,"fork":false,"pushed_at":"2026-01-12T02:07:31.000Z","size":176,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-12T16:51:52.568Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/icepie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-09T01:46:50.000Z","updated_at":"2026-01-12T02:07:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/icepie/nicecode-tools","commit_stats":null,"previous_names":["icepie/nicecode-tools"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/icepie/nicecode-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icepie%2Fnicecode-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icepie%2Fnicecode-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icepie%2Fnicecode-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icepie%2Fnicecode-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/icepie","download_url":"https://codeload.github.com/icepie/nicecode-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/icepie%2Fnicecode-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28541065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T14:59:57.589Z","status":"ssl_error","status_checked_at":"2026-01-18T14:59:46.540Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-12T09:08:13.523Z","updated_at":"2026-01-18T16:00:47.137Z","avatar_url":"https://github.com/icepie.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NiceCode API 切换工具\n\n自动配置 Claude、CodeX 和 Gemini CLI 工具，将其 API 端点切换到 NiceCode 服务。\n\n## 快速开始\n\n### Linux / macOS\n\n**一键安装并运行（推荐）：**\n\n```bash\ncurl -fsSL https://nicecode.ai/setup.sh | bash\n```\n\n**或者下载后执行：**\n\n```bash\ncurl -fsSL https://nicecode.ai/setup.sh -o setup.sh\nchmod +x setup.sh\n./setup.sh\n```\n\n**带参数执行（直接配置 Claude）：**\n\n```bash\ncurl -fsSL https://nicecode.ai/setup.sh | bash -s -- -cc -k your-api-key\n```\n\n### Windows (PowerShell)\n\n**一键安装并运行（推荐）：**\n\n```powershell\niwr -useb https://nicecode.ai/setup.ps1 | iex\n```\n\n**或者下载后执行：**\n\n```powershell\niwr -useb https://nicecode.ai/setup.ps1 -OutFile setup.ps1\n.\\setup.ps1\n```\n\n**带参数执行（直接配置 Claude）：**\n\n```powershell\n\u0026 ([ScriptBlock]::Create((iwr -useb https://nicecode.ai/setup.ps1).Content)) -cc -k your-api-key\n```\n\n## 功能特性\n\n- 支持 Claude、CodeX、Gemini 三大 AI CLI 工具\n- 交互式菜单或命令行参数两种使用方式\n- 自动创建配置文件和目录结构\n- 彩色终端输出，清晰的状态提示\n- 支持一次性配置所有产品\n- 安全的 API Key 输入（PowerShell 版本使用 SecureString）\n\n## 使用方法\n\n### 交互式菜单\n\n直接运行脚本，按照菜单提示选择：\n\n**Linux/macOS:**\n```bash\n./setup.sh\n```\n\n**Windows:**\n```powershell\n.\\setup.ps1\n```\n\n会显示如下菜单：\n\n```\n======================================\n   NiceCode API 切换工具\n======================================\n1) Claude\n2) CodeX\n3) Gemini\n4) 全部配置\n0) 退出\n======================================\n请选择要配置的产品 [1-4]:\n```\n\n### 命令行参数\n\n支持通过命令行参数直接配置，适合自动化脚本。\n\n#### 参数说明\n\n| 参数 | 简写 | 说明 | 示例 |\n|------|------|------|------|\n| `--claude` | `-cc` | 配置 Claude | `-cc` |\n| `--codex` | `-cx` | 配置 CodeX | `-cx` |\n| `--gemini` | `-gm` | 配置 Gemini | `-gm` |\n| `--choice` | `-c` | 指定产品名称 | `-c claude` |\n| `--key` | `-k` | 指定 API Key | `-k your-api-key` |\n| `--help` | `-h` | 显示帮助信息 | `-h` |\n\n#### 使用示例\n\n**配置 Claude：**\n\n```bash\n# Linux/macOS\n./setup.sh -cc -k your-api-key\n./setup.sh --claude --key your-api-key\n./setup.sh -c claude -k your-api-key\n\n# Windows\n.\\setup.ps1 -cc -k your-api-key\n.\\setup.ps1 --claude --key your-api-key\n.\\setup.ps1 -c claude -k your-api-key\n```\n\n**配置 CodeX：**\n\n```bash\n# Linux/macOS\n./setup.sh -cx -k your-api-key\n\n# Windows\n.\\setup.ps1 -cx -k your-api-key\n```\n\n**配置 Gemini：**\n\n```bash\n# Linux/macOS\n./setup.sh -gm -k your-api-key\n\n# Windows\n.\\setup.ps1 -gm -k your-api-key\n```\n\n**配置所有产品（使用相同的 API Key）：**\n\n```bash\n# Linux/macOS\n./setup.sh -c all -k your-api-key\n\n# Windows\n.\\setup.ps1 -c all -k your-api-key\n```\n\n**不指定 API Key（稍后输入）：**\n\n```bash\n# Linux/macOS\n./setup.sh -cc\n\n# Windows\n.\\setup.ps1 -cc\n```\n\n## 支持的产品\n\n### Claude\n\n- **配置目录**:\n  - Linux/macOS: `~/.claude`\n  - Windows: `%USERPROFILE%\\.claude`\n- **配置文件**: `settings.json`\n- **环境变量**:\n  - `ANTHROPIC_BASE_URL`: https://nicecode.ai\n  - `ANTHROPIC_AUTH_TOKEN`: your-api-key\n\n### CodeX\n\n- **配置目录**:\n  - Linux/macOS: `~/.codex`\n  - Windows: `%USERPROFILE%\\.codex`\n- **配置文件**:\n  - `config.toml`: 主配置文件\n  - `auth.json`: 认证文件\n- **模型配置**: gpt-5.1-codex\n\n### Gemini\n\n- **配置目录**:\n  - Linux/macOS: `~/.gemini`\n  - Windows: `%USERPROFILE%\\.gemini`\n- **配置文件**:\n  - `.env`: 环境变量配置\n  - `settings.json`: 设置文件\n- **环境变量**:\n  - `GOOGLE_GEMINI_BASE_URL`: https://nicecode.ai\n  - `GEMINI_API_KEY`: your-api-key\n\n## 配置说明\n\n### Claude 配置详情\n\n脚本会创建 `~/.claude/settings.json`:\n\n```json\n{\n  \"env\": {\n    \"ANTHROPIC_BASE_URL\": \"https://api.nicecode.ai\",\n    \"ANTHROPIC_AUTH_TOKEN\": \"your-api-key\"\n  }\n}\n```\n\n并将 `~/.claude.json` 中的 `hasCompletedOnboarding` 设置为 `true`。\n\n### CodeX 配置详情\n\n脚本会创建 `~/.codex/config.toml`:\n\n```toml\nmodel_provider = \"nicecode\"\nmodel = \"gpt-5.1-codex\"\nmodel_reasoning_effort = \"high\"\nnetwork_access = \"enabled\"\ndisable_response_storage = true\nwindows_wsl_setup_acknowledged = true\nmodel_verbosity = \"high\"\n\n[model_providers.nicecode]\nname = \"nicecode\"\nbase_url = \"https://api.nicecode.ai/v1\"\nwire_api = \"responses\"\nrequires_openai_auth = true\n```\n\n以及 `~/.codex/auth.json`:\n\n```json\n{\n  \"OPENAI_API_KEY\": \"your-api-key\"\n}\n```\n\n### Gemini 配置详情\n\n脚本会创建 `~/.gemini/.env`:\n\n```env\nGOOGLE_GEMINI_BASE_URL=https://api.nicecode.ai\nGEMINI_API_KEY=your-api-key\nGEMINI_MODEL=\n```\n\n以及 `~/.gemini/settings.json`:\n\n```json\n{\n  \"general\": {\n    \"previewFeatures\": true\n  },\n  \"ide\": {\n    \"hasSeenNudge\": true\n  },\n  \"model\": {\n    \"name\": \"gemini-3-flash-preview\"\n  },\n  \"security\": {\n    \"auth\": {\n      \"selectedType\": \"gemini-api-key\"\n    }\n  }\n}\n```\n\n## 系统要求\n\n### Linux/macOS (setup.sh)\n\n- Bash 3.2 或更高版本\n- 基本 Unix 工具：`mkdir`, `cat`, `grep`, `sed`\n- 可选：`jq`（用于更好的 JSON 处理，如未安装会自动使用备用方案）\n\n### Windows (setup.ps1)\n\n- PowerShell 5.1 或更高版本\n- Windows 7/8/10/11 或 Windows Server 2008 R2 及更高版本\n\n## 安全提示\n\n1. **审查脚本**: 在执行任何网络脚本之前，建议先下载并审查其内容：\n   ```bash\n   # Linux/macOS\n   curl -fsSL https://nicecode.ai/setup.sh -o setup.sh\n   cat setup.sh  # 查看脚本内容\n\n   # Windows\n   iwr -useb https://nicecode.ai/setup.ps1 -OutFile setup.ps1\n   Get-Content setup.ps1  # 查看脚本内容\n   ```\n\n2. **API Key 保护**:\n   - 不要在命令行历史中暴露 API Key\n   - 建议使用交互式输入而非命令行参数传递 API Key\n   - Windows 版本使用 SecureString 保护输入\n\n3. **配置文件权限**:\n   - 配置文件包含敏感信息，确保适当的文件权限\n   - Linux/macOS 建议设置为 `600` 或 `700`\n\n## 常见问题\n\n### Q: 提示\"未检测到 XXX CLI\"怎么办？\n\n**A:** 这表示对应的 CLI 工具尚未安装。请先安装相应的工具：\n\n- **Claude**: 访问 [Claude CLI 官网](https://claude.com/cli) 安装\n- **CodeX**: 访问 [CodeX 官网](https://codex.com) 安装\n- **Gemini**: 访问 [Gemini CLI 官网](https://gemini.com/cli) 安装\n\n脚本会创建配置目录，但建议先安装官方 CLI 工具以确保完整功能。\n\n### Q: 如何验证配置是否成功？\n\n**A:** 配置完成后，运行相应的 CLI 工具：\n\n```bash\n# 验证 Claude\nclaude --version\n\n# 验证 CodeX\ncodex --version\n\n# 验证 Gemini\ngemini --version\n```\n\n### Q: 如何切换回官方 API？\n\n**A:** 手动编辑配置文件，将 API URL 改回官方地址，或删除配置文件重新运行官方工具初始化。\n\n### Q: 支持哪些操作系统？\n\n**A:**\n- **Linux**: Ubuntu, Debian, CentOS, Fedora, Arch 等主流发行版\n- **macOS**: macOS 10.10 及更高版本\n- **Windows**: Windows 7/8/10/11 及 Windows Server 2008 R2 及更高版本\n\n### Q: 一键安装命令是否安全？\n\n**A:** 从互联网直接执行脚本存在安全风险。建议：\n1. 先下载脚本查看内容\n2. 确认来源可信\n3. 使用 HTTPS 连接\n4. 定期更新脚本\n\n### Q: 可以使用不同的 API Key 配置不同的产品吗？\n\n**A:** 可以。分别运行脚本配置每个产品：\n\n```bash\n./setup.sh -cc -k claude-api-key\n./setup.sh -cx -k codex-api-key\n./setup.sh -gm -k gemini-api-key\n```\n\n## 技术支持\n\n如有问题或建议，请访问：\n\n- 官网: https://nicecode.ai\n- 文档: https://nicecode.ai/docs\n- 问题反馈: https://github.com/nicecode/nicecode-tools/issues\n\n## 许可证\n\nMIT License\n\n## 更新日志\n\n### v1.0.0 (2026-01-09)\n\n- 首次发布\n- 支持 Claude、CodeX、Gemini 三大 CLI 工具\n- 提供 Linux/macOS 和 Windows 版本\n- 交互式菜单和命令行参数两种使用方式\n- 一键安装支持\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficepie%2Fnicecode-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ficepie%2Fnicecode-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ficepie%2Fnicecode-tools/lists"}