RayBytes GitHub avatar

ChatMock

Python
Codex 兼容 API 服务RayBytes最近推送 2026年11月4日
模型推理与部署MIT1,56721312 issues7 天 +1

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

把 ChatGPT 账号变成 OpenAI/Ollama 兼容的本地 API 服务。

ChatMock 是一个 Python 写的本地服务,用你的 ChatGPT 账号登录后,对外提供 OpenAI 兼容和 Ollama 兼容的接口。它由 Codex 驱动,让 Codex 能在你常用的聊天应用和编程工具里工作。项目与 OpenAI 官方无关。

推荐指数

4.0

想让现有工具免改代码接入 ChatGPT 账号的开发者,值得一试。

近 7 天

+1

新增 Star

总 Star 排名

#2660

雷达追踪的 3,958 个 AI 仓库中

创建于

2025

2025年8月15日

核心亮点

  • 1双协议兼容

    同时提供 OpenAI 风格 /v1 接口和 Ollama 接口。

  • 2账号登录

    用 ChatGPT 账号登录,自动发现账号可用的模型。

  • 3功能较全

    支持工具调用、JSON 结构化输出、图片输入和思考摘要。

  • 4安装方式多

    支持 Homebrew、pipx/pip 和 Docker 安装。

  • 5可调推理

    推理强度、摘要详细度、快速模式等都能配置。

适用场景

  • 给现有客户端接模型

    例如:在 Raycast 的 Ollama 设置里填 127.0.0.1:8000,同步模型后直接聊天。

  • 接入编程工具

    例如:在 Terax 里添加 OpenAI 兼容提供方,地址填 http://127.0.0.1:8000/v1。

  • 本地开发调试

    例如:代码里把 base_url 指向本地服务,用 OpenAI SDK 调用。

它是怎么工作的

  1. 第 1 步

    登录账号

    运行 chatmock login 完成 ChatGPT 账号授权,无界面服务器加 --headless。

  2. 第 2 步

    启动服务

    运行 chatmock serve,默认监听 127.0.0.1:8000。

  3. 第 3 步

    发现模型

    从账号目录拉取可用模型,默认每小时刷新一次。

  4. 第 4 步

    转发请求

    客户端按 OpenAI 或 Ollama 格式发请求,服务转给 Codex 处理并返回。

快速上手

  1. 1

    安装

    用 Homebrew 或 pipx 安装。

    brew install chatmock
  2. 2

    登录

    用 ChatGPT 账号授权。

    chatmock login
  3. 3

    启动

    启动本地服务。

    chatmock serve
  4. 4

    配置客户端

    把 base URL 设为 http://127.0.0.1:8000/v1。

适合谁

  • 已有 ChatGPT 账号的开发者
  • 想把 ChatGPT 接进现有 OpenAI/Ollama 客户端的用户
  • 需要本地统一接口做调试的人

不太适合

  • 没有 ChatGPT 账号的用户
  • 需要生产级稳定服务的团队

成熟度

  • 活跃度2025 年创建,最近一次推送在 2026 年 11 月,仍在维护。
  • 文档README 覆盖安装、配置表和多个集成示例。
  • 社区约 1.5k star、214 fork,issue 仅 12 个,规模中等。
  • 上手难度三条命令即可跑起来,但需先完成账号登录。

使用前注意

  • · 依赖 ChatGPT 账号登录,模型列表随账号变化。
  • · 模型目录拉取失败时 /v1/models 可能返回 503。
  • · 项目声明与 OpenAI 无关联,使用需自行评估账号风险。
  • · MIT 许可,可自由使用和修改。

主题标签

aichatgptcodexgpt-5ollamaopenaiopenai-codex-cliopenai-codex-intergration