安装

Homebrew

brew tap RayBytes/chatmock
brew install chatmock

pipx / pip

pipx install chatmock

GUI

从 releases 下载（macOS 和 Windows）

Docker

请参阅 DOCKER.md

快速入门

# 1. 使用你的 ChatGPT 账号登录
chatmock login

# 2. 启动服务器
chatmock serve

服务器默认运行在 http://127.0.0.1:8000。对于兼容 OpenAI 的应用，可以使用 http://127.0.0.1:8000/v1 作为基础 URL。

使用方法

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:8000/v1",
    api_key="anything"  # 不会进行校验
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "hello"}]
)
print(response.choices[0].message.content)

curl http://127.0.0.1:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "hello"}]
  }'

支持的模型

• gpt-5.4
• gpt-5.4-mini
• gpt-5.2
• gpt-5.1
• gpt-5
• gpt-5.3-codex
• gpt-5.3-codex-spark
• gpt-5.2-codex
• gpt-5-codex
• gpt-5.1-codex
• gpt-5.1-codex-max
• gpt-5.1-codex-mini
• codex-mini

功能特性

• 工具/函数调用
• 视觉/图像输入
• 思考摘要（通过 think 标签）
• 可配置的思考力度
• 针对支持模型的快速模式
• 网络搜索工具
• 兼容 OpenAI 的 /v1/responses（HTTP + WebSocket）
• 兼容 Ollama 的端点
• 将推理力度作为独立模型公开（可选）

配置选项

所有标志都位于 chatmock serve 命令之后。这些也可以通过环境变量设置。

{
  "model": "gpt-5.4",
  "messages": [{"role": "user", "content": "关于...的最新消息"}],
  "responses_tools": [{"type": "web_search"}],
  "responses_tool_choice": "auto"
}

{
  "model": "gpt-5.4",
  "input": "总结这段内容",
  "fast_mode": true
}

注意事项

请负责任地使用，并自行承担风险。本项目与 OpenAI 无任何关联。

星标历史

ChatMock 快速上手指南

ChatMock 是一个开源工具，允许你在常用的聊天应用和编程工具中使用 ChatGPT（Codex）的能力。它通过本地启动一个兼容 OpenAI API 格式的服务端来实现这一功能。

环境准备

• 操作系统：macOS、Windows 或 Linux（Docker 支持）。
• 运行环境：
  • 方案 A（推荐）：已安装 Homebrew (macOS/Linux) 或 pipx。
  • 方案 B：已安装 Python 3.8+ 及 pip。
  • 方案 C：图形界面用户可直接下载安装包，无需配置命令行环境。
• 账号要求：需要拥有有效的 ChatGPT 账号用于登录验证。

安装步骤

请选择以下任意一种方式进行安装：

方式一：使用 pipx（推荐，隔离环境）

pipx install chatmock

方式二：使用 Homebrew (macOS/Linux)

brew tap RayBytes/chatmock
brew install chatmock

方式三：使用 pip

pip install chatmock

方式四：图形界面 (GUI)

访问 Releases 页面 下载对应系统（macOS 或 Windows）的安装包直接安装。

注：国内用户若遇到下载慢的问题，可配置 pip 国内镜像源（如清华源）： pip install chatmock -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

1. 登录账号

在终端执行以下命令，按照提示使用你的 ChatGPT 账号进行登录：

chatmock login

2. 启动服务

登录成功后，启动本地服务器：

chatmock serve

服务默认运行在 http://127.0.0.1:8000。对于兼容 OpenAI 的客户端，请使用基础 URL：http://127.0.0.1:8000/v1。

3. 调用示例

启动服务后，即可在任何支持 OpenAI 协议的工具中使用。以下是 Python 调用示例：

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:8000/v1",
    api_key="anything"  # 本地模拟，密钥随意填写
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "hello"}]
)
print(response.choices[0].message.content)

支持的部分模型名称：gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, codex-mini 等（详见官方文档完整列表）。