1.0.0

88-auto-config

🚀 自动配置 Claude Code、Codex、Droid 及其 VSCode 插件的 CLI 工具

✨ 特性

• 🎯 交互式菜单 - 直接运行显示友好菜单，无需记忆命令
• 🔍 自动环境检测 - 检测系统环境、工具安装、网络连接
• ✅ Claude Code 自动配置 - 配置 Claude Code CLI 客户端
• ✅ Codex 自动配置 - 配置 Codex 客户端（auth.json + config.toml）
• ✅ Droid 自动配置 - 配置 Droid 自定义模型
• ✅ VSCode Claude 插件配置 - 自动配置 VSCode Claude 插件
• ✅ VSCode Codex 插件配置 - 自动配置 VSCode ChatGPT 扩展
• ⚡ 批量配置 - 一键配置多个工具
• 🎨 自定义选择 - 多选配置所需工具
• 🔒 智能备份 - 首次配置自动创建 .bak 备份文件
• 🔄 配置续写 - 保留原有配置，仅更新必要字段
• 🌐 跨平台支持 - Windows / macOS / Linux
• 📦 npm 一键安装 - 全局安装后命令行直接使用
• 🔗 多命令别名 - 支持 88config、88code-auto-config、88-auto-config

📦 安装

全局安装（推荐）

npm install -g 88-auto-config

安装后可使用以下任意命令启动：

88config              # 简短命令（推荐）
88code-auto-config    # 完整命令名
88-auto-config        # 包名命令

💡 提示：npm 会自动将命令添加到系统 PATH，无需手动配置环境变量！

本地开发

git clone <repository-url>
cd 88-auto-config
npm install
npm run build
npm link

🚀 使用方法

💡 交互式菜单（推荐）

直接运行命令进入交互式菜单，无需记忆子命令：

88config
# 或
88code-auto-config
# 或
88-auto-config

菜单功能包括：

• ✅ 系统环境检查 - 自动检测 Node.js、npm 版本
• ✅ 工具安装检查 - 检测 Claude Code、Codex 是否已安装
• ✅ 网络连接测试 - 测试 API 连接延迟
• ✅ 数字选择菜单 - 输入数字选择对应功能
• ✅ 循环菜单 - 完成配置后可继续选择其他功能

交互式菜单选项：

• [1] 配置 Claude Code
• [2] 配置 Codex
• [3] 配置 Claude Code + Codex（批量配置）
• [4] 自定义选择（多选）
• [5] 配置 Droid 自定义模型
• [8] 检测配置是否生效
• [9] 配置 VS Code Claude 插件
• [0] 退出

---

📝 命令行方式（自动化脚本）

如果需要在脚本中使用或快速配置，可以直接使用子命令：

配置 Claude Code

88-auto-config claude

交互式输入：

• API Key
• Base URL（默认：https://www.88code.org/api）

配置文件：~/.claude/settings.json

配置 Codex

88-auto-config codex

交互式输入：

• API Key
• Base URL（默认：https://88code.org/openai/v1）

配置文件：

• ~/.codex/auth.json
• ~/.codex/config.toml

重要：需要手动设置环境变量 key88

Windows:

setx key88 "your-api-key"

macOS/Linux:

export key88="your-api-key"
# 添加到 ~/.bashrc 或 ~/.zshrc 以永久生效
echo 'export key88="your-api-key"' >> ~/.zshrc

配置 Droid

88-auto-config droid

交互式输入：

• 模型显示名称
• 模型 ID
• Base URL
• API Key
• Provider（anthropic/openai/google/other）

配置文件：~/.factory/config.json

配置 VSCode Claude 插件

88-auto-config vscode-claude

交互式输入：

• API Key（默认：key）

配置文件：~/.claude/config.json

前提：需要先配置 Claude Code 客户端

配置 VSCode Codex 插件

88-auto-config vscode-codex

交互式输入：

• API Key（用于环境变量 key88）
• Base URL（默认：https://88code.org/openai/v1）

配置文件：VSCode settings.json

• Windows: %APPDATA%\Code\User\settings.json
• macOS: ~/Library/Application Support/Code/User/settings.json
• Linux: ~/.config/Code/User/settings.json

重要：需要手动设置环境变量 key88

查看配置路径

88-auto-config paths

显示所有配置文件的路径信息。

📁 配置文件结构

Claude Code - settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://www.88code.org/api",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

Codex - auth.json

{
  "OPENAI_API_KEY": "your-api-key"
}

Codex - config.toml

model_provider = "88code"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.88code]
name = "88code"
base_url = "https://www.88code.org/openai/v1"
wire_api = "responses"
env_key = "key88"
requires_openai_auth = true

Droid - config.json

{
  "custom_models": [
    {
      "model_display_name": "Sonnet 4.5 [88code]",
      "model": "claude-sonnet-4-5-20250929",
      "base_url": "https://www.88code.org/droid",
      "api_key": "your-api-key",
      "provider": "anthropic"
    }
  ]
}

🔒 备份机制

工具会在首次配置时自动创建配置文件的备份（.bak 文件）：

• settings.json.bak
• auth.json.bak
• config.toml.bak
• 等等

如果备份文件已存在，不会覆盖，确保您的原始配置安全。

🔄 配置续写

工具采用智能配置续写策略：

1. 读取现有配置文件
2. 提取所有未知字段（保持原有顺序）
3. 仅更新必要的字段
4. 保留其他所有配置

不会破坏您的原有配置！

🛠️ 开发

构建

npm run build

开发模式

npm run dev

测试

npm run test
# 或
node dist/cli.js <command>

📄 许可证

MIT

🙏 致谢

基于 88code-desktop 项目的配置逻辑开发。

---

© 2025 88code.org