ai-cli-switch 1.0.0

package/README.md

@@ -0,0 +1,250 @@
+# ai-cli-switch
+
+> 一条命令配置所有 AI CLI 工具 — Claude Code · Codex · Gemini CLI · OpenCode · OpenClaw
+> Supports any Base URL: official APIs, self-hosted proxies, or third-party relay services.
+
+[![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)
+
+---
+
+## Demo
+
+```
+$ npx ai-cli-switch
+
+  ─────────────────────────────────────────
+    ___    ____   ________    ____
+   /   |  /  _/  / ____/ /   / __/___ _
+  / /| |  / /   / /   / /   / /_/ __ `/
+ / ___ |_/ /   / /___/ /___/ __/ /_/ /
+/_/  |_/___/   \____/_____/_/  \__, /
+                               /____/
+
+   AI CLI Config v1.0.0
+   快速配置 Claude Code / Codex / Gemini / OpenCode / OpenClaw
+   支持自定义 Base URL，兼容任意 API 中转服务
+  ─────────────────────────────────────────
+
+? 是否需要设置网络代理？  否
+⠋ 正在检测环境...
+✔ 环境检测完成
+
+  平台        macOS (arm64)
+  Node.js     v22.0.0
+  Shell       /bin/zsh
+  用户目录     /Users/yourname
+
+  检测到 2 个已安装工具:
+
+    ● Claude Code
+    ● Gemini CLI
+
+? 选择要配置的工具   Claude Code
+? Base URL（留空使用官方地址，或填入你的中转地址）
+  https://api.anthropic.com        ← 默认官方，直接改成中转地址即可
+
+? API Key  ********
+
+⠋ 正在测试 API 连接...
+✔ API 连接测试通过
+✔ 配置写入成功
+    配置文件: /Users/yourname/.claude/settings.json
+    备份文件: /Users/yourname/.claude/settings.json.bak.1709123456789
+✔ 自检通过，一切正常
+  └ 完成
+
+? 是否继续配置其他工具？  否
+
+  ─────────────────────────────────────────
+
+   ✅ 全部配置完成！
+
+   你的 AI CLI 工具已配置完毕，尽情享用吧！
+
+  ─────────────────────────────────────────
+```
+
+---
+
+## 简介
+
+`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
+```
+
+---
+
+## 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 段落（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
+```
+
+---
+
+## 项目结构
+
+```
+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
+```
+
+---
+
+## Fork 为自己的专属版
+
+如果你运营自己的 API 中转服务，可以 fork 本仓库：
+
+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 专属版
+
+---
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { main } from '../src/index.js';
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "ai-cli-switch",
+  "version": "1.0.0",
+  "description": "One-command configuration tool for AI CLI tools — Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw. Bring your own Base URL.",
+  "type": "module",
+  "bin": {
+    "ai-cli-switch": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "keywords": [
+    "ai",
+    "cli",
+    "claude-code",
+    "codex",
+    "gemini",
+    "opencode",
+    "openclaw",
+    "api-key",
+    "configuration",
+    "base-url",
+    "proxy"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/config/claude.js

@@ -0,0 +1,89 @@
+import path from 'path';
+import fs from 'fs';
+import { HOME, readJsonFile, writeJsonFile, backupFile, deepMerge, commandExists } from '../utils.js';
+
+const CONFIG_DIR = path.join(HOME, '.claude');
+const SETTINGS_PATH = path.join(CONFIG_DIR, 'settings.json');
+const LEGACY_PATH = path.join(CONFIG_DIR, 'claude.json');
+
+function getSettingsPath() {
+  if (fs.existsSync(SETTINGS_PATH)) return SETTINGS_PATH;
+  if (fs.existsSync(LEGACY_PATH)) return LEGACY_PATH;
+  return SETTINGS_PATH; // 默认新建
+}
+
+export const claude = {
+  id: 'claude',
+  name: 'Claude Code',
+  command: 'claude',
+
+  isInstalled() {
+    return commandExists('claude');
+  },
+
+  getConfigPath() {
+    return getSettingsPath();
+  },
+
+  readConfig() {
+    return readJsonFile(getSettingsPath());
+  },
+
+  async configure({ apiKey, baseUrl, model }) {
+    const configPath = getSettingsPath();
+    const existing = readJsonFile(configPath) || {};
+
+    // 备份
+    const backupPath = backupFile(configPath);
+
+    // 构建要写入的 env 字段
+    const envUpdate = {};
+    if (apiKey) envUpdate.ANTHROPIC_API_KEY = apiKey;
+    if (baseUrl) envUpdate.ANTHROPIC_BASE_URL = baseUrl;
+    if (model) {
+      envUpdate.ANTHROPIC_MODEL = model;
+      envUpdate.ANTHROPIC_DEFAULT_SONNET_MODEL = model;
+    }
+
+    // 深度合并：保留原有配置，只更新密钥相关字段
+    const merged = deepMerge(existing, { env: envUpdate });
+    writeJsonFile(configPath, merged);
+
+    return { configPath, backupPath };
+  },
+
+  async testApiKey(apiKey, baseUrl) {
+    const url = baseUrl || 'https://api.anthropic.com';
+    try {
+      const res = await fetch(`${url}/v1/messages`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-api-key': apiKey,
+          'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+          model: 'claude-haiku-4-5-20251001',
+          max_tokens: 1,
+          messages: [{ role: 'user', content: 'hi' }],
+        }),
+        signal: AbortSignal.timeout(15000),
+      });
+      // 200/400/403 等都说明连接正常, 仅 401 说明密钥无效
+      if (res.status === 401) {
+        return { ok: false, error: `认证失败 (HTTP 401)` };
+      }
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err.message };
+    }
+  },
+
+  getFields() {
+    return [
+      { key: 'apiKey', label: 'API Key', type: 'password', required: true, placeholder: 'sk-ant-...' },
+      { key: 'baseUrl', label: 'Base URL', type: 'text', required: false, default: 'https://api.anthropic.com' },
+      { key: 'model', label: '默认模型 (可选)', type: 'text', required: false, placeholder: 'claude-sonnet-4-6' },
+    ];
+  },
+};

package/src/config/codex.js

@@ -0,0 +1,141 @@
+import path from 'path';
+import { HOME, readJsonFile, writeJsonFile, readTextFile, writeTextFile, backupFile, commandExists } from '../utils.js';
+
+const CONFIG_DIR = path.join(HOME, '.codex');
+const AUTH_PATH = path.join(CONFIG_DIR, 'auth.json');
+const CONFIG_TOML_PATH = path.join(CONFIG_DIR, 'config.toml');
+
+/**
+ * 从 Base URL 提取可用作 provider ID 的短名称
+ * 例：https://api.openai.com/v1 → openai-com
+ *     http://127.0.0.1:8080    → localhost
+ */
+function providerIdFromUrl(url) {
+  try {
+    const { hostname } = new URL(url);
+    return hostname.replace(/\./g, '-').replace(/^www-/, '');
+  } catch {
+    return 'custom';
+  }
+}
+
+/**
+ * 在 TOML 内容中设置或替换顶层 key = "value"
+ */
+function setTomlTopLevelKey(content, key, value) {
+  const lines = content.split('\n');
+  const regex = new RegExp(`^${key}\\s*=`);
+  // 布尔值和数字不加引号
+  const formatted = (value === 'true' || value === 'false' || !isNaN(value)) ? value : `"${value}"`;
+  const newLine = `${key} = ${formatted}`;
+
+  for (let i = 0; i < lines.length; i++) {
+    if (regex.test(lines[i])) {
+      lines[i] = newLine;
+      return lines.join('\n');
+    }
+  }
+
+  // 没找到，在第一个 [section] 之前插入
+  let insertIdx = 0;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].startsWith('[')) {
+      insertIdx = i;
+      break;
+    }
+    insertIdx = i + 1;
+  }
+  lines.splice(insertIdx, 0, newLine);
+  return lines.join('\n');
+}
+
+/**
+ * 删除 TOML 中的某个 [section] 块（包含其下所有键值对）
+ */
+function removeTomlSection(content, sectionName) {
+  const lines = content.split('\n');
+  const result = [];
+  let inTargetSection = false;
+
+  for (const line of lines) {
+    // 检测 section 开始
+    if (line.match(/^\[.+\]/)) {
+      inTargetSection = line.trim() === `[${sectionName}]`;
+      if (inTargetSection) continue; // 跳过目标 section header
+    }
+    if (!inTargetSection) {
+      result.push(line);
+    }
+  }
+  return result.join('\n');
+}
+
+export const codex = {
+  id: 'codex',
+  name: 'Codex (OpenAI)',
+  command: 'codex',
+
+  isInstalled() {
+    return commandExists('codex');
+  },
+
+  getConfigPath() {
+    return AUTH_PATH;
+  },
+
+  readConfig() {
+    return readJsonFile(AUTH_PATH);
+  },
+
+  async configure({ apiKey, baseUrl }) {
+    // 1. 写入 auth.json（只写 OPENAI_API_KEY）
+    const backupPath = backupFile(AUTH_PATH);
+    writeJsonFile(AUTH_PATH, {
+      OPENAI_API_KEY: apiKey,
+    });
+
+    // 2. 更新 config.toml（保留用户的 mcp_servers、projects 等）
+    if (baseUrl) {
+      const providerId = providerIdFromUrl(baseUrl);
+      backupFile(CONFIG_TOML_PATH);
+      let toml = readTextFile(CONFIG_TOML_PATH) || '';
+
+      // 设置顶层 key
+      toml = setTomlTopLevelKey(toml, 'model_provider', providerId);
+      toml = setTomlTopLevelKey(toml, 'disable_response_storage', 'true');
+
+      // 移除旧的同名 section（如果存在）
+      toml = removeTomlSection(toml, `model_providers.${providerId}`);
+
+      // 追加新的 provider section
+      const providerSection = `
+[model_providers.${providerId}]
+name = "${providerId}"
+base_url = "${baseUrl}"
+wire_api = "responses"
+requires_openai_auth = true
+`;
+      toml = toml.trimEnd() + '\n' + providerSection;
+
+      writeTextFile(CONFIG_TOML_PATH, toml);
+    }
+
+    return { configPath: AUTH_PATH, backupPath };
+  },
+
+  async testApiKey(apiKey, baseUrl) {
+    const url = baseUrl || 'https://api.openai.com';
+    try {
+      const res = await fetch(`${url}/models`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+        signal: AbortSignal.timeout(15000),
+      });
+      if (res.status === 401) {
+        return { ok: false, error: `认证失败 (HTTP 401)` };
+      }
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err.message };
+    }
+  },
+};

package/src/config/gemini.js

@@ -0,0 +1,87 @@
+import path from 'path';
+import { HOME, readJsonFile, writeJsonFile, readTextFile, writeTextFile, backupFile, commandExists } from '../utils.js';
+
+const CONFIG_DIR = path.join(HOME, '.gemini');
+const ENV_PATH = path.join(CONFIG_DIR, '.env');
+const SETTINGS_PATH = path.join(CONFIG_DIR, 'settings.json');
+
+function parseEnv(content) {
+  const result = {};
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eqIdx = trimmed.indexOf('=');
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    let val = trimmed.slice(eqIdx + 1).trim();
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+      val = val.slice(1, -1);
+    }
+    result[key] = val;
+  }
+  return result;
+}
+
+function serializeEnv(obj) {
+  return Object.entries(obj)
+    .map(([k, v]) => `${k}=${v}`)
+    .join('\n') + '\n';
+}
+
+export const gemini = {
+  id: 'gemini',
+  name: 'Gemini CLI',
+  command: 'gemini',
+
+  isInstalled() {
+    return commandExists('gemini');
+  },
+
+  getConfigPath() {
+    return ENV_PATH;
+  },
+
+  readConfig() {
+    const content = readTextFile(ENV_PATH);
+    return content ? parseEnv(content) : null;
+  },
+
+  async configure({ apiKey, baseUrl }) {
+    // 1. 写入 .env（API Key + Base URL）
+    const existingEnv = readTextFile(ENV_PATH);
+    const backupPath = backupFile(ENV_PATH);
+
+    const env = existingEnv ? parseEnv(existingEnv) : {};
+    if (apiKey) env.GEMINI_API_KEY = apiKey;
+    if (baseUrl) env.GOOGLE_GEMINI_BASE_URL = baseUrl;
+
+    writeTextFile(ENV_PATH, serializeEnv(env));
+
+    // 2. 写入 settings.json（切换认证模式为 api-key）
+    const existingSettings = readJsonFile(SETTINGS_PATH) || {};
+    backupFile(SETTINGS_PATH);
+
+    if (!existingSettings.security) existingSettings.security = {};
+    if (!existingSettings.security.auth) existingSettings.security.auth = {};
+    existingSettings.security.auth.selectedType = 'gemini-api-key';
+
+    writeJsonFile(SETTINGS_PATH, existingSettings);
+
+    return { configPath: ENV_PATH, backupPath };
+  },
+
+  async testApiKey(apiKey, baseUrl) {
+    const url = baseUrl
+      ? `${baseUrl}/v1beta/models?key=${apiKey}`
+      : `https://generativelanguage.googleapis.com/v1beta/models?key=${apiKey}`;
+    try {
+      const res = await fetch(url, { signal: AbortSignal.timeout(15000) });
+      if (res.status === 401) {
+        return { ok: false, error: `认证失败 (HTTP 401)` };
+      }
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err.message };
+    }
+  },
+};

package/src/config/index.js

@@ -0,0 +1,9 @@
+import { claude } from './claude.js';
+import { codex } from './codex.js';
+import { gemini } from './gemini.js';
+import { opencode } from './opencode.js';
+import { openclaw } from './openclaw.js';
+
+export const tools = { claude, codex, gemini, opencode, openclaw };
+
+export const toolList = [claude, codex, gemini, opencode, openclaw];

package/src/config/openclaw.js

@@ -0,0 +1,167 @@
+import path from 'path';
+import { HOME, readJsonFile, writeJsonFile, backupFile, deepMerge, commandExists } from '../utils.js';
+
+const CONFIG_DIR = path.join(HOME, '.openclaw');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'openclaw.json');
+
+// 模型提供商预设（provider ID 在运行时根据 baseUrl 动态生成）
+const PROVIDER_PRESETS = {
+  claude: {
+    providerSuffix: 'claude',
+    api: 'anthropic-messages',
+    model: { id: 'claude-sonnet-4-6', name: 'Claude Sonnet 4.6' },
+    contextWindow: 200000,
+    maxTokens: 65536,
+  },
+  openai: {
+    providerSuffix: 'openai',
+    api: 'openai-completions',
+    model: { id: 'gpt-4o', name: 'GPT-4o' },
+    contextWindow: 128000,
+    maxTokens: 16384,
+  },
+  gemini: {
+    providerSuffix: 'gemini',
+    api: 'openai-completions',
+    model: { id: 'gemini-2.5-pro', name: 'Gemini 2.5 Pro' },
+    contextWindow: 1000000,
+    maxTokens: 65536,
+  },
+};
+
+/**
+ * 从 Base URL 提取 provider ID 前缀
+ */
+function hostFromUrl(url) {
+  try {
+    const { hostname } = new URL(url);
+    return hostname.replace(/\./g, '-').replace(/^www-/, '');
+  } catch {
+    return 'custom';
+  }
+}
+
+export const openclaw = {
+  id: 'openclaw',
+  name: 'OpenClaw',
+  command: 'openclaw',
+  needsModelChoice: true,
+
+  isInstalled() {
+    return commandExists('openclaw');
+  },
+
+  getConfigPath() {
+    return CONFIG_PATH;
+  },
+
+  readConfig() {
+    return readJsonFile(CONFIG_PATH);
+  },
+
+  getModelChoices() {
+    return [
+      { label: 'Claude (Anthropic)', value: 'claude' },
+      { label: 'OpenAI (GPT)', value: 'openai' },
+      { label: 'Gemini (Google)', value: 'gemini' },
+    ];
+  },
+
+  async configure({ apiKey, baseUrl, modelChoice }) {
+    const existing = readJsonFile(CONFIG_PATH) || {};
+    const backupPath = backupFile(CONFIG_PATH);
+
+    const preset = PROVIDER_PRESETS[modelChoice];
+    const host = hostFromUrl(baseUrl);
+    const providerId = `${host}-${preset.providerSuffix}`;
+    const modelRef = `${providerId}/${preset.model.id}`;
+
+    const providerConfig = {
+      [providerId]: {
+        baseUrl: baseUrl,
+        apiKey: apiKey,
+        api: preset.api,
+        models: [
+          {
+            id: preset.model.id,
+            name: preset.model.name,
+            reasoning: false,
+            input: ['text'],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: preset.contextWindow,
+            maxTokens: preset.maxTokens,
+          },
+        ],
+      },
+    };
+
+    const update = {
+      models: {
+        mode: 'merge',
+        providers: providerConfig,
+      },
+      agents: {
+        defaults: {
+          model: {
+            primary: modelRef,
+          },
+          models: {
+            [modelRef]: {},
+          },
+        },
+      },
+    };
+
+    const merged = deepMerge(existing, update);
+    writeJsonFile(CONFIG_PATH, merged);
+
+    return { configPath: CONFIG_PATH, backupPath };
+  },
+
+  async testApiKey(apiKey, baseUrl, modelChoice) {
+    if (modelChoice === 'claude') {
+      return testAnthropic(apiKey, baseUrl);
+    }
+    return testOpenAICompat(apiKey, baseUrl);
+  },
+};
+
+async function testAnthropic(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/v1/messages`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': '2023-06-01',
+      },
+      body: JSON.stringify({
+        model: 'claude-haiku-4-5-20251001',
+        max_tokens: 1,
+        messages: [{ role: 'user', content: 'hi' }],
+      }),
+      signal: AbortSignal.timeout(15000),
+    });
+    if (res.status === 401) {
+      return { ok: false, error: `认证失败 (HTTP 401)` };
+    }
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}
+
+async function testOpenAICompat(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/models`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(15000),
+    });
+    if (res.status === 401) {
+      return { ok: false, error: `认证失败 (HTTP 401)` };
+    }
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}

package/src/config/opencode.js

@@ -0,0 +1,163 @@
+import path from 'path';
+import { HOME, readJsonFile, writeJsonFile, backupFile, deepMerge, commandExists } from '../utils.js';
+
+const CONFIG_DIR = path.join(HOME, '.config', 'opencode');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'opencode.json');
+
+// 模型提供商预设（provider ID 在运行时根据 baseUrl 动态生成）
+const PROVIDER_PRESETS = {
+  claude: {
+    providerSuffix: 'claude',
+    npm: '@ai-sdk/anthropic',
+    namePrefix: 'Custom Claude',
+    model: 'claude-sonnet-4-6',
+    modelName: 'Claude Sonnet 4.6',
+    contextWindow: 200000,
+    maxTokens: 65536,
+  },
+  openai: {
+    providerSuffix: 'openai',
+    npm: '@ai-sdk/openai-compatible',
+    namePrefix: 'Custom OpenAI',
+    model: 'gpt-4o',
+    modelName: 'GPT-4o',
+    contextWindow: 128000,
+    maxTokens: 16384,
+  },
+  gemini: {
+    providerSuffix: 'gemini',
+    npm: '@ai-sdk/openai-compatible',
+    namePrefix: 'Custom Gemini',
+    model: 'gemini-2.5-pro',
+    modelName: 'Gemini 2.5 Pro',
+    contextWindow: 1000000,
+    maxTokens: 65536,
+  },
+};
+
+/**
+ * 从 Base URL 提取 provider ID 前缀
+ */
+function hostFromUrl(url) {
+  try {
+    const { hostname } = new URL(url);
+    return hostname.replace(/\./g, '-').replace(/^www-/, '');
+  } catch {
+    return 'custom';
+  }
+}
+
+export const opencode = {
+  id: 'opencode',
+  name: 'OpenCode',
+  command: 'opencode',
+  needsModelChoice: true,
+
+  isInstalled() {
+    return commandExists('opencode');
+  },
+
+  getConfigPath() {
+    return CONFIG_PATH;
+  },
+
+  readConfig() {
+    return readJsonFile(CONFIG_PATH);
+  },
+
+  getModelChoices() {
+    return [
+      { label: 'Claude (Anthropic)', value: 'claude' },
+      { label: 'OpenAI (GPT)', value: 'openai' },
+      { label: 'Gemini (Google)', value: 'gemini' },
+    ];
+  },
+
+  async configure({ apiKey, baseUrl, modelChoice }) {
+    const existing = readJsonFile(CONFIG_PATH) || {};
+    const backupPath = backupFile(CONFIG_PATH);
+
+    const preset = PROVIDER_PRESETS[modelChoice];
+    const host = hostFromUrl(baseUrl);
+    const providerId = `${host}-${preset.providerSuffix}`;
+    const providerName = `${preset.namePrefix} (${host})`;
+
+    const providerConfig = {
+      [providerId]: {
+        npm: preset.npm,
+        name: providerName,
+        options: {
+          baseURL: baseUrl,
+          apiKey: apiKey,
+        },
+        models: {
+          [preset.model]: {
+            name: preset.modelName,
+            limit: {
+              context: preset.contextWindow,
+              output: preset.maxTokens,
+            },
+          },
+        },
+      },
+    };
+
+    const update = {
+      provider: providerConfig,
+      model: `${providerId}/${preset.model}`,
+    };
+
+    const merged = deepMerge(existing, update);
+    writeJsonFile(CONFIG_PATH, merged);
+
+    return { configPath: CONFIG_PATH, backupPath };
+  },
+
+  async testApiKey(apiKey, baseUrl, modelChoice) {
+    // 根据选择的模型类型用不同的测试方式
+    if (modelChoice === 'claude') {
+      return testAnthropic(apiKey, baseUrl);
+    }
+    return testOpenAICompat(apiKey, baseUrl);
+  },
+};
+
+async function testAnthropic(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/v1/messages`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': apiKey,
+        'anthropic-version': '2023-06-01',
+      },
+      body: JSON.stringify({
+        model: 'claude-haiku-4-5-20251001',
+        max_tokens: 1,
+        messages: [{ role: 'user', content: 'hi' }],
+      }),
+      signal: AbortSignal.timeout(15000),
+    });
+    if (res.status === 401) {
+      return { ok: false, error: `认证失败 (HTTP 401)` };
+    }
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}
+
+async function testOpenAICompat(apiKey, baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/models`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(15000),
+    });
+    if (res.status === 401) {
+      return { ok: false, error: `认证失败 (HTTP 401)` };
+    }
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}

package/src/index.js

@@ -0,0 +1,297 @@
+import { select, password, input } from '@inquirer/prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import os from 'os';
+import { toolList } from './config/index.js';
+import { IS_WIN, getPlatformName } from './utils.js';
+
+// ==================== 默认官方 Base URL ====================
+const DEFAULT_BASE_URLS = {
+  claude: 'https://api.anthropic.com',
+  openai: 'https://api.openai.com/v1',
+  gemini: 'https://generativelanguage.googleapis.com',
+};
+
+const DEFAULT_TOOL_BASE_URLS = {
+  claude:  DEFAULT_BASE_URLS.claude,
+  codex:   DEFAULT_BASE_URLS.openai,
+  gemini:  DEFAULT_BASE_URLS.gemini,
+};
+
+// ==================== 是/否选择（上下箭头） ====================
+async function confirmSelect(message, defaultYes = true) {
+  const choices = defaultYes
+    ? [
+        { name: `${chalk.green('>')} 是`, value: true },
+        { name: `  否`, value: false },
+      ]
+    : [
+        { name: `${chalk.red('>')} 否`, value: false },
+        { name: `  是`, value: true },
+      ];
+  return await select({ message, choices });
+}
+
+// ==================== Banner ====================
+function showBanner() {
+  const line = chalk.gray('  ─────────────────────────────────────────');
+  console.log('');
+  console.log(line);
+  console.log(chalk.cyan.bold('    ___    ____   ________    ____           '));
+  console.log(chalk.cyan.bold('   /   |  /  _/  / ____/ /   / __/___ _      '));
+  console.log(chalk.cyan.bold('  / /| |  / /   / /   / /   / /_/ __ `/      '));
+  console.log(chalk.cyan.bold(' / ___ |_/ /   / /___/ /___/ __/ /_/ /       '));
+  console.log(chalk.cyan.bold('/_/  |_/___/   \\____/_____/_/  \\__, /    '));
+  console.log(chalk.cyan.bold('                               /____/         '));
+  console.log('');
+  console.log(chalk.bold.white('   AI CLI Config') + chalk.gray(' v1.0.0'));
+  console.log(chalk.gray('   快速配置 Claude Code / Codex / Gemini / OpenCode / OpenClaw'));
+  console.log(chalk.gray('   支持自定义 Base URL，兼容任意 API 中转服务'));
+  console.log(line);
+  console.log('');
+}
+
+// ==================== 环境检测 ====================
+async function detectEnvironment() {
+  const spinner = ora({ text: '正在检测环境...', spinner: 'dots12' }).start();
+
+  const platform = getPlatformName();
+  const arch = os.arch();
+  const shell = IS_WIN
+    ? (process.env.ComSpec || 'cmd.exe')
+    : (process.env.SHELL || '/bin/sh');
+
+  const installed = [];
+  for (const tool of toolList) {
+    if (tool.isInstalled()) installed.push(tool);
+  }
+
+  spinner.succeed(chalk.bold('环境检测完成'));
+  console.log('');
+
+  // 系统信息表格
+  const info = [
+    ['平台', `${platform} (${arch})`],
+    ['Node.js', process.version],
+    ['Shell', shell],
+    ['用户目录', os.homedir()],
+  ];
+  for (const [label, value] of info) {
+    console.log(`  ${chalk.gray(label.padEnd(10))} ${chalk.white(value)}`);
+  }
+  console.log('');
+
+  // 已安装工具
+  if (installed.length === 0) {
+    console.log(chalk.red.bold('  未检测到任何已安装的 AI CLI 工具'));
+  } else {
+    console.log(chalk.bold(`  检测到 ${installed.length} 个已安装工具:`));
+    console.log('');
+    for (const tool of installed) {
+      console.log(`    ${chalk.green('●')} ${chalk.white(tool.name)}`);
+    }
+  }
+  console.log('');
+
+  return installed;
+}
+
+// ==================== 选择工具 ====================
+async function selectTool(installed) {
+  return await select({
+    message: '选择要配置的工具',
+    choices: installed.map((tool) => ({
+      name: `  ${tool.name}`,
+      value: tool,
+    })),
+  });
+}
+
+// ==================== 去除末尾斜杠 ====================
+function trimTrailingSlash(url) {
+  return url ? url.replace(/\/+$/, '') : url;
+}
+
+// ==================== 获取默认 Base URL ====================
+function getDefaultBaseUrl(tool, modelChoice) {
+  if (tool.needsModelChoice && modelChoice) {
+    return DEFAULT_BASE_URLS[modelChoice] || DEFAULT_BASE_URLS.openai;
+  }
+  return DEFAULT_TOOL_BASE_URLS[tool.id] || '';
+}
+
+// ==================== 配置单个工具 ====================
+async function configureOneTool(installed) {
+  const tool = await selectTool(installed);
+
+  // 如果需要选模型提供商（OpenCode / OpenClaw）
+  let modelChoice = null;
+  if (tool.needsModelChoice) {
+    console.log('');
+    modelChoice = await select({
+      message: `${tool.name} 要使用哪个模型`,
+      choices: tool.getModelChoices().map((c) => ({
+        name: `  ${c.label}`,
+        value: c.value,
+      })),
+    });
+  }
+
+  // 输入 Base URL（可修改默认值）
+  console.log('');
+  const defaultUrl = getDefaultBaseUrl(tool, modelChoice);
+  const rawBaseUrl = await input({
+    message: 'Base URL（留空使用官方地址，或填入你的中转地址）',
+    default: defaultUrl,
+    validate: (v) => {
+      if (!v) return true; // 允许空（后续使用默认）
+      if (!/^https?:\/\/.+/.test(v)) return '请输入有效的 URL，如 https://api.anthropic.com';
+      return true;
+    },
+  });
+  const baseUrl = trimTrailingSlash(rawBaseUrl || defaultUrl);
+
+  console.log('');
+  console.log(chalk.bold(`  ┌ 配置 ${tool.name}`));
+  if (baseUrl) {
+    console.log(chalk.gray(`  │ Base URL: ${baseUrl}`));
+  }
+  console.log(chalk.gray('  │'));
+
+  // 输入 API Key
+  const apiKey = await password({
+    message: 'API Key',
+    mask: '*',
+    validate: (v) => {
+      if (!v) return 'API Key 不能为空';
+      return true;
+    },
+  });
+
+  if (!apiKey) {
+    console.log(chalk.yellow('  └ 未输入 API Key，已取消'));
+    return false;
+  }
+
+  // 连接测试
+  console.log('');
+  const spinner = ora({ text: '正在测试 API 连接...', spinner: 'dots12' }).start();
+  const testResult = tool.testApiKey
+    ? await tool.testApiKey(apiKey, baseUrl, modelChoice)
+    : { ok: true };
+
+  if (testResult.ok) {
+    spinner.succeed(chalk.green('API 连接测试通过'));
+  } else {
+    spinner.fail(chalk.red(`API 连接测试失败: ${testResult.error}`));
+    console.log('');
+    const proceed = await confirmSelect('连接测试失败，是否仍然写入配置？', false);
+    if (!proceed) {
+      console.log(chalk.yellow('\n  └ 已取消配置\n'));
+      return false;
+    }
+  }
+
+  // 写入配置
+  const writeSpinner = ora({ text: '正在写入配置...', spinner: 'dots12' }).start();
+  try {
+    const result = await tool.configure({ apiKey, baseUrl, modelChoice });
+    writeSpinner.succeed(chalk.green('配置写入成功'));
+    console.log(`    ${chalk.gray('配置文件:')} ${chalk.cyan(result.configPath)}`);
+    if (result.backupPath) {
+      console.log(`    ${chalk.gray('备份文件:')} ${chalk.gray(result.backupPath)}`);
+    }
+  } catch (err) {
+    writeSpinner.fail(chalk.red(`配置写入失败: ${err.message}`));
+    return false;
+  }
+
+  // 自检
+  const checkSpinner = ora({ text: '正在进行自检...', spinner: 'dots12' }).start();
+  try {
+    const config = tool.readConfig();
+    if (config) {
+      checkSpinner.succeed(chalk.green('自检通过，一切正常'));
+    } else {
+      checkSpinner.warn(chalk.yellow('配置文件写入后读取为空，可能存在权限问题'));
+    }
+  } catch {
+    checkSpinner.warn(chalk.yellow('配置文件读取失败'));
+  }
+
+  console.log(chalk.gray('  └ 完成'));
+  return true;
+}
+
+// ==================== 完成展示 ====================
+function showCompletion() {
+  const line = chalk.gray('  ─────────────────────────────────────────');
+  console.log('');
+  console.log(line);
+  console.log('');
+  console.log(chalk.green.bold('   ✅ 全部配置完成！'));
+  console.log('');
+  console.log(chalk.gray('   你的 AI CLI 工具已配置完毕，尽情享用吧！'));
+  console.log('');
+  console.log(line);
+  console.log('');
+}
+
+// ==================== 代理设置 ====================
+async function setupProxy() {
+  const useProxy = await confirmSelect('是否需要设置网络代理？', false);
+  if (!useProxy) return;
+
+  console.log('');
+  const proxyUrl = await input({
+    message: '代理地址',
+    validate: (v) => {
+      if (!v) return '代理地址不能为空';
+      if (!/^https?:\/\/.+/.test(v)) return '请输入有效的代理地址，如 http://127.0.0.1:7890';
+      return true;
+    },
+  });
+
+  try {
+    const { ProxyAgent, setGlobalDispatcher } = await import('undici');
+    setGlobalDispatcher(new ProxyAgent(proxyUrl));
+    console.log(chalk.green(`  代理已设置: ${proxyUrl}`));
+  } catch {
+    // undici 不可用时回退到环境变量
+    process.env.HTTP_PROXY = proxyUrl;
+    process.env.HTTPS_PROXY = proxyUrl;
+    console.log(chalk.green(`  代理已设置 (env): ${proxyUrl}`));
+  }
+  console.log('');
+}
+
+// ==================== 主流程 ====================
+export async function main() {
+  showBanner();
+
+  // 0. 代理设置
+  await setupProxy();
+
+  // 1. 环境检测
+  const installed = await detectEnvironment();
+
+  if (installed.length === 0) {
+    console.log(chalk.red('  请先安装至少一个 AI CLI 工具后再运行本配置工具。'));
+    console.log('');
+    return;
+  }
+
+  // 2. 配置工具（循环，直到用户不想继续）
+  await configureOneTool(installed);
+
+  while (installed.length > 1) {
+    console.log('');
+    const more = await confirmSelect('是否继续配置其他工具？', false);
+    if (!more) break;
+    console.log('');
+    await configureOneTool(installed);
+  }
+
+  // 3. 完成
+  showCompletion();
+}

package/src/utils.js

@@ -0,0 +1,141 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+
+export const HOME = os.homedir();
+export const IS_WIN = process.platform === 'win32';
+export const IS_MAC = process.platform === 'darwin';
+export const IS_LINUX = process.platform === 'linux';
+
+/**
+ * 获取友好的平台名称
+ */
+export function getPlatformName() {
+  if (IS_MAC) return 'macOS';
+  if (IS_WIN) return 'Windows';
+  if (IS_LINUX) return 'Linux';
+  return process.platform;
+}
+
+/**
+ * 安全读取 JSON 文件，不存在则返回 null
+ */
+export function readJsonFile(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 原子写入文件（跨平台兼容）
+ * macOS/Linux: rename 原子操作
+ * Windows: 先删目标再 rename（Windows rename 不覆盖）
+ */
+function atomicWriteFile(filePath, content) {
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const tmpPath = filePath + '.tmp';
+  fs.writeFileSync(tmpPath, content, 'utf-8');
+  if (IS_WIN) {
+    try { fs.unlinkSync(filePath); } catch {}
+  }
+  fs.renameSync(tmpPath, filePath);
+}
+
+/**
+ * 原子写入 JSON 文件
+ */
+export function writeJsonFile(filePath, data) {
+  atomicWriteFile(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+
+/**
+ * 安全读取文本文件
+ */
+export function readTextFile(filePath) {
+  try {
+    return fs.readFileSync(filePath, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 原子写入文本文件
+ */
+export function writeTextFile(filePath, content) {
+  atomicWriteFile(filePath, content);
+}
+
+/**
+ * 备份文件（如果存在）
+ */
+export function backupFile(filePath) {
+  if (fs.existsSync(filePath)) {
+    const backupPath = filePath + '.bak.' + Date.now();
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+  }
+  return null;
+}
+
+/**
+ * 检测命令是否存在（跨平台）
+ * macOS/Linux: which
+ * Windows: where
+ */
+export function commandExists(cmd) {
+  try {
+    const checkCmd = IS_WIN ? `where ${cmd}` : `which ${cmd}`;
+    execSync(checkCmd, { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 测试 URL 连通性
+ */
+export async function testConnection(url, timeout = 10000) {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    const res = await fetch(url, {
+      method: 'HEAD',
+      signal: controller.signal,
+    });
+    clearTimeout(timer);
+    return { ok: true, status: res.status };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}
+
+/**
+ * 深度合并对象（只覆盖指定的 key，不删除已有的 key）
+ */
+export function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    if (
+      source[key] &&
+      typeof source[key] === 'object' &&
+      !Array.isArray(source[key]) &&
+      target[key] &&
+      typeof target[key] === 'object' &&
+      !Array.isArray(target[key])
+    ) {
+      result[key] = deepMerge(target[key], source[key]);
+    } else {
+      result[key] = source[key];
+    }
+  }
+  return result;
+}