Qoder Proxy API — Communication skill for Claude Code

qoder-proxy-api

`qoder-proxy-api` 是一个本地兼容层：下游暴露 OpenAI/Anthropic 风格接口，上游调用 Qoder Cloud Agents。优先目标是 CC Switch，其次 Cockpit Tools，最后 CLIProxyAPI。

它不是 Qoder 桌面端登录态抓取器，也不复用 cookie；只走 Qoder 官方 PAT/SAT 对应的 Cloud Agents API。

**定位声明**：本项目为个人**学习研究**用途——通过公开的 Cloud Agents API 理解协议兼容层 （OpenAI Chat Completions / Responses / Anthropic Messages）的适配设计。与 Qoder 官方 无任何关联，接口行为随官方变更可能失效；请遵守 Qoder 服务条款，自行保管令牌。

当前能力

• GET /v1/models：返回本地模型别名。
• POST /v1/chat/completions：OpenAI Chat Completions 兼容，支持 stream: true。
• POST /v1/responses：OpenAI Responses 兼容，支持 stream: true。
• POST /v1/messages：Anthropic Messages 最小兼容，支持 stream: true，用于 CC Switch / Claude Code 风格客户端优先验证。
• GET /health：本地健康检查和脱敏配置预览。

环境变量

最小配置：

$env:QODER_ACCESS_TOKEN="qoder_pat_or_sat"
$env:QODER_AGENT_ID="agent_xxx"
$env:QODER_ENVIRONMENT_ID="env_xxx"
$env:PROXY_API_KEY="local-dev-key"
node .\src\index.js

可选配置：

变量	默认值	说明
HOST	127.0.0.1	监听地址
PORT / QODER_PROXY_PORT	8320	监听端口
QODER_API_BASE_URL	https://api.qoder.com/api/v1/cloud	Qoder Cloud Agents API base
QODER_MODEL_ID / QODER_DEFAULT_MODEL	qoder-agent-default	单模型模式下的本地模型名
QODER_AGENT_VERSION	空	固定 Agent 版本
QODER_MODEL_MAP	空	JSON 对象，多模型映射
QODER_ARCHIVE_EPHEMERAL	true	无 session key 请求完成后归档 Qoder Session
QODER_SESSION_TTL_MS	7200000	x-qoder-session-id 复用缓存时长

多模型示例：

$env:QODER_MODEL_MAP='{
  "qoder-cc": {"agentId":"agent_xxx","environmentId":"env_xxx","agentVersion":1},
  "qoder-coding": {"agentId":"agent_yyy","environmentId":"env_yyy"}
}'

本地部署

一次性初始化 Qoder 账号配置，会自动获取/创建默认 Environment 和 `qoder-proxy-agent`，并把结果写入被 git 忽略的 `.env`：

$env:QODER_ACCESS_TOKEN="pt_xxx"
npm run setup:qoder
Remove-Item Env:QODER_ACCESS_TOKEN
npm start

启动后本地服务地址：`http://127.0.0.1:8320`。

学习指南：三个 Qoder 配置怎么来

这三个值都来自 Qoder Cloud Agents API，不来自 CC Switch，也不是 Claude Code 的配置项。

| 变量 |