commit bddc7c97006f2dcdfaeccef6e3a4966891e54df2
Author: 王性驊 <danielwang@supermicro.com>
Date:   Wed Feb 25 17:34:20 2026 +0800

    fix job table time line

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..b73dc61
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,4 @@
+# 複製這個檔案為 .env 並填入你的真實 API Key
+# cp .env.example .env
+
+XAI_API_KEY=xai-你的金鑰填在這裡
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..985de9e
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,9 @@
+# 環境變數（不要上傳到 git！）
+.env
+
+# macOS
+.DS_Store
+
+# 編輯器
+.vscode/
+.idea/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f18377c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,100 @@
+# LiteLLM Proxy — Claude Code × xAI Grok
+
+用 [LiteLLM](https://github.com/BerriAI/litellm) 在本地架一個 proxy server，讓 **Claude Code** 透過 Anthropic API 格式呼叫 **xAI Grok** 模型。
+
+## 架構
+
+```
+Claude Code
+    │  ANTHROPIC_BASE_URL=http://localhost:4000
+    ▼
+LiteLLM Proxy (Docker, port 4000)
+    │  model_list 路由
+    ▼
+xAI API (api.x.ai)
+    └─ grok-4-1-fast-non-reasoning
+```
+
+## 檔案結構
+
+```
+litellm-proxy/
+├── docker-compose.yml      # 啟動 LiteLLM Docker 容器
+├── litellm_config.yaml     # 模型路由設定
+├── .env                    # xAI API Key（不要上傳到 git！）
+└── settings.json           # 本地備份用的 claude settings 範例
+```
+
+## 快速開始
+
+### 1. 設定 API Key
+
+編輯 `.env`：
+
+```env
+XAI_API_KEY=xai-你的金鑰
+```
+
+### 2. 啟動 Proxy
+
+```bash
+docker compose up -d
+```
+
+### 3. 設定 Claude Code
+
+將以下內容寫入 `~/.claude/settings.json`：
+
+```json
+{
+  "env": {
+    "ANTHROPIC_BASE_URL": "http://localhost:4000",
+    "ANTHROPIC_AUTH_TOKEN": "sk-my-local-litellm-key",
+    "ANTHROPIC_DEFAULT_SONNET_MODEL": "grok-4-1-fast-reasoning",
+    "ANTHROPIC_DEFAULT_OPUS_MODEL": "grok-4-1-fast-reasoning",
+    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "grok-4-1-fast-reasoning"
+  }
+}
+```
+
+> `ANTHROPIC_AUTH_TOKEN` 填的是 LiteLLM 的 `master_key`，不是真實的 Anthropic 或 xAI key。
+
+### 4. 啟動 Claude Code
+
+```bash
+claude
+```
+
+## 常用指令
+
+| 指令 | 說明 |
+|------|------|
+| `docker compose up -d` | 背景啟動 proxy |
+| `docker compose down` | 停止 proxy |
+| `docker compose logs -f` | 查看即時 log |
+| `docker compose down && docker compose up -d` | 重啟（套用新設定） |
+
+## 設定說明
+
+### `litellm_config.yaml`
+
+```yaml
+model_list:
+  - model_name: grok-4-1-fast-reasoning   # Claude Code 看到的模型名稱
+    litellm_params:
+      model: xai/grok-4-1-fast-non-reasoning  # 實際送給 xAI 的模型
+      api_key: os.environ/XAI_API_KEY
+
+litellm_settings:
+  master_key: sk-my-local-litellm-key  # Claude Code 用的假 API Key
+  drop_params: true                    # 忽略 xAI 不支援的 Claude 專屬參數
+```
+
+**為什麼用 `non-reasoning` 模型？**
+Claude Code 本身是 agentic AI，reasoning 在 Claude Code 層進行。底層模型使用 non-reasoning 版本可避免 LiteLLM 的參數轉換 bug（`reasoningEffort` camelCase 問題），速度也更快。
+
+## 注意事項
+
+- `.env` 內含真實 API Key，請加入 `.gitignore` 避免上傳
+- 修改 `litellm_config.yaml` 後需重啟 docker 才會生效
+- `~/.claude/settings.json` 修改後**立即生效**，不需重啟
diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 0000000..6bfbceb
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,12 @@
+services:
+  litellm:
+    image: ghcr.io/berriai/litellm:main-latest
+    container_name: litellm-proxy
+    ports:
+      - "4000:4000"
+    volumes:
+      - ./litellm_config.yaml:/app/config.yaml
+    env_file:
+      - .env
+    command: [ "--config", "/app/config.yaml", "--detailed_debug" ]
+    restart: unless-stopped
diff --git a/litellm_config.yaml b/litellm_config.yaml
new file mode 100644
index 0000000..76c5db7
--- /dev/null
+++ b/litellm_config.yaml
@@ -0,0 +1,14 @@
+model_list:
+  - model_name: grok-4-1-fast-reasoning
+    litellm_params:
+      model: xai/grok-4-1-fast-non-reasoning
+      api_key: os.environ/XAI_API_KEY
+
+  - model_name: claude-opus-4-5
+    litellm_params:
+      model: xai/grok-4-1-fast-non-reasoning
+      api_key: os.environ/XAI_API_KEY
+
+litellm_settings:
+  master_key: sk-my-local-litellm-key
+  drop_params: true
\ No newline at end of file
diff --git a/settings.json b/settings.json
new file mode 100644
index 0000000..22fa679
--- /dev/null
+++ b/settings.json
@@ -0,0 +1,9 @@
+{
+    "env": {
+        "ANTHROPIC_BASE_URL": "http://localhost:4000",
+        "ANTHROPIC_AUTH_TOKEN": "sk-my-local-litellm-key",
+        "ANTHROPIC_DEFAULT_SONNET_MODEL": "grok-4-1-fast-reasoning",
+        "ANTHROPIC_DEFAULT_OPUS_MODEL": "grok-4-1-fast-reasoning",
+        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "grok-4-1-fast-reasoning"
+    }
+}
\ No newline at end of file