把 Amazon Q Developer 的 Claude 能力转成兼容 OpenAI Chat Completions 与 Anthropic Messages 的本地服务，方便在 Claude Code、Cursor、Continue、Open WebUI 等工具中复用同一个模型入口。

• OpenAI /v1/chat/completions 与 Anthropic /v1/messages 双协议兼容
• SSE 流式输出，已针对 Claude Code / Anthropic IDE 适配事件格式
• 自动刷新 access_token：优先读取 Amazon Q CLI 数据库，失败再调用 OIDC /token
• 支持自定义 CA Bundle / 禁用 SSL 验证（方便企业代理环境排障）
• 便捷凭证管理：amazonq_credentials.json + info.py 提取脚本

当前仓库只包含 Flask 单账号版本（main.py），没有 FastAPI 多账号实现；文档中所有步骤均以现有文件为准。

requirements.txt 只包含通用依赖（requests 等）。请另外安装 flask：

pip install flask
pip install -r requirements.txt

git clone <repo-url>
cd aq2api

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

pip install --upgrade pip
pip install flask requests
pip install -r requirements.txt

1. 通过 info.py 导出（推荐）

   python info.py > amazonq_credentials.json

   输出包含 client_id / client_secret / refresh_token 等字段，main.py 启动时自动读取。

2. 手动编辑 amazonq_credentials.json

   {
     "client_id": "KwJ4zv...",
     "client_secret": "<JWT>",
     "refresh_token": "aorAAAA...",
     "profile_arn": "arn:aws:..."   // 可选
   }

程序也会尝试从 ~/.local/share/amazon-q/data.sqlite3 抓取最新 token；只要本机 CLI 已登录即可自动覆盖 access_token。

创建 config.json 并覆盖默认值：

{
  "logging": {
    "level": "INFO",
    "log_requests": true,
    "log_responses": true,
    "log_token_refresh": true,
    "max_log_length": 500
  },
  "performance": {
    "stream_chunk_size": 1024,
    "buffer_max_size": 10240,
    "token_refresh_margin_seconds": 300
  },
  "ssl": {
    "verify_oidc": true,
    "ca_bundle": "/path/to/corp-root.pem"
  }
}

常用环境变量：

python main.py

默认监听 http://0.0.0.0:8000。首次启动会提示是否已加载凭证，并在日志中显示两个上游端点：

• Amazon Q API: https://codewhisperer.us-east-1.amazonaws.com
• OIDC Token: https://oidc.us-east-1.amazonaws.com

/v1/messages 在未显式声明 stream:false 时总是走 SSE，并按照 Anthropic 规范发送 message_start → content_block_delta → message_stop 事件。

OpenAI SDK（Python）

from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:8000/v1", api_key="dummy-key")

resp = client.chat.completions.create(
    model="claude-sonnet-4.5",
    messages=[{"role": "user", "content": "介绍一下 Amazon Q"}],
    stream=False,
)
print(resp.choices[0].message.content)

OpenAI 流式（curl）

curl http://127.0.0.1:8000/v1/chat/completions \
  -H "Authorization: Bearer test" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4.5","messages":[{"role":"user","content":"说个笑话"}],"stream":true}'

Anthropic SDK (Messages API) — 默认会收到流式事件，也可设置 stream: false 获得一次性响应。

from anthropic import Anthropic

client = Anthropic(base_url="http://127.0.0.1:8000/v1", api_key="dummy-key")

resp = client.messages.create(
    model="claude-sonnet-4",
    max_tokens=2048,
    messages=[{"role": "user", "content": "列一个使用指南"}],
    stream=False,
)
print(resp.content[0].text)

MIT（默认）。欢迎提交 Issue / PR 改进文档与功能。*** End Patch*** End Patch ***