← 返回博客
使用指南

一条命令，把 Claude 与 Codex 请进你的项目目录：Clidex 上手实录

不是 API 中转，而是原生 CLI：从安装、配对到 cd 进项目直接敲 clidex，再到同步本机配置、Max 档位、自动换号与托盘余额，一次走完 Clidex 的完整使用路径。

Clidex Team
一条命令，把 Claude 与 Codex 请进你的项目目录：Clidex 上手实录

前面几篇文章，我们一直在展示“用 Clidex 做出了什么”。这一篇换个角度，回到工具本身：Clidex 到底是什么，装好以后每天是怎么用的，哪些细节会让日常编码更顺手。

文中的命令输出，来自我在本机安装 Clidex 后的实际运行。

Clidex 是什么

用一句话说：在本地终端里使用 Claude 与 Codex，当前项目目录自动成为工作区。

它和常见的“API 中转”不太一样。按照文档的说明，Clidex 客户端使用官方订阅账号启动交互式终端（Pty），你看到的就是原生的 Claude Code / Codex CLI，而不是一个模拟客户端的网关。这带来两个直接的好处：

  • 模型来自官方 CLI 下发，不需要猜测“这是不是真的那个模型”。
  • 请求由原生 CLI 发出，没有反代模拟客户端指纹的问题。

三步开始

1. 安装

macOS、Linux 和 WSL 一行命令：

curl -fsSL https://clidex.dev/install.sh | bash

Windows 的 PowerShell 与 CMD 命令见安装指南。

2. 配对账号（只做一次）

登录控制台，在「CLI 接入」里复制配对命令：

clidex init https://api.clidex.dev <YOUR_TOKEN>

看到“配对成功”就完成了。令牌会当场校验，所以不必担心复制错了要等到开会话才发现。

3. cd 进项目，直接敲 clidex

cd ~/code/my-project
clidex

不带子命令时等价于 clidex connect，工作区默认就是当前目录，不需要再手动传 -w。首次进入某个项目会让你选择 Claude 还是 Codex，并可以“记住此项目的选择”，之后每次都直接进入。

想临时换一个：

clidex --claude          # 仅本次使用 Claude
clidex --codex           # 仅本次使用 Codex
clidex --choose-agent    # 重新选择并调整是否记住

选择按目录分别保存在本机 ~/.config/clidex/projects/，不会往你的项目里写任何文件。

我装好之后先跑了什么

安装完成后，我没有马上开会话，而是先把客户端的几条“只读”命令都看了一遍。

$ clidex version
clidex version 0.1.6 (commit: d795bbb, built at: 2026-10-15T09:32:27Z, by: goreleaser)
更新检查: 10-18 10:00 已是最新
$ clidex status
账号      <你的用户名>
令牌      default
计费      按量付费 (从余额扣)
账户余额  $<当前余额>
令牌额度  不限额

clidex status 一眼就能看到计费方式和余额；加上 --json 还可以交给脚本或监控消费。

clidex --help 的命令列表很短，几乎都能一次记住：

命令 用途
clidex / clidex connect 开启交互式 AI 结对编程终端
clidex init 一次性配对账号
clidex max 只分配 Max 订阅账号
clidex status 查看余额与计费方式
clidex tray 在系统托盘常驻显示余额
clidex update 检查并升级到最新版本

几个让日常更顺手的细节

把你调好的配置一起带上

用惯了的 CLAUDE.md、skills、commands、AGENTS.md 和历史会话，不需要在新环境里重新配置：

clidex --load          # 同步 Claude 配置与当前目录的历史会话
clidex --load codex    # 同步 Codex 配置与当前目录的历史会话

它会先扫描并列出跳过了什么，再弹出勾选列表，你决定上传哪些。之后在同一个目录里开会话，用 /resume 就能接着之前的对话继续聊。

几条边界也值得知道：env、hooks、permissions、MCP、插件和记忆不会被同步，因为它们可能把会话指向别的地址，或者执行本机专属的命令。

额度吃紧时，自动换号并续接

当前账号的凭证用量接近阈值时，终端会提示正在切换账号，并自动向平台重新申请会话、续接之前的上下文，不用重新描述需求。最多自动重连 3 次，仍然失败会给出明确提示，让你手动重新执行 clidex connect。

需要更强的账号时：clidex max

clidex max             # 使用项目已记住的 Agent
clidex --claude max    # Claude Max
clidex --codex max     # ChatGPT Pro / Pro Lite

余额达到平台门槛即可使用。如果暂时没有可用的 Max 账号，会话会照常打开并降级分配普通账号，同时在终端里明确提示，而不是让你开不了工。

托盘里的余额

默认会在菜单栏或通知区域挂一枚余额图标，余额低于阈值（默认 $5）转黄，低于其五分之一转红。写代码写得入神时，它是最不打扰的提醒。不需要的话加 --no-tray 即可。

更新基本不用管

客户端会在后台检查新版本，会话跑着时静默下载，结束后提示一句，下次启动就是新版。想只提示不替换，设置环境变量 CLIDEX_AUTO_UPDATE=0。

费用怎么算

Clidex 按量付费，逐 Token 计费，无月费。站点定价页给出的说法是整体比官方价格便宜 90% 左右，各模型的具体费率以定价页实时展示为准。

适合谁

  • 习惯在终端里工作，不想在网页和编辑器之间来回切换的人。
  • 想要原生 Claude / Codex 体验，又希望用多少付多少的人。
  • 经常被单账号速率限制打断的重度使用者。

现在就试试

curl -fsSL https://clidex.dev/install.sh | bash
clidex init https://api.clidex.dev <YOUR_TOKEN>
cd your-project && clidex

完整参数与机制见文档。如果你用 Clidex 做出了有意思的东西，欢迎发给我们，下一篇案例也许就是它。

继续阅读