Skip to content

FAQ_ZH.md

Latest commit

 

History

History
273 lines (171 loc) · 8.44 KB

FAQ_ZH.md

File metadata and controls

273 lines (171 loc) · 8.44 KB
Raw

CodexBridge 中文 FAQ

我应该用什么 ChatGPT 账号？

使用 ChatGPT Plus 或 Pro，并确保账号能访问 Apps / Developer Mode。

当前测试显示，Free / Go 账号不暴露 CodexBridge 需要的 App 创建流程。

CodexBridge 不解锁 Developer Mode，不解锁模型，不绕过账号限制，也不提供账号访问。它只连接你自己的 ChatGPT App 界面和你自己的本地仓库。

推荐安装方式是什么？

全局安装一次：

npm install -g @naplesblue/codexbridge

不要安装未 scoped 的 codexbridge 包。那个 npm 包名属于另一个 CLI，本项目的标准安装方式是 scoped 包。

然后进入目标仓库运行：

codexbridge setup

以后每天从同一个仓库启动：

codexbridge start

npx -y -p @naplesblue/codexbridge codexbridge start 仍然可用，但普通用户更容易理解全局安装。

ChatGPT 里要打开什么设置？

在 ChatGPT 中打开：

Settings
-> Apps
-> Advanced settings
-> Developer mode: on
-> Enforce CSP in developer mode: on
-> Create app

Create App 填：

Name: CodexBridge
Description: Local workspace bridge for ChatGPT coding
Connection: Server URL
Server URL: 粘贴 CodexBridge 复制的 URL
Authentication: No Authentication / None

复制的 Server URL 已经包含私有 CodexBridge token。

CSP 要保持开启吗？

要保持开启。

CodexBridge 的小组件按 CSP 开启的路径构建。它不需要远程脚本、外部字体、iframe、第三方图片或任意外部请求。

CodexBridge 会绕过速率限制吗？

不会。

CodexBridge 不绕过、不提升、不合并、不转售、不修改 ChatGPT、Codex、OpenAI 或第三方模型限制。所有请求仍然通过你自己的 ChatGPT 会话，并受该账号当前限制约束。

它的价值在于 ChatGPT 和 Codex 是不同产品界面。某个工作流暂时不可用时，如果另一个你本来就有权限的界面仍可用，CodexBridge 可以让它继续操作同一个本地仓库。

CodexBridge 可以使用 GPT-5.5 吗？

前提是你的 ChatGPT 账号已经在 Web 产品里提供这个模型或同级更强模型，并且该模型界面可以调用 Developer Mode Apps。

CodexBridge 不提供、不代理、不转售、也不解锁模型。它只给兼容的 ChatGPT 会话提供本地仓库工具。

如果某个模型不能直接调用工具，用上下文包回退：

codexbridge pro-bundle --root /path/to/repo --copy

然后把生成的 .ai-bridge/pro-context.md 粘贴给该模型，让它做规划，再用本地执行器执行。

为什么 Pro 账号也可能连不上某个模型？

账号权限和模型工具能力是两回事。

Plus / Pro 可以暴露 Apps / Developer Mode，但某个具体模型界面仍然可能不能调用连接器或 MCP 工具。遇到这种情况时，用 codexbridge pro-bundle --copy 导出上下文，再把计划交给本地代理执行。

ChatGPT 能通过 CodexBridge 看到什么？

ChatGPT 能看到工具显式暴露的工作区内容：

  • AGENTS.md
  • .ai-bridge 计划、状态、执行记录
  • git status
  • git diff
  • 文件树和搜索结果
  • 你让它读取的源码文件

它不能读取 Codex 的隐藏运行时记忆，也不能读取工作区外的文件，除非你明确允许额外 root。

ChatGPT 可以编辑什么？

Normal coding 模式下，ChatGPT 可以在配置的工作区内写入和精确编辑文件。

默认会阻止：

  • .env
  • 私钥
  • .git
  • node_modules
  • 生成目录和缓存目录
  • symlink 逃逸
  • 工作区外路径

如果你只想让 ChatGPT 规划，不想让它直接改源码，用 handoff 模式。

CodexBridge 能把 bash 绑定到某个会话 id 吗？

CodexBridge 不能附加到、读取或复用某一个 Codex App 聊天会话或终端会话。

MCP 的 bash 工具是在你启动的 CodexBridge 本地服务器进程里，针对配置的 workspace root 执行。MCP session id 只是 ChatGPT 和 CodexBridge HTTP 服务器之间的传输状态，不是 Codex 会话 id。

但 CodexBridge 可以要求 bash 调用带上匹配的本地 session 标签：

codexbridge start --bash-session main --require-bash-session

之后 bash 调用必须包含 session_id: "main"。这能避免误触发到错误的 CodexBridge 终端，但不是远程控制某个已有的 Codex App 聊天。

如果你显式开启，CodexBridge 可以列出本地 Codex session id 和标题：

codexbridge start --tool-mode full --codex-sessions metadata

它会读取 ~/.codex/sessions 和 ~/.codex/archived_sessions 下的本地 Codex JSONL 历史，返回 metadata 和 codex resume <session-id> 命令。只有需要有限长度 transcript 读取时才使用 --codex-sessions read。它不会附加到正在运行的 Codex App 聊天。

如果你正在 Codex 里工作，不希望 ChatGPT 触发 shell 命令，可以关闭 bash：

codexbridge start --no-bash

如果只想让 ChatGPT 写计划，由 Codex 或其他本地 agent 执行：

codexbridge start --mode handoff --no-bash

选择哪种 tunnel？

按这个规则选：

快速 demo：          Cloudflare quick tunnel
推荐稳定 URL：       ngrok free dev domain
自定义域名：          Cloudflare named tunnel
无公网 URL：          local-only，只适合能访问 localhost 的 MCP 客户端

Cloudflare quick tunnel 每次重启 URL 都变。把 quick URL 填到 ChatGPT 后，每次重启都要改 ChatGPT App 的 Server URL。

大多数用户建议用 ngrok free dev domain。创建免费 ngrok 账号，在 Universal Gateway -> Domains 找到分配给你的 dev domain，并在 codexbridge setup 里保存。

如果你有自己的域名，用 Cloudflare named tunnel，把 DNS 路由到例如 codexbridge.example.com 的主机名。

能每天使用同一个 ChatGPT App URL 吗？

可以，前提是使用稳定 hostname。

推荐简单路径：

codexbridge setup
# 选择 ngrok
# 输入你的 ngrok free dev domain

之后：

codexbridge start

同一个 hostname 和 CodexBridge token 会被当前工作区复用。

quick mode 为什么每次都要改 URL？

Cloudflare quick tunnel 是一次性的临时地址。每次重新启动 tunnel，Cloudflare 会分配一个新的 trycloudflare.com URL。

如果你不想改 ChatGPT 设置，用 ngrok free dev domain 或 Cloudflare named tunnel。

同时跑两个仓库怎么办？

给每个仓库使用不同本地端口和不同 tunnel hostname。

示例：

repo A: port 8787, hostname A
repo B: port 8788, hostname B

分别在两个仓库里运行 codexbridge setup 并保存 profile。

为什么使用 naplesblue.github.io/codexbridge？

GitHub Pages 的 owner.github.io 只能由名为 owner 的 GitHub 用户或组织使用。

对这个 fork 来说，干净的项目 Pages 地址是：

https://naplesblue.github.io/codexbridge/

中文页面是：

https://naplesblue.github.io/codexbridge/zh.html

CodexBridge 是否违反服务条款？

CodexBridge 使用 ChatGPT 的官方 Developer Mode / MCP App 接入路径，让你自己的 ChatGPT 会话连接到你自己的本地工具。

它不绕过限制，不抓取隐藏接口，不共享账号，不转售模型，不伪造请求来源，也不把第三方模型包装成别的模型。

用户仍然需要遵守 ChatGPT、Codex、OpenAI 和任何第三方服务的条款。

CodexBridge 生产环境安全吗？

CodexBridge 是本地开发桥，不是操作系统级沙箱。

只在你信任的仓库里使用。公网 tunnel 保持 token auth 开启。保持 safe bash，除非你明确知道为什么需要 full bash。公网暴露前先读 SECURITY.md。

保存的设置在哪里？

工作区配置保存在：

~/.codexbridge/profiles/

管理命令：

codexbridge settings
codexbridge settings list
codexbridge settings delete --yes

显示设置时，保存的 token 会被打码。

CodexBridge 能帮助 ChatGPT 维持上下文吗？

可以帮助，但方式是显式文件和上下文包，不是隐藏记忆。

推荐使用：

  • AGENTS.md 写项目规则。
  • .ai-bridge/decisions.md 写关键决策。
  • .ai-bridge/current-plan.md 写当前计划。
  • .ai-bridge/agent-status.md 写本地执行结果。
  • codexbridge pro-bundle --copy 给不能调用工具的模型生成上下文包。

这样 ChatGPT 断线、换模型或换会话后，仍然可以通过文件恢复上下文。