00 Page

Claudex 帮助与支持 · Support

更新日期 / Updated: 2026-10-09

开始使用

需要 macOS 15.7 或更新版本、单独安装的 Claude Code，以及允许本应用使用的 ChatGPT 账号。账号资格、模型和支持的推理强度由 OpenAI 返回的信息决定；模型出现并不意味着免费或保证某个订阅额度。

  1. 启动 Claudex，打开 Settings → Account & model。
  2. 点击 Connect ChatGPT，在浏览器完成本应用的授权。不需要选择 auth.json。
  3. 为执行模型选择账号提供的模型及支持的 Effort；需要 Advisor 时，独立配置其 Model 和 Effort。保存配置。
  4. 启动网关。默认地址为 127.0.0.1:4317，仅监听本机回环地址。
  5. 在 Settings → Claude Code 复制连接 exports，粘贴到启动 Claude Code 的终端，再启动 Claude Code。连接 exports 含本地网关令牌，不要公开。

Claude Code 仍负责工具执行和权限确认。支持的模型和工具声明并非覆盖所有 Claude Code 功能；不支持的能力会返回明确错误。没有自动的 API-key 计费后备路径。

常见问题

  • 无法登录或授权过期：在 Account & model 重新连接 ChatGPT，并在浏览器完成授权。不要提供 Codex 凭据文件。
  • 模型配置不可用：刷新账号模型目录，选择账号实际提供的模型及 Effort；过期或失败的目录可能阻止保存或启动。
  • Claude Code 无法连接：确认网关已启动，并在启动 Claude Code 的同一个 shell 中使用当前连接 exports。不要把完整 token 粘贴到公开问题中。
  • 请求失败、耗时较长或能力不支持：在 Activity 查看错误与已测量的延迟。提供错误文字、Claudex 与 Claude Code 版本、macOS 版本及去敏后的复现步骤。重复请求可能再次消耗账号用量。
  • 数据清理：退出登录不会清除所有本地数据。先暂停并退出应用，再通过支持渠道确认实际数据目录；清除回放可能影响工具续接。详见隐私政策。

English — Getting started

Requirements: macOS 15.7 or later, Claude Code installed separately, and a ChatGPT account eligible to authorize Claudex. Eligibility, models and supported reasoning efforts vary by account. Model availability does not establish cost or remaining plan quota.

  1. Open Claudex Settings → Account & model.
  2. Choose Connect ChatGPT and complete app-owned authorization in your browser. Do not select an auth.json file.
  3. Select an advertised executor model and supported Effort, then save. Configure Advisor's Model and Effort independently if using it.
  4. Start the gateway. The default address is 127.0.0.1:4317; it listens only on loopback.
  5. In Settings → Claude Code, copy the connection exports into the shell that launches Claude Code, then launch it. The exports include a local gateway token; keep it private.

Claude Code remains responsible for tools and permission decisions. Some tool types and declarations are unsupported and return explicit errors; complete feature compatibility is not promised. There is no automatic API-key billing fallback.

English — Troubleshooting

  • Sign-in or expired authorization: reconnect in Account & model and finish browser consent. Do not submit Codex credential files.
  • Unavailable route: refresh account models and select an advertised model/effort. Failed or expired catalogs can block saving or starting.
  • Cannot connect: confirm the gateway is running and use the current exports in the shell that launches Claude Code. Do not publish the gateway token.
  • Errors or latency: inspect Activity. Share the error, app/client/macOS versions and redacted reproduction steps. Repeating a request can consume plan usage again.
  • Local cleanup: sign-out does not erase all local files. Pause and quit before removing data, and confirm the storage location through support. Removing replay can disrupt continuation.

联系 / Contact

开发者 GitHub / Developer · Claudex GitHub Issues

不要上传 OAuth 凭据、完整配置、连接 token、完整回放或敏感会话内容。Do not upload credentials, complete configuration, connection tokens, full replay or sensitive conversations.

Claudex · 隐私政策 / Privacy