任意客戶端的通用配置法
支援自定義 API 地址的客戶端，接法都是同一套：填地址、填 Key、填模型名。難的從來不是這三步，而是每個客戶端把它們叫成不同的名字、放在不同的地方。這一頁把這些說法對齊。
三個值，填完就通
| 要填的 | 填什麼 | 常見的坑 |
|---|---|---|
| API 地址 | https://api.9coding.com | 結尾不要斜槓、不要帶 /v1——客戶端會自己接路徑 |
| API Key | 控制台建立，sk-9c- 開頭 | 複製時容易帶上結尾換行或空格 |
| 模型名 | 從 /v1/models 列表裡原樣複製 | 手打的模型名大小寫和連字元差一個字元就不認 |
各家客戶端管這三個值叫什麼
同一件事，不同客戶端有不同說法。在設定裡看到下面任意一個詞，填的就是它。
| 你要找的 | 可能顯示為 |
|---|---|
| API 地址 | Base URL · API 地址 · API Host · 介面地址 · 自定義端點 · Endpoint · API Proxy |
| API Key | API Key · 金鑰 · 令牌 · Token · Access Key |
| 協議型別 | OpenAI 相容 · OpenAI Compatible · Custom · 自定義 Provider |
選哪種協議？絕大多數客戶端選 OpenAI 相容那一項。只有 Claude Code 這類 Anthropic 原生客戶端走 Anthropic 協議——它有專門一頁。
命令列工具
命令列工具基本都讀環境變數。OpenAI 相容的這麼設：
~/.zshrc 或 ~/.bashrc
export OPENAI_BASE_URL="https://api.9coding.com/v1"
export OPENAI_API_KEY="sk-9c-你的Key"注意這裡要帶
/v1。OpenAI 系的 SDK 與 CLI 約定 OPENAI_BASE_URL 指向到 /v1 這一層；而 Anthropic 系的 ANTHROPIC_BASE_URL 只到域名。這是最容易搞混的一處——填錯的表現通常是 404，有時是 401。改完重開終端，或 source ~/.zshrc。絕大多數命令列工具只在啟動時讀一次環境變數。
編輯器外掛
Cline、Roo Code、Continue 這類外掛在自己的設定面板裡配，不讀全域性環境變數。步驟是一樣的：
- Provider 選 OpenAI Compatible（不要選 OpenAI 官方那項，那一項通常鎖死了地址）
- Base URL 填
https://api.9coding.com/v1 - API Key 填你的
sk-9c-Key - 模型名從下拉里選；如果下拉是空的，說明地址或 Key 沒通——先用下面那條 curl 驗證
桌面與網頁客戶端
Cherry Studio、ChatBox、NextChat、LobeChat、Open WebUI 這類圖形客戶端，都在「設定 → 模型服務 / Providers」里加一個自定義服務商：
- 新增一個 Provider，型別選 OpenAI 相容
- API 地址填
https://api.9coding.com——這類客戶端多數會自己補/v1，如果連不上，再試試帶/v1的版本 - 貼上 Key，點「獲取模型列表」或手動填模型名
- 回到對話介面，在模型選擇器裡選中剛加的那個
加完了但對話裡選不到模型？多數客戶端要求你手動勾選啟用哪些模型，拉到列表後還得打勾才會出現在選擇器裡。
自己寫程式碼
OpenAI SDK 的完整寫法見一行遷移那頁。Anthropic SDK 這麼改：
Python
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.9coding.com",
auth_token="sk-9c-你的Key",
)Anthropic SDK 用 auth_token（發 Authorization: Bearer）而不是 api_key（發 x-api-key）。這兩個搞混是 401 最常見的原因。
驗證：一條命令確認是不是通了
terminal
curl -s -w '\n%{http_code}\n' https://api.9coding.com/v1/models \
-H "Authorization: Bearer sk-9c-你的Key"先跑這條再去調客戶端。它把「是我們的問題」和「是客戶端配置的問題」一次分開——省下的時間比任何一步都多。