CLI 命令参考

全局用法

claudex [COMMAND]

不带命令运行时，如果已配置 profile 则启动 TUI 仪表盘，否则显示欢迎信息。

命令

`run`

使用指定的提供商 profile 运行 Claude Code。

claudex run <PROFILE> [PROMPT] [-m MODEL] [--print] [--dangerously-skip-permissions] [ARGS...]

参数	说明
`PROFILE`	Profile 名称，或 `auto` 启用智能路由
`PROMPT`	可选的 prompt，用于非交互（一次性）执行
`-m, --model MODEL`	临时覆盖默认模型
`--print`	输出响应后退出（非交互模式）
`--dangerously-skip-permissions`	跳过所有权限提示（配合 `--print` 用于 CI/CD）
`ARGS...`	传递给 `claude` 的额外参数

# 使用 Grok（交互模式）
claudex run grok

# 指定模型
claudex run grok -m grok-3-mini-beta

# 智能路由
claudex run auto

# 非交互一次性执行
claudex run grok "Explain this codebase" --print

# CI/CD 流水线用法（无提示、无权限确认）
claudex run grok "Fix lint errors" --print --dangerously-skip-permissions

# 传递额外参数给 claude
claudex run grok -- --verbose

`profile`

管理提供商 profile。

`profile list`

claudex profile list

列出所有已配置的 profile 及其状态。

`profile add`

claudex profile add

交互式向导，引导完成提供商选择、API 密钥输入（支持 keyring 存储）、模型选择和连通性测试。

`profile show`

claudex profile show <NAME>

显示指定 profile 的详细信息。

`profile remove`

claudex profile remove <NAME>

从配置中移除 profile。

`profile test`

claudex profile test <NAME|all>

测试指定 profile 或所有 profile 的连通性。

`auth`

管理提供商 OAuth 订阅认证。

`auth login`

claudex auth login <PROVIDER>

使用 OAuth 登录指定提供商。支持的提供商：claude、openai、google、qwen、kimi、github。

OpenAI 从 Codex CLI 配置（~/.codex/auth.json）读取 token。Claude 从 ~/.claude 读取。其他提供商使用本地回调服务器或设备码流程。

# 登录 OpenAI（从 Codex CLI 读取）
claudex auth login openai

# 登录 Claude（从 ~/.claude 读取）
claudex auth login claude

# 登录 Google
claudex auth login google

`auth status`

claudex auth status [PROVIDER]

显示当前认证状态。不指定提供商时，显示所有已配置 OAuth profile 的状态。

# 检查所有 OAuth profile
claudex auth status

# 检查特定提供商
claudex auth status openai

`auth refresh`

claudex auth refresh <PROVIDER>

手动刷新指定提供商的 OAuth token。token 过期时代理也会自动刷新。

`auth logout`

claudex auth logout <PROVIDER>

移除指定提供商的已存储 OAuth token。

`proxy`

管理翻译代理服务器。

`proxy start`

claudex proxy start [-p PORT] [-d]

参数	说明
`-p, --port PORT`	覆盖代理端口（默认：配置文件中的值）
`-d, --daemon`	以后台守护进程运行

`proxy stop`

claudex proxy stop

停止代理守护进程（发送 SIGTERM）。

`proxy status`

claudex proxy status

显示代理是否运行及监听端口。

`dashboard`

claudex dashboard

启动 TUI 仪表盘，实时监控和快速启动。

`config`

claudex config [--init]

参数	说明
`--init`	在当前目录创建新配置文件

不带 --init 时，显示已加载的配置文件路径和搜索顺序。

`update`

claudex update [--check]

参数	说明
`--check`	仅检查更新，不安装

不带 --check 时，下载并安装最新版本。