opencodex部署在远端主机，本地codex app如何实现自动注入远端模型

[mobaicloud]

Documentation problem type

Missing documentation

Documentation location

https://github.com/lidge-jun/opencodex/

What is wrong or missing?

已经实现了远端部署，调用模型也没问题，但是无法像在本地运行那样同时保持codex账号登录及第三方模型的随意调用，我没有找到相关文档，尝试了两个小时也没有成功。
我使用了这样的配置：
model_provider = "opencodex"
[model_providers.opencodex]
name = "OpenCodex Remote"
base_url = "xxx/v1"
wire_api = "responses"
requires_openai_auth = false
但是codex账号状态就会丢失
如果我取消这个配置，codex账号状态恢复，但是无法调用opencodex里的模型
另外远端部署的opencodex，主账号也是无法登录的吗？

What should the documentation explain instead?

已经实现了远端部署，调用模型也没问题，但是无法像在本地运行那样同时保持codex账号登录及第三方模型的随意调用，我没有找到相关文档，尝试了两个小时也没有成功。

Suggested wording or example

No response

Additional context or attachments

No response

Checks

• I searched existing documentation issues.
• No secrets or personal information are included.

[Ingwannu]

Correction after rechecking the current dev injection contract: my HTTPS example above used the obsolete header form. Codex CLI 0.146+ should use env_key, not env_http_headers.

The SSH-tunnel recommendation is unchanged and remains the safest first test:

# root keys, before the first [table]
model_catalog_json = "/absolute/local/path/to/opencodex-catalog.json"
openai_base_url = "http://127.0.0.1:20100/v1"

Do not set model_provider = "opencodex" for that loopback/tunnel form.

If a trusted TLS endpoint requires the dedicated provider form, the corrected configuration is:

# root keys
model_provider = "opencodex"
model_catalog_json = "/absolute/local/path/to/opencodex-catalog.json"

[model_providers.opencodex]
name = "OpenCodex Remote"
base_url = "https://your-host/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "OPENCODEX_API_AUTH_TOKEN"

Set OPENCODEX_API_AUTH_TOKEN in the local Codex App/CLI environment. This keeps the login/account UX while using the remote OpenCodex admission token. Thank you to the follow-up review for catching the outdated field. The issue should remain open with needs-info until the SSH-tunnel path is confirmed.

[lidge-jun]

리뷰 · 우선순위 41 / 80

지금 dev HEAD d23c3179f에서 코드가 이미 답을 갖고 있음. 리포터 설정은 model_provider = "opencodex" + [model_providers.opencodex] + requires_openai_auth = false. 그게 ChatGPT 로그인 UX를 죽임. src/codex/inject.ts:213-238 buildProviderTableBlock()은 전용 테이블을 쓸 때 항상 requires_openai_auth = true. false는 주입 계약이 아님. 루프백은 아예 그 테이블을 안 씀. Design B (inject.ts:113-119, :783-806)는 shouldInjectApiAuthHeader()가 거짓일 때 루트 openai_base_url만 넣고 네이티브 openai 프로바이더 id를 유지함. 히스토리 리태그 없음. 로그인 상태 유지가 그 경로임. 전용 테이블 + false는 로컬 주입이 절대 안 쓰는 조합임.

원격 프로세스가 로컬 $CODEX_HOME을 자동으로 못 씀. injectCodexConfig (inject.ts:672)는 그 프로세스의 CODEX_CONFIG_PATH만 읽음 (:688). 카탈로그도 그 머신 경로. chooseCatalogPathForInjection (:648-661) / setRootModelCatalogPath (:500-504). 기본 파일은 src/codex/paths.ts DEFAULT_CATALOG_PATH = join(CODEX_HOME, "opencodex-catalog.json"). 원격에서 만든 JSON을 로컬 Codex 앱이 직접 못 봄. 복사가 필요함. "자동 주입"은 빠진 기능이 아니라 로컬 파일 계약임.

Ingwannu가 말한 SSH 터널이 코드랑 맞음. src/server/auth-cors.ts:50-55가 ssh -L 20100:localhost:10100을 루프백 Host로 인정함. 포트가 달라도 hostname이 루프백이면 됨. 터널이면 로컬 Codex는 Design B처럼 루트 openai_base_url = "http://127.0.0.1:20100/v1" + 로컬로 복사한 model_catalog_json이면 됨. model_provider = "opencodex" 넣지 말 것. 넣으면 inject.ts:697-717이 외부 프로바이더로 보고 주입을 건너뜀. 사용자 소유 루트 openai_base_url도 안 덮음 (:1097-1110). 원격 OpenCodex는 루프백에 묶는 게 안전함.

HTTPS로 원격 노출할 때만 전용 테이블임. 그때도 requires_openai_auth = true. 현재 주입은 env_http_headers가 아니라 env_key = "OPENCODEX_API_AUTH_TOKEN" (inject.ts:229-236, #2073). 토큰을 TOML에 박지 말 것. Codex 인증 컨텍스트가 원격으로 가니까 TLS/SSH만. 원격 호스트에서 끝나는 프로바이더 OAuth는 거기서 끝내거나 콜백 포트를 같이 포워드. 메인 계정 로그인이 "원격에서 안 되냐"는 Direct 모드가 호출자 Codex 로그인을 쓰는 거랑, 원격 박스에서 OAuth를 띄우는 거랑 다름.

문서 구멍은 맞음. README/docs에 ssh -L 레시피가 없음. docs/codex-app-model-catalog.md는 model_catalog_json 로컬 경로만 말함. 코드 버그 아님. needs-info. 리포터가 터널 폼을 확인하기 전엔 구현 PR 열지 말 것. 원격→로컬 자동 카탈로그 푸시 만들지 말 것. $CODEX_HOME을 네트워크로 쓰지 말 것. #1168이랑 다른 레인임. 카탈로그 쿼타 이슈 아님.

#2188 L1–L9 사이드카 이미 dev. x_search 넣지 말 것. Grok OAuth Chat 기본(#2255)/GUI 옵트인 Responses(#2266)랑 다른 레인임. types.ts/config.ts 스플릿 안 씹힘. 스키마 PR 아님. 프리뷰 배포 아님. v2.29.0 이미 태그됨. 핫 크래시 아님. 비전공자 오퍼레이터가 전용 프로바이더 폼으로 로그인을 날리는 문서 구멍임. 그래서 41.

해결방안: 이 이슈는 문서로 열어 둬라. 권장 경로는 원격 루프백 + SSH 터널 + 로컬 openai_base_url + 로컬로 복사한 model_catalog_json. requires_openai_auth = false 쓰지 말 것. 전용 테이블이 필요하면 true + env_key. 자동 원격 주입 피처로 키우지 말 것. 리포터 확인 나오면 문서 PR 하나. 스플릿이 inject.ts를 옮기면 리베이스하지 말고 닫고 다시 짜라. 지금은 그 정도 아님.

이 댓글은 grok-bot이 작성했습니다

[spinachomes]

1.把category json下载到本地
2.不用主账号登录，号池添加账号即可
3.配置增加个header 设置api key
4.本地我都不登录账号了，就像用中转一样

[Ingwannu]

补充说明：上面的 1–4 步是一种“把远端 OCX 当作中转/账号池”的可选方案，但它不会保留本地 Codex App 的 ChatGPT 主账号登录体验，所以不能直接回答本 issue 的原始需求。

如果目标是“本地仍保持 ChatGPT 登录，同时调用远端 OCX 模型”，当前受支持且风险最低的验证路径仍然是 SSH 隧道：把远端 127.0.0.1:10100 映射到本地 127.0.0.1:20100，在本地复制远端生成的 catalog，并只设置根级 openai_base_url = "http://127.0.0.1:20100/v1"。不要设置 model_provider = "opencodex"；该专用 provider 形态会改变原生账号/历史语义。

若必须直接暴露可信 HTTPS 端点，则使用 requires_openai_auth = true 与 env_key = "OPENCODEX_API_AUTH_TOKEN"，不要把 token 写进 TOML。该模式与 SSH 隧道的本地原生 provider 语义不同。

请 issue 作者确认 SSH 隧道 + 本地 catalog 方案是否能保留登录并正常切换模型；在得到这个结果前保留 needs-info。