ChatMock
用 Codex 引擎替换 OpenAI API，一行配置即享新能力
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1566
使用教程
环境要求
- Python 环境（使用 pipx 或 pip 安装）
- 一个可登录的 ChatGPT 账号
- macOS 用户可改用 Homebrew 安装
- 无头服务器登录需支持 --headless 参数
安装与启动步骤
-
1安装 ChatMock
推荐用 pipx 安装，可隔离依赖；也可用 pip 安装同名包。
pipx install chatmock -
2或用 Homebrew 安装
macOS/Linux 上可通过 Homebrew 源安装，需先 tap 再 install。
brew tap RayBytes/chatmock brew install chatmock -
3登录 ChatGPT 账号
首次使用需登录 ChatGPT 账号；在无头服务器上执行时追加 --headless。
chatmock login -
4启动本地服务
启动后服务默认监听 http://127.0.0.1:8000，新增配置项写在 serve 之后。
chatmock serve -
5接入兼容应用
在支持 OpenAI/Ollama 兼容的应用中把地址填为 http://127.0.0.1:8000/v1，API Key 可任意填。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--reasoning-effort | 否 | 控制模型思考强度 | medium |
--reasoning-summary | 否 | 思考摘要的详细程度 | auto |
--reasoning-compat | 否 | 思考过程返回给客户端的方式 | think-tags |
--fast-mode | 否 | 对支持的模型启用优先处理 | false |
--enable-web-search | 否 | 允许模型联网搜索 | false |
--model-sync | 否 | 自动发现账号可用模型 | true |
如何确认成功
终端显示服务已在 http://127.0.0.1:8000 运行，浏览器或客户端访问 http://127.0.0.1:8000/v1 可正常返回。
常见问题
Q：在无头服务器上怎么登录？
A：执行 chatmock login 时追加 --headless 参数，即可在无图形界面的服务器上完成登录。
Q：现有的 OpenAI 客户端如何切换过来？
A：把 base URL 改为 http://127.0.0.1:8000/v1，API Key 可以随意填写，无需修改其他代码。
Q：如何用 Docker 部署？
A：README 指向仓库内的 DOCKER.md，具体命令请查阅该文档。
Q：怎么让模型联网搜索？
A：启动时加 --enable-web-search，或在请求体中加入 responses_tools 与 responses_tool_choice 字段。
注意事项
- 所有配置参数都必须写在 chatmock serve 之后。
- 每个参数也都可以用对应的环境变量设置，例如 CHATGPT_LOCAL_REASONING_EFFORT。
- 默认端口为 8000，接口基础地址为 /v1。
- Raycast 可在 Ollama 设置中把 host URL 填为 127.0.0.1:8000 并同步模型。
核心亮点
- API 兼容层设计巧妙，现有 OpenAI 客户端无需改动即可接入 Codex
- 同时支持 Ollama 本地模型，提供灵活的模型切换选项
- 基于 Docker 部署，上手快，适合快速原型验证
不足之处
- 依赖 Codex 服务，可能受限于 OpenAI 的访问策略
- 文档/社区待观察
适用场景
- 将现有 ChatGPT 应用迁移到 Codex 引擎进行测试
- 在本地开发环境模拟 OpenAI API 进行离线调试
- 结合 Ollama 构建混合推理服务，平衡成本与性能
替代项目
LocalAI、llama.cpp、vLLM
上一篇：gptGrok2api
下一篇：container
同类项目推荐
gollama
开源
命令行一键管理 Ollama 模型，告别繁琐操作
Go manage your Ollama models
chroma
开源
给 AI 应用装一个超快的向量搜索引擎
Search infrastructure for AI
bex
开源
Git push 即部署，让 AI 智能体成为你的运维搭档。
The open-source Render alternative — AI-native. Git push → build → deploy on your···
prompt-cache
开源
给 LLM 加个缓存，成本直降 80%，响应快到飞起
Cut LLM costs by up to 80% and unlock sub-millisecond responses with intelligent sem···
gigatoken
开源
用 Rust 把分词速度拉到 GB/s，告别数据预处理瓶颈
Language model tokenization at GB/s
ComfyUI-Easy-Install
开源
一键装好 ComfyUI，开箱即用不折腾环境
One-click Portable ComfyUI with EZi Desktop - install, manage and customize ComfyUI ···
kronk
开源
Go 项目一键接入本地大模型、语音和图像生成
Go With Your Own Intelligence! Use Go for hardware accelerated local inference with ···
vox-serve
开源
让 TTS/STS 模型秒变低延迟流式在线服务
A Streaming-Native Serving Engine for TTS/STS Models
simple-llm
开源
1300行Python手写LLM推理引擎，读懂并魔改每一步
~1300 line, minimal, extensible LLM inference engine built from scratch.