npm - ai-cli-switch - Versions diffs - 1.0.0 → 1.0.1 - Mend

ai-cli-switch 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.en.md ADDED Viewed

@@ -0,0 +1,260 @@
+<div align="center">
+<img src="assets/demo.png" alt="ai-cli-switch demo" width="720" />
+<h1>⚡ ai-cli-switch</h1>
+<p><strong>Configure all your AI CLI tools in one command</strong></p>
+<p>Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw — done in 30 seconds</p>
+<p>Works with any Base URL: official APIs, relay services, or self-hosted proxies</p>
+<br/>
+[![npm version](https://img.shields.io/npm/v/ai-cli-switch?style=flat-square&color=ff6b6b&label=npm)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm downloads](https://img.shields.io/npm/dm/ai-cli-switch?style=flat-square&color=4ecdc4&label=downloads)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm total](https://img.shields.io/npm/dt/ai-cli-switch?style=flat-square&color=45b7d1&label=total%20installs)](https://www.npmjs.com/package/ai-cli-switch)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-success?style=flat-square)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/zxyyang/ai-cli-switch?style=flat-square&color=ffd93d)](https://github.com/zxyyang/ai-cli-switch)
+<br/>
+**🌐 Language / 语言 / 언어 / भाषा**
+[🇨🇳 中文](README.md) · [🇺🇸 English](README.en.md) · [🇰🇷 한국어](README.ko.md) · [🇮🇳 हिन्दी](README.hi.md)
+</div>
+---
+## ✨ Why ai-cli-switch?
+Stop manually hunting for config file locations and formats. Stop re-configuring every tool when you switch API providers. Just run one command.
+| Without ai-cli-switch | With ai-cli-switch |
+|----------------------|-------------------|
+| Google "where is Claude Code config file" | `npx ai-cli-switch` |
+| Manually edit JSON / TOML / .env files | Interactive guided setup |
+| Risk breaking existing config | Auto-backup before every write |
+| Do it again for each tool | Configure all tools in one session |
+---
+## 🚀 Quick Start
+```bash
+npx ai-cli-switch
+```
+> Zero install required. Requires Node.js >= 18.
+Or install globally:
+```bash
+npm install -g ai-cli-switch
+ai-cli-switch
+```
+---
+## 🛠️ Supported Tools
+<table>
+  <thead>
+    <tr>
+      <th>Tool</th>
+      <th>Description</th>
+      <th>Default Base URL</th>
+      <th>Config File</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><b>Claude Code</b></td>
+      <td>Anthropic's official AI coding CLI</td>
+      <td><code>https://api.anthropic.com</code></td>
+      <td><code>~/.claude/settings.json</code></td>
+    </tr>
+    <tr>
+      <td><b>Codex</b></td>
+      <td>OpenAI's official CLI tool</td>
+      <td><code>https://api.openai.com/v1</code></td>
+      <td><code>~/.codex/auth.json</code></td>
+    </tr>
+    <tr>
+      <td><b>Gemini CLI</b></td>
+      <td>Google Gemini command-line tool</td>
+      <td><code>https://generativelanguage.googleapis.com</code></td>
+      <td><code>~/.gemini/.env</code></td>
+    </tr>
+    <tr>
+      <td><b>OpenCode</b></td>
+      <td>Open-source AI coding assistant (multi-model)</td>
+      <td>depends on model</td>
+      <td><code>~/.config/opencode/opencode.json</code></td>
+    </tr>
+    <tr>
+      <td><b>OpenClaw</b></td>
+      <td>Open-source AI coding assistant (multi-model)</td>
+      <td>depends on model</td>
+      <td><code>~/.openclaw/openclaw.json</code></td>
+    </tr>
+  </tbody>
+</table>
+---
+## 🌐 Base URL Support
+Works with any OpenAI-compatible or Anthropic-compatible endpoint:
+| Scenario | Example Base URL |
+|----------|-----------------|
+| Anthropic official | `https://api.anthropic.com` |
+| OpenAI official | `https://api.openai.com/v1` |
+| Google Gemini official | `https://generativelanguage.googleapis.com` |
+| 78code relay (Claude) | `https://www.78code.cc` |
+| 78code relay (OpenAI) | `https://www.78code.cc/v1` |
+| Local proxy | `http://127.0.0.1:8080` |
+| Any OpenAI-compatible API | `https://your-api.example.com/v1` |
+---
+## 📋 How It Works
+```
+$ npx ai-cli-switch
+  1. [Optional] Configure network proxy
+  2. Auto-detect installed AI CLI tools
+  3. Select the tool to configure
+  4. Choose model provider (for OpenCode / OpenClaw)
+  5. Enter Base URL (edit the pre-filled default)
+  6. Enter API Key (masked input)
+  7. Test API connectivity
+  8. Write config file (auto-backup existing)
+  9. Self-check verification ✅
+```
+---
+## 🔒 Security
+- **API Key never logged** — masked during input, never written to logs
+- **Atomic writes** — config failures can't corrupt existing files
+- **Auto-backup** — original config backed up as `*.bak.{timestamp}` before every change
+- **Deep merge** — only updates key-related fields, preserves all your existing settings
+---
+## 📦 Config File Formats
+<details>
+<summary><b>Claude Code</b> — <code>~/.claude/settings.json</code></summary>
+```json
+{
+  "env": {
+    "ANTHROPIC_API_KEY": "sk-ant-...",
+    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
+  }
+}
+```
+</details>
+<details>
+<summary><b>Codex</b> — <code>~/.codex/auth.json</code> + <code>config.toml</code></summary>
+```json
+{ "OPENAI_API_KEY": "sk-..." }
+```
+```toml
+model_provider = "api-openai-com"
+disable_response_storage = true
+[model_providers.api-openai-com]
+name = "api-openai-com"
+base_url = "https://api.openai.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+```
+</details>
+<details>
+<summary><b>Gemini CLI</b> — <code>~/.gemini/.env</code></summary>
+```env
+GEMINI_API_KEY=AIza...
+GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com
+```
+</details>
+---
+## 🧩 Fork for Your Own Service
+Running an API relay or proxy service? Build your own branded version:
+1. Fork this repo
+2. Set your URL as default in `src/index.js` → `DEFAULT_BASE_URLS`
+3. Update `name` and `bin` in `package.json`
+4. Update the banner and completion screen branding
+5. `npm publish`
+Your users run `npx your-package` and get configured instantly. 🎉
+**Example:** [78code-ai](https://github.com/zxyyang/78code) — a branded edition built for 78code.cc users
+---
+## ❓ FAQ
+<details>
+<summary>No AI CLI tools detected?</summary>
+Install at least one tool first:
+```bash
+npm install -g @anthropic-ai/claude-code   # Claude Code
+npm install -g @openai/codex               # Codex
+npm install -g @google/gemini-cli          # Gemini CLI
+```
+</details>
+<details>
+<summary>API connection test failed?</summary>
+- Ensure no trailing `/` in Base URL
+- Verify API Key is correct and has credits
+- Try setting a proxy at startup if you're behind a firewall
+- You can still choose "write config anyway" after a failed test
+</details>
+<details>
+<summary>How to verify the config was written?</summary>
+```bash
+cat ~/.claude/settings.json   # Claude Code
+cat ~/.gemini/.env             # Gemini CLI
+cat ~/.codex/auth.json         # Codex
+```
+</details>
+---
+## 🤝 Contributing
+PRs and issues are welcome! If this tool saves you time, please give it a ⭐ — it helps others find it.
+---
+<div align="center">
+**If this tool helped you, a ⭐ Star means the world!**
+[![Star History](https://api.star-history.com/svg?repos=zxyyang/ai-cli-switch&type=Date)](https://star-history.com/#zxyyang/ai-cli-switch&Date)
+Made with ❤️ · [npm](https://www.npmjs.com/package/ai-cli-switch) · [Issues](https://github.com/zxyyang/ai-cli-switch/issues)
+</div>

package/README.hi.md ADDED Viewed

@@ -0,0 +1,143 @@
+<div align="center">
+<img src="assets/demo.png" alt="ai-cli-switch डेमो" width="720" />
+<h1>⚡ ai-cli-switch</h1>
+<p><strong>एक कमांड से सभी AI CLI टूल्स को कॉन्फ़िगर करें</strong></p>
+<p>Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw — 30 सेकंड में</p>
+<p>किसी भी Base URL के साथ काम करता है — ऑफिशियल API, प्रॉक्सी, या सेल्फ-होस्टेड</p>
+<br/>
+[![npm version](https://img.shields.io/npm/v/ai-cli-switch?style=flat-square&color=ff6b6b&label=npm)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm downloads](https://img.shields.io/npm/dm/ai-cli-switch?style=flat-square&color=4ecdc4&label=downloads)](https://www.npmjs.com/package/ai-cli-switch)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-success?style=flat-square)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+<br/>
+**🌐 Language / 语言 / 언어 / भाषा**
+[🇨🇳 中文](README.md) · [🇺🇸 English](README.en.md) · [🇰🇷 한국어](README.ko.md) · [🇮🇳 हिन्दी](README.hi.md)
+</div>
+---
+## ✨ ai-cli-switch क्यों?
+- 😩 Claude Code, Codex, Gemini की config फाइल कहाँ है? हर बार Google करना पड़ता है?
+- 🔑 API Key का format गलत होने से टूल काम नहीं करता?
+- 🌏 API access के लिए proxy की जरूरत है लेकिन कॉन्फ़िगर कैसे करें?
+**ai-cli-switch इन सभी समस्याओं को हल करता है।** Interactive guidance के साथ 30 सेकंड में setup।
+---
+## 🚀 Quick Start
+```bash
+npx ai-cli-switch
+```
+> Install की जरूरत नहीं। बस Node.js >= 18 चाहिए।
+Global install के लिए:
+```bash
+npm install -g ai-cli-switch
+ai-cli-switch
+```
+---
+## 🛠️ Supported Tools
+| Tool | विवरण | Default Base URL | Config File |
+|------|-------|-----------------|-------------|
+| **Claude Code** | Anthropic का ऑफिशियल AI coding CLI | `https://api.anthropic.com` | `~/.claude/settings.json` |
+| **Codex** | OpenAI का ऑफिशियल CLI | `https://api.openai.com/v1` | `~/.codex/auth.json` |
+| **Gemini CLI** | Google Gemini terminal tool | `https://generativelanguage.googleapis.com` | `~/.gemini/.env` |
+| **OpenCode** | Open-source AI coding assistant | model के अनुसार | `~/.config/opencode/opencode.json` |
+| **OpenClaw** | Open-source AI coding assistant | model के अनुसार | `~/.openclaw/openclaw.json` |
+---
+## 🌐 Base URL Examples
+| Scenario | Base URL |
+|----------|----------|
+| Anthropic Official | `https://api.anthropic.com` |
+| OpenAI Official | `https://api.openai.com/v1` |
+| Google Gemini Official | `https://generativelanguage.googleapis.com` |
+| Local Proxy | `http://127.0.0.1:8080` |
+| Custom API Server | `https://your-api.example.com/v1` |
+---
+## 📋 Usage Flow
+```
+$ npx ai-cli-switch
+  1. [Optional] Network proxy सेट करें
+  2. Installed AI CLI tools auto-detect
+  3. Configure करने का tool चुनें
+  4. Model provider चुनें (OpenCode/OpenClaw के लिए)
+  5. Base URL दर्ज करें (default बदल सकते हैं)
+  6. API Key दर्ज करें (masked input)
+  7. API connection test
+  8. Config file लिखें (existing का auto-backup)
+  9. Self-check verification ✅
+```
+---
+## 🔒 Security
+- **API Key कभी log नहीं होता** — input masked, कोई log नहीं
+- **Atomic writes** — failure पर existing config सुरक्षित रहती है
+- **Auto-backup** — हर save से पहले `*.bak.{timestamp}` backup
+- **Deep merge** — सिर्फ key fields update होते हैं, बाकी settings safe
+---
+## ❓ FAQ
+<details>
+<summary>"कोई AI CLI tool नहीं मिला" error?</summary>
+पहले tool install करें:
+```bash
+npm install -g @anthropic-ai/claude-code
+npm install -g @openai/codex
+npm install -g @google/gemini-cli
+```
+</details>
+<details>
+<summary>API connection test fail हो रहा है?</summary>
+- Base URL के अंत में `/` न हो
+- API Key सही और valid हो
+- Firewall के पीछे हैं तो proxy set करें
+- Test fail के बाद भी "config save करें" option मिलेगा
+</details>
+---
+## 🤝 Contributing
+PRs और Issues का स्वागत है! अगर helpful लगा तो ⭐ Star जरूर दें।
+---
+<div align="center">
+**अगर यह tool काम आया तो ⭐ Star से support करें!**
+Made with ❤️ · [npm](https://www.npmjs.com/package/ai-cli-switch) · [Issues](https://github.com/zxyyang/ai-cli-switch/issues)
+</div>

package/README.ko.md ADDED Viewed

@@ -0,0 +1,143 @@
+<div align="center">
+<img src="assets/demo.png" alt="ai-cli-switch 데모" width="720" />
+<h1>⚡ ai-cli-switch</h1>
+<p><strong>모든 AI CLI 도구를 한 번에 설정하세요</strong></p>
+<p>Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw — 30초면 완료</p>
+<p>공식 API, 릴레이 서비스, 자체 프록시 — 모든 Base URL 지원</p>
+<br/>
+[![npm version](https://img.shields.io/npm/v/ai-cli-switch?style=flat-square&color=ff6b6b&label=npm)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm downloads](https://img.shields.io/npm/dm/ai-cli-switch?style=flat-square&color=4ecdc4&label=downloads)](https://www.npmjs.com/package/ai-cli-switch)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-success?style=flat-square)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+<br/>
+**🌐 Language / 语言 / 언어 / भाषा**
+[🇨🇳 中文](README.md) · [🇺🇸 English](README.en.md) · [🇰🇷 한국어](README.ko.md) · [🇮🇳 हिन्दी](README.hi.md)
+</div>
+---
+## ✨ 왜 ai-cli-switch인가?
+- 😩 Claude Code, Codex, Gemini 설정 파일 위치를 매번 검색하시나요?
+- 🔑 API 키를 입력했는데 형식이 틀려서 동작이 안 되나요?
+- 🌏 해외 API에 접근하기 위해 프록시를 사용해야 하나요?
+**ai-cli-switch로 이 모든 문제를 해결하세요.** 대화형 안내로 30초 만에 설정 완료.
+---
+## 🚀 빠른 시작
+```bash
+npx ai-cli-switch
+```
+> 설치 불필요. Node.js >= 18만 있으면 됩니다.
+전역 설치:
+```bash
+npm install -g ai-cli-switch
+ai-cli-switch
+```
+---
+## 🛠️ 지원 도구
+| 도구 | 설명 | 기본 Base URL | 설정 파일 |
+|------|------|---------------|-----------|
+| **Claude Code** | Anthropic 공식 AI 코딩 CLI | `https://api.anthropic.com` | `~/.claude/settings.json` |
+| **Codex** | OpenAI 공식 CLI | `https://api.openai.com/v1` | `~/.codex/auth.json` |
+| **Gemini CLI** | Google Gemini 터미널 도구 | `https://generativelanguage.googleapis.com` | `~/.gemini/.env` |
+| **OpenCode** | 오픈소스 AI 코딩 어시스턴트 | 모델에 따라 다름 | `~/.config/opencode/opencode.json` |
+| **OpenClaw** | 오픈소스 AI 코딩 어시스턴트 | 모델에 따라 다름 | `~/.openclaw/openclaw.json` |
+---
+## 🌐 Base URL 예시
+| 시나리오 | Base URL 예시 |
+|----------|---------------|
+| Anthropic 공식 | `https://api.anthropic.com` |
+| OpenAI 공식 | `https://api.openai.com/v1` |
+| Google Gemini 공식 | `https://generativelanguage.googleapis.com` |
+| 로컬 프록시 | `http://127.0.0.1:8080` |
+| 커스텀 API 서버 | `https://your-api.example.com/v1` |
+---
+## 📋 사용 흐름
+```
+$ npx ai-cli-switch
+  1. [선택] 네트워크 프록시 설정
+  2. 설치된 AI CLI 도구 자동 감지
+  3. 설정할 도구 선택
+  4. 모델 제공자 선택 (OpenCode/OpenClaw용)
+  5. Base URL 입력 (기본값 수정 가능)
+  6. API Key 입력 (마스킹 처리)
+  7. API 연결 테스트 자동 실행
+  8. 설정 파일 저장 (기존 파일 자동 백업)
+  9. 자체 검증 ✅
+```
+---
+## 🔒 보안
+- **API Key 비노출** — 입력 시 완전히 마스킹, 로그 기록 없음
+- **원자 쓰기** — 실패 시 기존 설정 파일 손상 없음
+- **자동 백업** — 매 저장 전 `*.bak.{timestamp}` 형식으로 백업
+- **딥 머지** — 기존 설정을 유지하고 키 관련 필드만 업데이트
+---
+## ❓ 자주 묻는 질문
+<details>
+<summary>"설치된 AI CLI 도구가 없습니다" 오류</summary>
+도구를 먼저 설치하세요:
+```bash
+npm install -g @anthropic-ai/claude-code
+npm install -g @openai/codex
+npm install -g @google/gemini-cli
+```
+</details>
+<details>
+<summary>API 연결 테스트 실패 시</summary>
+- Base URL 끝에 `/` 없는지 확인
+- API Key 유효성 및 잔액 확인
+- 방화벽 환경이라면 프록시 설정 필요
+- 테스트 실패 후에도 "설정 저장" 선택 가능
+</details>
+---
+## 🤝 기여하기
+PR과 Issue 환영합니다! 유용하셨다면 ⭐ Star를 눌러주세요.
+---
+<div align="center">
+**유용하게 사용하셨다면 ⭐ Star로 응원해주세요!**
+Made with ❤️ · [npm](https://www.npmjs.com/package/ai-cli-switch) · [Issues](https://github.com/zxyyang/ai-cli-switch/issues)
+</div>

package/README.md CHANGED Viewed

@@ -1,194 +1,215 @@
-# ai-cli-switch
+<div align="center">
-> 一条命令配置所有 AI CLI 工具 — Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw
-> Supports any Base URL: official APIs, self-hosted proxies, or third-party relay services.
+<img src="assets/demo.png" alt="ai-cli-switch demo" width="720" />
-[![npm version](https://img.shields.io/npm/v/ai-cli-switch)](https://www.npmjs.com/package/ai-cli-switch)
-[![npm downloads](https://img.shields.io/npm/dm/ai-cli-switch)](https://www.npmjs.com/package/ai-cli-switch)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+<h1>⚡ ai-cli-switch</h1>
----
-## Demo
+<p><strong>一条命令，完成所有 AI CLI 工具的 API 配置</strong></p>
+<p>Configure Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw in seconds</p>
+<p>支持任意 Base URL — 官方 API / 中转服务 / 自建代理</p>
-```
-$ npx ai-cli-switch
+<br/>
-  ─────────────────────────────────────────
-    ___    ____   ________    ____
-   /   |  /  _/  / ____/ /   / __/___ _
-  / /| |  / /   / /   / /   / /_/ __ `/
- / ___ |_/ /   / /___/ /___/ __/ /_/ /
-/_/  |_/___/   \____/_____/_/  \__, /
-                               /____/
+[![npm version](https://img.shields.io/npm/v/ai-cli-switch?style=flat-square&color=ff6b6b&label=npm)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm downloads](https://img.shields.io/npm/dm/ai-cli-switch?style=flat-square&color=4ecdc4&label=downloads)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm total](https://img.shields.io/npm/dt/ai-cli-switch?style=flat-square&color=45b7d1&label=total%20installs)](https://www.npmjs.com/package/ai-cli-switch)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-success?style=flat-square)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/zxyyang/ai-cli-switch?style=flat-square&color=ffd93d)](https://github.com/zxyyang/ai-cli-switch)
-   AI CLI Config v1.0.0
-   快速配置 Claude Code / Codex / Gemini / OpenCode / OpenClaw
-   支持自定义 Base URL，兼容任意 API 中转服务
-  ─────────────────────────────────────────
+<br/>
-? 是否需要设置网络代理？  否
-⠋ 正在检测环境...
-✔ 环境检测完成
+**🌐 语言 / Language / 언어 / भाषा**
-  平台        macOS (arm64)
-  Node.js     v22.0.0
-  Shell       /bin/zsh
-  用户目录     /Users/yourname
+[🇨🇳 中文](README.md) · [🇺🇸 English](README.en.md) · [🇰🇷 한국어](README.ko.md) · [🇮🇳 हिन्दी](README.hi.md)
-  检测到 2 个已安装工具:
+</div>
-    ● Claude Code
-    ● Gemini CLI
-? 选择要配置的工具   Claude Code
-? Base URL（留空使用官方地址，或填入你的中转地址）
-  https://api.anthropic.com        ← 默认官方，直接改成中转地址即可
+---
-? API Key  ********
+## ✨ 为什么选择 ai-cli-switch？
-⠋ 正在测试 API 连接...
-✔ API 连接测试通过
-✔ 配置写入成功
-    配置文件: /Users/yourname/.claude/settings.json
-    备份文件: /Users/yourname/.claude/settings.json.bak.1709123456789
-✔ 自检通过，一切正常
-  └ 完成
+你是否遇到过这些问题？
-? 是否继续配置其他工具？  否
+- 🤔 Claude Code / Codex / Gemini 配置文件在哪？格式是什么？
+- 😩 每次换 API 中转都要手动改多个配置文件
+- 🔑 API Key 配置错了格式导致工具无法使用
+- 🌏 国内访问需要中转，不知道怎么配置 Base URL
-  ─────────────────────────────────────────
+**ai-cli-switch 解决这一切。** 交互式引导，30 秒完成配置，支持所有主流 AI CLI 工具。
-   ✅ 全部配置完成！
+---
-   你的 AI CLI 工具已配置完毕，尽情享用吧！
+## 🚀 快速开始
-  ─────────────────────────────────────────
+```bash
+npx ai-cli-switch
 ```
----
+> 无需安装，一行命令即可运行。Node.js >= 18 即可。
-## 简介
+或全局安装后使用：
-`ai-cli-switch` 是一个通用的 AI CLI 配置助手，支持：
+```bash
+npm install -g ai-cli-switch
+ai-cli-switch
+```
-- **官方 API** — `api.anthropic.com` / `api.openai.com` / `generativelanguage.googleapis.com`
-- **第三方中转服务** — 如 78code.cc、openrouter 等
-- **自建 API 代理** — 本地或云端任意地址
+---
-无需手动编辑配置文件，交互式填写 Base URL 和 API Key 即可完成。
+## 🛠️ 支持的工具
+<table>
+  <thead>
+    <tr>
+      <th>工具</th>
+      <th>说明</th>
+      <th>默认 Base URL</th>
+      <th>配置文件</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><b>Claude Code</b></td>
+      <td>Anthropic 官方 AI 编程助手</td>
+      <td><code>https://api.anthropic.com</code></td>
+      <td><code>~/.claude/settings.json</code></td>
+    </tr>
+    <tr>
+      <td><b>Codex</b></td>
+      <td>OpenAI 官方 CLI 工具</td>
+      <td><code>https://api.openai.com/v1</code></td>
+      <td><code>~/.codex/auth.json</code></td>
+    </tr>
+    <tr>
+      <td><b>Gemini CLI</b></td>
+      <td>Google Gemini 命令行工具</td>
+      <td><code>https://generativelanguage.googleapis.com</code></td>
+      <td><code>~/.gemini/.env</code></td>
+    </tr>
+    <tr>
+      <td><b>OpenCode</b></td>
+      <td>开源 AI 编程助手（多模型）</td>
+      <td>视模型而定</td>
+      <td><code>~/.config/opencode/opencode.json</code></td>
+    </tr>
+    <tr>
+      <td><b>OpenClaw</b></td>
+      <td>开源 AI 编程助手（多模型）</td>
+      <td>视模型而定</td>
+      <td><code>~/.openclaw/openclaw.json</code></td>
+    </tr>
+  </tbody>
+</table>
 ---
-## 支持的工具
+## 🌐 支持的 Base URL 类型
-| 工具 | 说明 | 默认 Base URL |
-|------|------|---------------|
-| **Claude Code** | Anthropic 官方 CLI | `https://api.anthropic.com` |
-| **Codex** | OpenAI Codex CLI | `https://api.openai.com/v1` |
-| **Gemini CLI** | Google Gemini 命令行 | `https://generativelanguage.googleapis.com` |
-| **OpenCode** | 开源 AI 编程助手（Claude/OpenAI/Gemini） | 视模型而定 |
-| **OpenClaw** | 开源 AI 编程助手（Claude/OpenAI/Gemini） | 视模型而定 |
+| 场景 | Base URL 示例 |
+|------|---------------|
+| Anthropic 官方 API | `https://api.anthropic.com` |
+| OpenAI 官方 API | `https://api.openai.com/v1` |
+| Google Gemini 官方 | `https://generativelanguage.googleapis.com` |
+| **78code 中转（Claude）** | `https://www.78code.cc` |
+| **78code 中转（OpenAI）** | `https://www.78code.cc/v1` |
+| 自建本地代理 | `http://127.0.0.1:8080` |
+| 任意 OpenAI 兼容接口 | `https://your-api.example.com/v1` |
 ---
-## 快速开始
-### 无需安装，直接运行
+## 📋 使用流程
-```bash
-npx ai-cli-switch
 ```
+$ npx ai-cli-switch
-### 全局安装
-```bash
-npm install -g ai-cli-switch
-ai-cli-switch
+  1. [可选] 设置网络代理（支持 HTTP/HTTPS 代理）
+  2. 自动检测已安装的 AI CLI 工具
+  3. 选择要配置的工具
+  4. 选择模型类型（OpenCode/OpenClaw 需要）
+  5. 输入 Base URL（可修改默认值）
+  6. 输入 API Key（密码模式，字符不显示）
+  7. 自动测试 API 连通性
+  8. 写入配置文件（自动备份原文件）
+  9. 自检验证 ✅
 ```
 ---
-## Base URL 填写示例
+## 🔒 安全设计
-| 场景 | Base URL 示例 |
-|------|---------------|
-| Anthropic 官方 | `https://api.anthropic.com` |
-| OpenAI 官方 | `https://api.openai.com/v1` |
-| Gemini 官方 | `https://generativelanguage.googleapis.com` |
-| 78code 中转（Claude） | `https://www.78code.cc` |
-| 78code 中转（OpenAI） | `https://www.78code.cc/v1` |
-| 自建代理（本地） | `http://127.0.0.1:8080` |
-| 云端代理 | `https://your-proxy.example.com` |
+- **API Key 不落盘**：输入时完全遮蔽，不写入日志
+- **原子写入**：配置写入失败不会破坏原有配置
+- **自动备份**：每次写入前备份原文件，格式 `*.bak.{timestamp}`
+- **只改密钥字段**：深度合并配置，不会删除你其他的自定义配置
 ---
-## 各工具配置详情
+## 📦 配置文件格式
-### Claude Code
-写入 `~/.claude/settings.json`：
+<details>
+<summary><b>Claude Code</b> — <code>~/.claude/settings.json</code></summary>
 ```json
 {
   "env": {
-    "ANTHROPIC_API_KEY": "<your-api-key>",
-    "ANTHROPIC_BASE_URL": "<your-base-url>"
+    "ANTHROPIC_API_KEY": "sk-ant-...",
+    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
   }
 }
 ```
+</details>
-### Codex (OpenAI)
-- `~/.codex/auth.json` → `{ "OPENAI_API_KEY": "..." }`
-- `~/.codex/config.toml` → 添加自定义 provider 段落（provider ID 根据 Base URL hostname 自动生成）
+<details>
+<summary><b>Codex</b> — <code>~/.codex/auth.json</code> + <code>config.toml</code></summary>
-### Gemini CLI
-写入 `~/.gemini/.env`：
-```
-GEMINI_API_KEY=<your-api-key>
-GOOGLE_GEMINI_BASE_URL=<your-base-url>
+```json
+{ "OPENAI_API_KEY": "sk-..." }
 ```
-### OpenCode
-写入 `~/.config/opencode/opencode.json`，provider ID 格式为 `{hostname}-{model-type}`。
-### OpenClaw
-写入 `~/.openclaw/openclaw.json`，格式同 OpenCode。
----
+```toml
+model_provider = "api-openai-com"
+disable_response_storage = true
-## 配置备份
+[model_providers.api-openai-com]
+name = "api-openai-com"
+base_url = "https://api.openai.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+```
+</details>
-每次写入前自动备份原配置文件：
+<details>
+<summary><b>Gemini CLI</b> — <code>~/.gemini/.env</code></summary>
+```env
+GEMINI_API_KEY=AIza...
+GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com
 ```
-~/.claude/settings.json.bak.1709123456789
-```
+</details>
 ---
-## 前置要求
+## 🧩 Fork 为你自己的专属版
-- **Node.js** >= 18.0.0（[下载](https://nodejs.org)）
-- 至少安装了一个上述 AI CLI 工具
+运营 API 中转服务？可以基于本工具快速定制：
-### 安装 Claude Code（示例）
+1. Fork 本仓库
+2. 修改 `src/index.js` 中的 `DEFAULT_BASE_URLS` 为你的服务地址
+3. 修改 `package.json` 的 `name` 和 `bin`
+4. 更新 Banner 和完成页面的品牌信息
+5. `npm publish` 发布
-```bash
-npm install -g @anthropic-ai/claude-code
-```
+用户只需 `npx 你的包名` 即可一键配置你的服务 🎉
+**示例：** [78code-ai](https://github.com/zxyyang/78code) — 基于本工具为 78code.cc 定制的专属版本
 ---
-## 常见问题
+## ❓ 常见问题
-**Q: 提示"未检测到任何已安装的 AI CLI 工具"？**
+<details>
+<summary>提示"未检测到任何已安装的 AI CLI 工具"</summary>
 请先安装对应工具：
@@ -197,54 +218,46 @@ npm install -g @anthropic-ai/claude-code   # Claude Code
 npm install -g @openai/codex               # Codex
 npm install -g @google/gemini-cli          # Gemini CLI
 ```
+</details>
-**Q: API 连接测试失败？**
+<details>
+<summary>API 连接测试失败怎么办？</summary>
-- 检查 Base URL 是否正确（末尾不要加 `/`）
-- 检查 API Key 是否有效
-- 国内网络可在启动时选择设置代理
+- 检查 Base URL 末尾不要有 `/`
+- 确认 API Key 正确且有余额
+- 国内网络请在启动时配置代理（工具会提示）
+- 测试失败后仍可选择"继续写入配置"
+</details>
-**Q: 如何手动验证 Claude Code 配置？**
+<details>
+<summary>如何验证配置是否生效？</summary>
 ```bash
+# Claude Code
 cat ~/.claude/settings.json
-```
----
-## 项目结构
+# Gemini CLI
+cat ~/.gemini/.env
+# Codex
+cat ~/.codex/auth.json
 ```
-ai-cli-switch/
-├── bin/
-│   └── index.js          # CLI 入口
-├── src/
-│   ├── index.js          # 主流程（交互逻辑）
-│   ├── utils.js          # 工具函数
-│   └── config/
-│       ├── claude.js     # Claude Code 配置模块
-│       ├── codex.js      # Codex 配置模块
-│       ├── gemini.js     # Gemini CLI 配置模块
-│       ├── opencode.js   # OpenCode 配置模块
-│       └── openclaw.js   # OpenClaw 配置模块
-└── package.json
-```
+</details>
 ---
-## Fork 为自己的专属版
+## 🤝 贡献
-如果你运营自己的 API 中转服务，可以 fork 本仓库：
+欢迎提交 PR 和 Issue！如果这个工具对你有帮助，请点个 ⭐ Star，让更多人发现它。
-1. 修改 `src/index.js` 中 `DEFAULT_BASE_URLS` 为你的服务地址
-2. 修改 `package.json` 中的 `name` 和 `bin` 字段
-3. 更新 banner 和完成页面中的品牌信息
-4. 发布到 npm，用户即可一键使用你的专属配置工具
+---
-示例：[78code-ai](https://github.com/zxyyang/78code) — 基于本工具的 78code.cc 专属版
+<div align="center">
----
+**如果觉得有用，请给个 ⭐ Star 支持一下！**
+[![Star History](https://api.star-history.com/svg?repos=zxyyang/ai-cli-switch&type=Date)](https://star-history.com/#zxyyang/ai-cli-switch&Date)
-## License
+Made with ❤️ · [npm](https://www.npmjs.com/package/ai-cli-switch) · [Issues](https://github.com/zxyyang/ai-cli-switch/issues)
-MIT
+</div>

package/README.zh.md ADDED Viewed

@@ -0,0 +1,208 @@
+# ai-cli-switch
+> 一条命令配置所有 AI CLI 工具
+> 支持任意 Base URL — 官方 API、第三方中转服务或自建代理均可
+[![npm version](https://img.shields.io/npm/v/ai-cli-switch)](https://www.npmjs.com/package/ai-cli-switch)
+[![npm downloads](https://img.shields.io/npm/dm/ai-cli-switch)](https://www.npmjs.com/package/ai-cli-switch)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[English](README.md)
+---
+## 演示
+![ai-cli-switch 演示](assets/demo.png)
+---
+## 简介
+`ai-cli-switch` 是一个通用的 AI CLI 配置助手，支持：
+- **官方 API** — `api.anthropic.com` / `api.openai.com` / `generativelanguage.googleapis.com`
+- **第三方中转服务** — 如 78code.cc、OpenRouter 等
+- **自建 API 代理** — 本地或云端任意地址
+无需手动编辑配置文件，交互式填写 Base URL 和 API Key 即可完成配置。
+---
+## 支持的工具
+| 工具 | 说明 | 默认 Base URL |
+|------|------|---------------|
+| **Claude Code** | Anthropic 官方 CLI | `https://api.anthropic.com` |
+| **Codex** | OpenAI Codex CLI | `https://api.openai.com/v1` |
+| **Gemini CLI** | Google Gemini 命令行 | `https://generativelanguage.googleapis.com` |
+| **OpenCode** | 开源 AI 编程助手（Claude/OpenAI/Gemini） | 视模型而定 |
+| **OpenClaw** | 开源 AI 编程助手（Claude/OpenAI/Gemini） | 视模型而定 |
+---
+## 快速开始
+### 无需安装，直接运行
+```bash
+npx ai-cli-switch
+```
+### 全局安装
+```bash
+npm install -g ai-cli-switch
+ai-cli-switch
+```
+---
+## 使用流程
+```
+ai-cli-switch
+  │
+  ├─ [可选] 设置网络代理
+  │
+  ├─ 自动检测已安装的 AI CLI 工具
+  │
+  ├─ 选择要配置的工具
+  │       Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw
+  │
+  ├─ [OpenCode/OpenClaw] 选择模型类型
+  │       Claude (Anthropic) / OpenAI (GPT) / Gemini (Google)
+  │
+  ├─ 输入 Base URL
+  │       默认为官方地址，直接修改为中转/代理地址即可
+  │
+  ├─ 输入 API Key（密码模式，不显示明文）
+  │
+  ├─ 自动测试 API 连接
+  │
+  ├─ 写入配置文件（自动备份原配置）
+  │
+  └─ 自检确认配置生效 ✅
+```
+---
+## Base URL 填写示例
+| 场景 | Base URL 示例 |
+|------|---------------|
+| Anthropic 官方 | `https://api.anthropic.com` |
+| OpenAI 官方 | `https://api.openai.com/v1` |
+| Gemini 官方 | `https://generativelanguage.googleapis.com` |
+| 78code 中转（Claude） | `https://www.78code.cc` |
+| 78code 中转（OpenAI） | `https://www.78code.cc/v1` |
+| 自建代理（本地） | `http://127.0.0.1:8080` |
+| 云端代理 | `https://your-proxy.example.com` |
+---
+## 各工具配置详情
+### Claude Code
+写入 `~/.claude/settings.json`：
+```json
+{
+  "env": {
+    "ANTHROPIC_API_KEY": "<your-api-key>",
+    "ANTHROPIC_BASE_URL": "<your-base-url>"
+  }
+}
+```
+### Codex (OpenAI)
+- `~/.codex/auth.json` → `{ "OPENAI_API_KEY": "..." }`
+- `~/.codex/config.toml` → 添加自定义 provider 段落（ID 根据 Base URL hostname 自动生成）
+### Gemini CLI
+写入 `~/.gemini/.env`：
+```
+GEMINI_API_KEY=<your-api-key>
+GOOGLE_GEMINI_BASE_URL=<your-base-url>
+```
+### OpenCode
+写入 `~/.config/opencode/opencode.json`，provider ID 格式：`{hostname}-{model-type}`
+### OpenClaw
+写入 `~/.openclaw/openclaw.json`，格式同 OpenCode
+---
+## 配置备份
+每次写入前自动备份原配置文件：
+```
+~/.claude/settings.json.bak.1709123456789
+```
+---
+## 前置要求
+- **Node.js** >= 18.0.0（[下载](https://nodejs.org)）
+- 至少安装了一个上述 AI CLI 工具
+### 安装 Claude Code（示例）
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+---
+## 常见问题
+**Q: 提示"未检测到任何已安装的 AI CLI 工具"？**
+请先安装对应工具：
+```bash
+npm install -g @anthropic-ai/claude-code   # Claude Code
+npm install -g @openai/codex               # Codex
+npm install -g @google/gemini-cli          # Gemini CLI
+```
+**Q: API 连接测试失败？**
+- 检查 Base URL 是否正确（末尾不要加 `/`）
+- 检查 API Key 是否有效
+- 国内网络可在启动时选择设置代理
+**Q: 如何手动验证 Claude Code 配置？**
+```bash
+cat ~/.claude/settings.json
+```
+---
+## Fork 为自己的专属版
+如果你运营自己的 API 中转服务，可以 fork 本仓库：
+1. 修改 `src/index.js` 中 `DEFAULT_BASE_URLS` 为你的服务地址
+2. 修改 `package.json` 中的 `name` 和 `bin` 字段
+3. 更新 banner 和完成页面中的品牌信息
+4. 发布到 npm，用户 `npx 你的包名` 即可一键配置
+示例：[78code-ai](https://github.com/zxyyang/78code) — 基于本工具定制的 78code.cc 专属版
+---
+## License
+MIT

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "ai-cli-switch",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "One-command configuration tool for AI CLI tools — Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw. Bring your own Base URL.",
   "type": "module",
   "bin": {
@@ -14,14 +14,31 @@
     "ai",
     "cli",
     "claude-code",
+    "claude",
     "codex",
     "gemini",
+    "gemini-cli",
     "opencode",
     "openclaw",
     "api-key",
     "configuration",
     "base-url",
-    "proxy"
+    "proxy",
+    "anthropic",
+    "openai",
+    "google",
+    "ai-tools",
+    "developer-tools",
+    "cli-tool",
+    "api-config",
+    "setup",
+    "interactive",
+    "ai-cli",
+    "llm",
+    "ai-setup",
+    "claude-code-config",
+    "openai-proxy",
+    "api-proxy"
   ],
   "author": "",
   "license": "MIT",