# CodexZH

> CodexZH 帮开发者把 Codex 接进自己的开发环境：一个 API Key 即可在 Codex CLI、VS Code、Cursor、Trae、Claude Code 等客户端中使用 GPT / Codex 模型，提供固定周期套餐（含周限额度与请求速率限制）、接入指南、用量与计费可视化及调用审计。

- 目标用户：在 Codex CLI、VS Code、Cursor 等客户端中使用 GPT / Codex 模型的个人开发者与团队，以及需要清晰额度边界、用量统计与调用审计的开发团队。
- 接入地址：Codex 客户端使用 `https://api.codexzh.com/v1`，Claude Code 使用 `https://api.codexzh.com`。
- 详细操作教程以文档站 https://docs.codexzh.com/codex/ 为准（中文，随客户端版本实时更新）。
- CodexZH 与按量计费的 Claude Code 服务 ccodezh.com 是独立产品，账号与额度不互通。
- 本服务并非在所有国家或地区提供。

## 核心页面

- [首页](https://codexzh.com/): 产品总览，说明 Codex 接入场景、支持的客户端、套餐边界与服务承诺
- [定价](https://codexzh.com/pricing): 日卡（按天）与 30 天月卡均为固定价；月卡按周限额度使用、每周一重置，另列总额度、有效期与请求速率限制
- [模型](https://codexzh.com/models): 支持的模型、Token 价格、上下文与推理深度
- [接入指南](https://codexzh.com/docs/getting-started): 三步完成接入；按 Codex CLI、VS Code / Cursor / Trae、Codex App、OpenCode、Claude Code、OpenClaw 选择教程；一键脚本、CC-Switch、手动 config.toml 三种配置方式
- [常见问题](https://codexzh.com/faq): 套餐限制、额度刷新、支付、配置错误排查，以及 CodexZH 与 ccodezh 的区别

## 排障与指南

- [排障与指南索引](https://codexzh.com/docs/troubleshooting): Codex 常见报错排查与使用技巧，随客户端版本持续更新
- [报错排查：stream disconnected before completion](https://codexzh.com/docs/troubleshooting/stream-disconnected): 思考超时、上下文过长、网络代理等原因，以及 config.toml 中 stream_max_retries、stream_idle_timeout_ms 等重试与超时参数
- [恢复丢失的 Codex 对话](https://codexzh.com/docs/troubleshooting/resume-conversation): model_provider 名称变化导致会话分组隔离的原因、统一 provider 名称、codex resume 用法与会话保存位置
- [Codex 模型与推理深度怎么选](https://codexzh.com/docs/guides/model-selection): gpt-5.6-terra / gpt-5.6-sol / gpt-6-astra / gpt-5.6-luna / Grok 的适用场景，low、medium、high、xhigh 推理深度的区别与切换
- [用 Codex 生成图片](https://codexzh.com/docs/guides/image-generation): gpt-image-2 / gpt-image-2.5 文生图与改图，安装 codexzh-image 技能、放开沙盒联网与按次计费说明

## 文档站（详细教程）

- [购买套餐](https://docs.codexzh.com/codex/activate)
- [安装与环境检查](https://docs.codexzh.com/codex/install)
- [配置接入并启动](https://docs.codexzh.com/codex/getting-started)
- [一键脚本](https://docs.codexzh.com/codex/setup-script)
- [CC-Switch](https://docs.codexzh.com/codex/cc-switch)
- [手动配置 config.toml](https://docs.codexzh.com/codex/setup)
- [Codex CLI](https://docs.codexzh.com/codex/cli)
- [VS Code / Cursor / Trae](https://docs.codexzh.com/codex/vscode)
- [Claude Code 客户端](https://docs.codexzh.com/codex/claude-code-integration)
- [错误排查指南](https://docs.codexzh.com/codex/troubleshooting)
- [CodexZH 与 ccodezh 怎么选](https://docs.codexzh.com/choose)

## English

- [Home](https://codexzh.com/en): Product overview in English
- [Pricing](https://codexzh.com/en/pricing): Day pass and 30-day monthly plans with weekly quota
- [Models](https://codexzh.com/en/models): Supported models, token pricing and reasoning effort
- [Setup guide](https://codexzh.com/en/docs/getting-started): Connect Codex CLI, VS Code, Cursor and Claude Code
- [FAQ](https://codexzh.com/en/faq): Plans, quota resets, payment and configuration issues
- [Guides & troubleshooting](https://codexzh.com/en/docs/troubleshooting): Common Codex errors and usage tips

## Optional

- [控制台](https://codexzh.com/console): 需要登录；管理 API Key、查看当前套餐与配额
- [用量统计](https://codexzh.com/usage): 需要登录；按模型拆分的调用次数、Token 消耗、费用估算与按天统计
- [法律与合规总览](https://codexzh.com/legal): 隐私、条款与 Cookie 的简版说明
- [隐私政策](https://codexzh.com/privacy)
- [服务条款](https://codexzh.com/terms)
- [Cookie 政策](https://codexzh.com/cookies)
- [数据安全说明](https://codexzh.com/data-security): 第三方模型服务、必要日志、境外模型提示和子处理方说明
- [安全事件反馈](https://codexzh.com/security-incident)