一、先拿到 API Key
在控制臺創建 Key 後，建議用環境變量注入，不要寫進代碼倉庫。下面給出 Windows（PowerShell）與 macOS（bash）兩種寫法。
| 平臺 | 寫法 |
|---|---|
| macOS / Linux | export OPENAI_BASE_URL=https://api.example.com/v1 |
| Windows PowerShell | $env:OPENAI_BASE_URL="https://api.example.com/v1" |
二、模型映射
Claude Code 預設走 Anthropic 官方端點，切換到 OpenAI 兼容中轉需要同時改 base_url 與模型名。模型名寫錯不會報錯，但會靜默回落到預設模型——這是最常見的“配置好了卻不生效”。
關鍵結論
- base_url 一行切換即可；
- 模型名必須顯式指定為渠道支持的別名；
- 改完先跑一條 echo 驗證連通再上生產。
三、常見報錯自查
401 多為 Key 未注入或過期；404 多為 base_url 路徑拼錯（末尾是否帶 /v1）；429 先看並發配額。逐條對照即可，基本不用客服。