npm package: @koi.codes/koi-installer
Description: 一键安装 Claude Code 和 Codex 的自动化脚本 | Automated installer for Claude Code and Codex
Author: koi.codes
Latest version: 1.0.4

# Koi.codes 一键安装工具

自动化安装和配置 Claude Code 和 Codex 的便捷工具。

## 特性

- 🚀 一键安装 Claude Code 或 Codex
- 🔧 自动配置环境变量
- 💻 支持 Windows、macOS 和 Linux
- ✨ 交互式配置向导
- 📦 无需手动创建配置文件
- 🌐 **智能多语言支持** - 自动检测系统语言（中文/英文）

## 快速开始

### 方法一: 使用 npx (推荐)

无需安装,直接运行:

```bash
# macOS / Linux / Windows CMD / Git Bash
npx @koi.codes/koi-installer

# Windows PowerShell (需要引号!)
npx "@koi.codes/koi-installer"
```

> **⚠️ Windows PowerShell 用户注意**: 由于 `@` 是 PowerShell 特殊字符,包名必须用引号包裹!

### 方法二: 使用 pnpm

```bash
# macOS / Linux / Windows CMD
pnpm dlx @koi.codes/koi-installer

# Windows PowerShell
pnpm dlx "@koi.codes/koi-installer"
```

### 方法三: 全局安装

```bash
npm install -g @koi.codes/koi-installer
koi-installer
```

## 使用步骤

1. 运行安装命令
2. 选择要安装的工具 (Claude Code / Codex / 两者都安装)
3. 输入您的 API Token
4. 等待自动安装和配置完成

## 支持的平台

| 平台 | 状态 |
|------|------|
| Windows 10/11 | ✅ |
| macOS | ✅ |
| Linux (Ubuntu/Debian/Fedora/Arch) | ✅ |

## 前置要求

- Node.js >= 14.0.0
- npm 或 pnpm

如果未安装 Node.js,请访问: https://nodejs.org

## 安装内容

### Claude Code

安装后会自动配置:
- `ANTHROPIC_BASE_URL=https://koicode.xyz/api`
- `ANTHROPIC_AUTH_TOKEN=您的Token`

使用:
```bash
claude
```

### Codex

安装后会自动配置:
- `~/.codex/auth.json`
- `~/.codex/config.toml`
- `KOI_OPENAI_TOKEN=您的Token`

使用:
```bash
codex
```

## 手动配置 (可选)

如果自动安装失败,您可以参考以下手动配置方法:

### Windows

```powershell
# Claude Code
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://koicode.xyz/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "Your Token", [System.EnvironmentVariableTarget]::User)

# Codex
[System.Environment]::SetEnvironmentVariable("KOI_OPENAI_TOKEN", "Your Token", [System.EnvironmentVariableTarget]::User)
```

### macOS/Linux

```bash
# Claude Code
echo 'export ANTHROPIC_BASE_URL="https://koicode.xyz/api"' >> ~/.zshrc  # macOS
echo 'export ANTHROPIC_AUTH_TOKEN="Your Token"' >> ~/.zshrc
source ~/.zshrc

# Codex
echo 'export KOI_OPENAI_TOKEN="Your Token"' >> ~/.zshrc
source ~/.zshrc
```

## 故障排除

### 权限错误

**Windows**: 以管理员身份运行 PowerShell

**macOS/Linux**: 使用 `sudo` 运行安装命令

### 环境变量未生效

- **Windows**: 重启终端
- **macOS/Linux**: 运行 `source ~/.zshrc` 或 `source ~/.bashrc`

### npm 全局安装失败

尝试使用 npx 方式:
```bash
npx @koi.codes/koi-installer
```

## 更新

```bash
npm update -g @koi.codes/koi-installer
```

## 卸载

### 自动卸载 (推荐)

使用我们提供的自动卸载工具,会自动清理所有配置:

```bash
# 使用 npx (无需安装)
npx @koi.codes/koi-installer uninstall

# 或使用全局命令
koi-uninstall
```

功能:
- ✅ 自动卸载 Claude Code 或 Codex
- ✅ 自动清理环境变量
- ✅ 自动删除配置文件
- ✅ 交互式选择要卸载的项目

### 手动卸载

如果需要手动卸载:

```bash
# 卸载安装器
npm uninstall -g @koi.codes/koi-installer

# 卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code

# 卸载 Codex
npm uninstall -g @openai/codex
```

手动清理环境变量:

**Windows PowerShell**:
```powershell
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[System.Environment]::SetEnvironmentVariable("KOI_OPENAI_TOKEN", $null, "User")
```

**macOS/Linux**:
编辑 `~/.zshrc` 或 `~/.bashrc`,删除 Koi.codes 相关配置行

## 获取 API Token

访问 https://koicode.xyz 获取您的 API Token

## 支持

- 官网: https://koicode.xyz
- 问题反馈: [GitHub Issues](https://github.com/your-repo/koi-installer/issues)

## 许可证

MIT License

---

Made with ❤️ by koi.codes