# 9527code AI CLI 一键配置工具

> 一键完成 Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw 的 API Key 与代理配置

[![npm version](https://img.shields.io/npm/v/9527code-ai)](https://www.npmjs.com/package/9527code-ai)
[![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)

---

## 简介

`9527code-ai` 是专为 **[9527code.com](https://9527code.com)** 用户设计的 AI CLI 配置工具。只需运行一条命令，即可将你的 9527code API Key 和中转地址写入 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具的配置文件，无需手动编辑任何文件。

**9527code.com** 提供国内可直连的 Anthropic / OpenAI / Gemini 中转 API 服务，注册即可使用。

---

## 支持的工具

| 工具 | 说明 |
|------|------|
| **Claude Code** | Anthropic 官方 CLI，支持全模型 |
| **Codex** | OpenAI Codex CLI |
| **Gemini CLI** | Google Gemini 命令行工具 |
| **OpenCode** | 开源 AI 编程助手（多模型） |
| **OpenClaw** | 开源 AI 编程助手（多模型） |

---

## 前置要求

- **Node.js** >= 18.0.0（[下载](https://nodejs.org)）
- 至少安装了上述一个 AI CLI 工具
- 一个 **9527code.com** 账号及 API Key（[注册地址](https://9527code.com)）

---

## 安装与使用

### 方式一：直接运行（推荐，无需安装）

```bash
npx 9527code-ai
```

### 方式二：全局安装后运行

```bash
npm install -g 9527code-ai
9527code
```

---

## 使用流程

```
运行 npx 9527code-ai
      │
      ▼
 [可选] 设置网络代理
      │
      ▼
 自动检测已安装的 AI CLI 工具
      │
      ▼
 选择要配置的工具（Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw）
      │
      ▼
 [OpenCode/OpenClaw] 选择模型类型（Claude / OpenAI / Gemini）
      │
      ▼
 输入 9527code API Key（已预设 Base URL 为 9527code.com）
      │
      ▼
 自动测试 API 连接
      │
      ▼
 写入配置文件（自动备份原配置）
      │
      ▼
 自检确认配置生效 ✅
```

---

## 获取 9527code API Key

1. 访问 [https://9527code.com](https://9527code.com) 注册账号
2. 登录后进入「API 管理」页面，创建一个 API Key
3. 复制 Key
4. 运行本工具，粘贴 Key 即可

**QQ 群（获取帮助/最新优惠）：** `1093277927`

---

## 各工具配置说明

### Claude Code

写入 `~/.claude/settings.json`，设置以下环境变量：

```json
{
  "env": {
    "ANTHROPIC_API_KEY": "你的 Key",
    "ANTHROPIC_BASE_URL": "https://9527code.com"
  }
}
```

### Codex (OpenAI)

- `~/.codex/auth.json` → `OPENAI_API_KEY`
- `~/.codex/config.toml` → 添加 9527code provider 段落

### Gemini CLI

写入 `~/.gemini/.env`：

```
GEMINI_API_KEY=你的 Key
GOOGLE_GEMINI_BASE_URL=https://9527code.com
```

### OpenCode

写入 `~/.config/opencode/opencode.json`，配置 9527code provider 及默认模型。

### OpenClaw

写入 `~/.openclaw/openclaw.json`，配置 9527code provider 及默认模型。

---

## 配置备份

工具在每次写入前会自动备份原配置文件，备份文件名格式为：

```
原文件名.bak.{timestamp}
```

---

## 常见问题

**Q: 运行后提示"未检测到任何已安装的 AI CLI 工具"？**

请先安装至少一个 AI CLI 工具，例如 Claude Code：

```bash
npm install -g @anthropic-ai/claude-code
```

---

**Q: API 连接测试失败？**

- 检查 API Key 是否正确
- 检查网络是否能访问 9527code.com（可尝试设置代理）
- 测试失败后仍可选择"继续写入配置"

---

**Q: 如何手动验证配置是否生效？**

以 Claude Code 为例：

```bash
cat ~/.claude/settings.json
```

查看 `env.ANTHROPIC_API_KEY` 和 `env.ANTHROPIC_BASE_URL` 是否正确写入。

---

## 项目结构

```
9527code-ai/
├── 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
```

---

## 自定义 / 二次开发

本仓库的 `main` 分支为**通用版本**，支持手动输入任意 Base URL，适合有自己中转服务的开发者使用。

本分支（`9527code-edition`）为 9527code.com 专属版，Base URL 已预设，开箱即用。

---

## License

MIT © 9527code