Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 24 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,37 @@

[中文文档](README.zh-CN.md)

Run OpenAI Codex subscription models inside Claude Code through a private, localhost-only [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) instance.
### Claude Code's shell. GPT-5.6 Sol's brain. One command.

> [!CAUTION]
> Claudex is an unofficial community project. It is not affiliated with, endorsed by, or supported by OpenAI, Anthropic, or the CLIProxyAPI maintainers. Anthropic says it does not support routing Claude Code to non-Claude models through a gateway. OpenAI's general Terms restrict automated extraction and bypassing protective limits, while some plan guidance separately prohibits using ChatGPT to power third-party services. Using this project may put your account at risk. Read [Account and policy risk](#account-and-policy-risk) before installing.

## Quick install
Run OpenAI Codex subscription models inside Claude Code through a private, localhost-only [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) instance—without changing your existing Claude Code or Codex setup.

Prerequisites:
> “If this gets blocked, I owe you a reset.”
>
> — [Tibo, after sharing the original three-step `claudex` recipe](https://x.com/thsottiaux/status/2076119366647894371)

- macOS or Linux on arm64 or x86_64
- [Claude Code](https://code.claude.com/docs/en/installation)
- A ChatGPT account with Codex access
- `curl`, `tar`, and either `shasum` or `sha256sum`
[![Release](https://img.shields.io/github/v/release/liuzhao1225/claudex)](https://github.com/liuzhao1225/claudex/releases/latest)
[![CI](https://github.com/liuzhao1225/claudex/actions/workflows/ci.yml/badge.svg)](https://github.com/liuzhao1225/claudex/actions/workflows/ci.yml)
![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

Run one command:
## Install

```bash
curl -fsSL https://github.com/liuzhao1225/claudex/releases/latest/download/install.sh | bash
```

**Claude Code orchestration · Codex models · localhost-only · reversible install**

> [!CAUTION]
> Claudex is an unofficial community project. Tibo's post is personal commentary—not an OpenAI policy statement, terms exception, endorsement, or account-safety guarantee. Anthropic does not support routing Claude Code to non-Claude models through a gateway. Using this project may put your account at risk; read [Account and policy risk](#account-and-policy-risk) before installing.

### Requirements

- macOS or Linux on arm64 or x86_64
- [Claude Code](https://code.claude.com/docs/en/installation)
- A ChatGPT account with Codex access
- `curl`, `tar`, and either `shasum` or `sha256sum`

The installer downloads a checksum-pinned CLIProxyAPI binary into Claudex's private data directory, creates a localhost-only configuration, opens Codex OAuth, starts the proxy, and verifies that `gpt-5.6-sol` is available. OAuth authorization in the browser still requires your interaction.

Then launch Claude Code with:
Expand All @@ -30,6 +41,8 @@ Then launch Claude Code with:
claudex
```

If Claudex saved you setup time, consider [starring the repository](https://github.com/liuzhao1225/claudex).

Claude Code is required. The installer stops without changing anything if it is missing and prints its official installation link. The Codex CLI is optional because CLIProxyAPI performs its own OAuth flow; when it is missing, Claudex prints the [official Codex installation link](https://github.com/openai/codex) and continues.

## What it changes
Expand Down
33 changes: 23 additions & 10 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,37 @@

[English](README.md)

通过仅监听本机的私有 [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI),在 Claude Code 中使用自己 ChatGPT/Codex 订阅可访问的模型
### Claude Code 的壳,GPT-5.6 Sol 的脑,一条命令

> [!CAUTION]
> Claudex 是非官方社区项目,与 OpenAI、Anthropic 和 CLIProxyAPI 维护者均无隶属或背书关系。Anthropic 当前明确不支持通过 gateway 将 Claude Code 路由到非 Claude 模型;OpenAI 一般条款限制自动化提取和绕过保护限制,部分方案说明还单独禁止用 ChatGPT 为第三方服务提供能力。使用本项目可能带来账号风险,安装前请阅读[账号与条款风险](#账号与条款风险)。
通过仅监听本机的私有 [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI),在 Claude Code 中使用自己 ChatGPT/Codex 订阅可访问的模型,同时不修改现有 Claude Code 或 Codex 配置。

> “If this gets blocked, I owe you a reset.”
>
> — [Tibo 分享最初三步 `claudex` 教程后的原话](https://x.com/thsottiaux/status/2076119366647894371)

[![Release](https://img.shields.io/github/v/release/liuzhao1225/claudex)](https://github.com/liuzhao1225/claudex/releases/latest)
[![CI](https://github.com/liuzhao1225/claudex/actions/workflows/ci.yml/badge.svg)](https://github.com/liuzhao1225/claudex/actions/workflows/ci.yml)
![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)

## 一键安装

前置条件:
```bash
curl -fsSL https://github.com/liuzhao1225/claudex/releases/latest/download/install.sh | bash
```

**Claude Code 编排 · Codex 模型 · 仅本机监听 · 可回退卸载**

> [!CAUTION]
> Claudex 是非官方社区项目。Tibo 的发帖属于个人公开讨论,不代表 OpenAI 政策、条款豁免、官方背书或账号安全承诺。Anthropic 不支持通过 gateway 将 Claude Code 路由到非 Claude 模型。使用本项目可能带来账号风险,安装前请阅读[账号与条款风险](#账号与条款风险)。

### 前置条件

- arm64 或 x86_64 的 macOS/Linux
- [Claude Code](https://code.claude.com/docs/en/installation)
- 可使用 Codex 的 ChatGPT 账号
- `curl`、`tar`、`shasum` 或 `sha256sum`

执行:

```bash
curl -fsSL https://github.com/liuzhao1225/claudex/releases/latest/download/install.sh | bash
```

安装器会下载并校验锁定版本的 CLIProxyAPI,创建仅监听 `127.0.0.1` 的私有配置,打开 Codex OAuth,启动代理并确认 `gpt-5.6-sol` 可用。浏览器里的 OAuth 授权仍需本人完成。

安装完成后运行:
Expand All @@ -30,6 +41,8 @@ curl -fsSL https://github.com/liuzhao1225/claudex/releases/latest/download/insta
claudex
```

如果 Claudex 帮你省下了配置时间,欢迎给[仓库点一个 Star](https://github.com/liuzhao1225/claudex)。

如果没有 Claude Code,安装器会在写入任何文件之前停止并显示官方安装链接。Codex CLI 不是 CPA OAuth 的硬依赖;缺失时安装器会给出[官方 Codex 安装链接](https://github.com/openai/codex)并继续。

## 隔离边界
Expand Down