2026-03-31 01:26:33 +00:00
|
|
|
|
# ──────────────────────────────────────────────
|
|
|
|
|
|
# cursor-api-proxy — 設定與建置
|
|
|
|
|
|
# 編輯下方變數,然後執行 make env 產生 .env 檔
|
|
|
|
|
|
# ──────────────────────────────────────────────
|
|
|
|
|
|
|
|
|
|
|
|
# ── 伺服器設定 ─────────────────────────────────
|
|
|
|
|
|
HOST ?= 127.0.0.1
|
2026-03-31 03:02:11 +00:00
|
|
|
|
PORT ?= 8766
|
2026-03-31 01:26:33 +00:00
|
|
|
|
API_KEY ?=
|
2026-03-31 03:02:11 +00:00
|
|
|
|
TIMEOUT_MS ?= 3600000
|
2026-03-31 01:26:33 +00:00
|
|
|
|
MULTI_PORT ?= false
|
|
|
|
|
|
VERBOSE ?= false
|
|
|
|
|
|
|
|
|
|
|
|
# ── Agent / 模型設定 ──────────────────────────
|
|
|
|
|
|
AGENT_BIN ?= agent
|
|
|
|
|
|
AGENT_NODE ?=
|
|
|
|
|
|
AGENT_SCRIPT ?=
|
|
|
|
|
|
DEFAULT_MODEL ?= auto
|
|
|
|
|
|
STRICT_MODEL ?= true
|
2026-04-01 00:53:34 +00:00
|
|
|
|
MAX_MODE ?= false
|
2026-03-31 01:26:33 +00:00
|
|
|
|
FORCE ?= false
|
|
|
|
|
|
APPROVE_MCPS ?= false
|
|
|
|
|
|
|
|
|
|
|
|
# ── 工作區與帳號 ──────────────────────────────
|
|
|
|
|
|
WORKSPACE ?=
|
|
|
|
|
|
CHAT_ONLY_WORKSPACE ?= true
|
|
|
|
|
|
CONFIG_DIRS ?=
|
|
|
|
|
|
|
2026-04-01 04:02:41 +00:00
|
|
|
|
# ── Cursor / Claude Code(~/.claude)────────────────
|
|
|
|
|
|
# 預設 id 須與 GET http://HOST:PORT/v1/models 回傳的 data[].id 一致;可於命令列覆寫
|
|
|
|
|
|
CLAUDE_SETTINGS ?= $(HOME)/.claude/settings.json
|
|
|
|
|
|
CLAUDE_JSON ?= $(HOME)/.claude.json
|
|
|
|
|
|
ANTHROPIC_AUTH_TOKEN ?=
|
|
|
|
|
|
ANTHROPIC_DEFAULT_SONNET_MODEL ?= claude-4.6-sonnet-medium
|
|
|
|
|
|
ANTHROPIC_DEFAULT_OPUS_MODEL ?= claude-4.6-opus-max
|
|
|
|
|
|
ANTHROPIC_DEFAULT_HAIKU_MODEL ?= gemini-3-flash
|
|
|
|
|
|
# 僅影響 claude-settings 寫入的 ANTHROPIC_BASE_URL(預設等同 HOST;可設為 localhost)
|
|
|
|
|
|
ANTHROPIC_BASE_HOST ?= $(HOST)
|
|
|
|
|
|
|
2026-03-31 01:26:33 +00:00
|
|
|
|
# ── TLS / HTTPS ───────────────────────────────
|
|
|
|
|
|
TLS_CERT ?=
|
|
|
|
|
|
TLS_KEY ?=
|
|
|
|
|
|
|
|
|
|
|
|
# ── 記錄 ──────────────────────────────────────
|
|
|
|
|
|
SESSIONS_LOG ?=
|
|
|
|
|
|
|
|
|
|
|
|
# ──────────────────────────────────────────────
|
|
|
|
|
|
|
|
|
|
|
|
ENV_FILE ?= .env
|
|
|
|
|
|
|
2026-04-01 00:53:34 +00:00
|
|
|
|
OPENCODE_CONFIG ?= $(HOME)/.config/opencode/opencode.json
|
|
|
|
|
|
|
2026-04-01 04:02:41 +00:00
|
|
|
|
.PHONY: env run build clean help opencode opencode-models pm2 pm2-stop pm2-logs claude-code pm2-claude-code \
|
|
|
|
|
|
claude-settings claude-onboarding claude-cursor-setup
|
2026-03-31 01:26:33 +00:00
|
|
|
|
|
|
|
|
|
|
## 產生 .env 檔(預設輸出至 .env,可用 ENV_FILE=xxx 覆寫)
|
|
|
|
|
|
env:
|
|
|
|
|
|
@printf '# 由 make env 自動產生,請勿手動編輯\n' > $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_HOST=%s\n' "$(HOST)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_PORT=%s\n' "$(PORT)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_API_KEY=%s\n' "$(API_KEY)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_TIMEOUT_MS=%s\n' "$(TIMEOUT_MS)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_MULTI_PORT=%s\n' "$(MULTI_PORT)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_VERBOSE=%s\n' "$(VERBOSE)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_AGENT_BIN=%s\n' "$(AGENT_BIN)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_AGENT_NODE=%s\n' "$(AGENT_NODE)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_AGENT_SCRIPT=%s\n' "$(AGENT_SCRIPT)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_DEFAULT_MODEL=%s\n' "$(DEFAULT_MODEL)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_STRICT_MODEL=%s\n' "$(STRICT_MODEL)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_MAX_MODE=%s\n' "$(MAX_MODE)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_FORCE=%s\n' "$(FORCE)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_APPROVE_MCPS=%s\n' "$(APPROVE_MCPS)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_WORKSPACE=%s\n' "$(WORKSPACE)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_CHAT_ONLY_WORKSPACE=%s\n' "$(CHAT_ONLY_WORKSPACE)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_CONFIG_DIRS=%s\n' "$(CONFIG_DIRS)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_TLS_CERT=%s\n' "$(TLS_CERT)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_TLS_KEY=%s\n' "$(TLS_KEY)" >> $(ENV_FILE)
|
|
|
|
|
|
@printf 'CURSOR_BRIDGE_SESSIONS_LOG=%s\n' "$(SESSIONS_LOG)" >> $(ENV_FILE)
|
|
|
|
|
|
@echo "已產生 $(ENV_FILE)"
|
|
|
|
|
|
|
|
|
|
|
|
## 編譯二進位檔
|
|
|
|
|
|
build:
|
|
|
|
|
|
go build -o cursor-api-proxy .
|
|
|
|
|
|
|
|
|
|
|
|
## 載入 .env 後直接執行(需先執行 make env 或已有 .env)
|
|
|
|
|
|
run: build
|
|
|
|
|
|
@if [ -f $(ENV_FILE) ]; then \
|
|
|
|
|
|
set -a && . ./$(ENV_FILE) && set +a && ./cursor-api-proxy; \
|
|
|
|
|
|
else \
|
|
|
|
|
|
echo "找不到 $(ENV_FILE),請先執行 make env"; exit 1; \
|
|
|
|
|
|
fi
|
|
|
|
|
|
|
|
|
|
|
|
## 清除產出物
|
|
|
|
|
|
clean:
|
|
|
|
|
|
rm -f cursor-api-proxy $(ENV_FILE)
|
|
|
|
|
|
|
2026-04-01 00:53:34 +00:00
|
|
|
|
## 設定 OpenCode 使用此代理(更新 opencode.json 的 cursor provider)
|
|
|
|
|
|
opencode: build
|
|
|
|
|
|
@if [ ! -f "$(OPENCODE_CONFIG)" ]; then \
|
|
|
|
|
|
echo "找不到 $(OPENCODE_CONFIG),建立新設定檔"; \
|
|
|
|
|
|
mkdir -p $$(dirname "$(OPENCODE_CONFIG)"); \
|
|
|
|
|
|
printf '{\n "provider": {\n "cursor": {\n "npm": "@ai-sdk/openai-compatible",\n "name": "Cursor Agent",\n "options": {\n "baseURL": "http://$(HOST):$(PORT)/v1",\n "apiKey": "unused"\n },\n "models": { "auto": { "name": "Cursor Auto" } }\n }\n }\n}\n' > "$(OPENCODE_CONFIG)"; \
|
|
|
|
|
|
echo "已建立 $(OPENCODE_CONFIG)"; \
|
|
|
|
|
|
elif [ -n "$(API_KEY)" ]; then \
|
|
|
|
|
|
jq '.provider.cursor.options.baseURL = "http://$(HOST):$(PORT)/v1" | .provider.cursor.options.apiKey = "$(API_KEY)"' "$(OPENCODE_CONFIG)" > "$(OPENCODE_CONFIG).tmp" && mv "$(OPENCODE_CONFIG).tmp" "$(OPENCODE_CONFIG)"; \
|
|
|
|
|
|
echo "已更新 $(OPENCODE_CONFIG)(baseURL → http://$(HOST):$(PORT)/v1,apiKey 已設定)"; \
|
|
|
|
|
|
else \
|
|
|
|
|
|
jq '.provider.cursor.options.baseURL = "http://$(HOST):$(PORT)/v1"' "$(OPENCODE_CONFIG)" > "$(OPENCODE_CONFIG).tmp" && mv "$(OPENCODE_CONFIG).tmp" "$(OPENCODE_CONFIG)"; \
|
|
|
|
|
|
echo "已更新 $(OPENCODE_CONFIG)(baseURL → http://$(HOST):$(PORT)/v1)"; \
|
|
|
|
|
|
fi
|
|
|
|
|
|
|
|
|
|
|
|
## 啟動代理並用 curl 同步模型列表到 opencode.json
|
|
|
|
|
|
opencode-models: opencode
|
|
|
|
|
|
@echo "啟動代理以取得模型列表..."
|
|
|
|
|
|
@set -a && . ./$(ENV_FILE) 2>/dev/null; set +a; \
|
|
|
|
|
|
./cursor-api-proxy & PID=$$!; \
|
|
|
|
|
|
sleep 2; \
|
|
|
|
|
|
MODELS=$$(curl -s http://$(HOST):$(PORT)/v1/models | jq '[.data[].id]'); \
|
|
|
|
|
|
kill $$PID 2>/dev/null; wait $$PID 2>/dev/null; \
|
|
|
|
|
|
if [ -n "$$MODELS" ] && [ "$$MODELS" != "null" ]; then \
|
|
|
|
|
|
jq --argjson ids "$$MODELS" 'reduce $ids[] as $id (.; .provider.cursor.models[$id] = { name: $id })' "$(OPENCODE_CONFIG)" > "$(OPENCODE_CONFIG).tmp" && mv "$(OPENCODE_CONFIG).tmp" "$(OPENCODE_CONFIG)"; \
|
|
|
|
|
|
echo "已同步模型列表到 $(OPENCODE_CONFIG)"; \
|
|
|
|
|
|
else \
|
|
|
|
|
|
echo "無法取得模型列表,請確認代理已啟動"; \
|
|
|
|
|
|
fi
|
|
|
|
|
|
|
|
|
|
|
|
## 編譯並用 pm2 啟動
|
|
|
|
|
|
pm2: build
|
|
|
|
|
|
@if [ -f "$(ENV_FILE)" ]; then \
|
|
|
|
|
|
env $$(cat $(ENV_FILE) | grep -v '^#' | xargs) CURSOR_BRIDGE_HOST=$(HOST) CURSOR_BRIDGE_PORT=$(PORT) pm2 start ./cursor-api-proxy --name cursor-api-proxy --update-env; \
|
|
|
|
|
|
else \
|
|
|
|
|
|
CURSOR_BRIDGE_HOST=$(HOST) CURSOR_BRIDGE_PORT=$(PORT) pm2 start ./cursor-api-proxy --name cursor-api-proxy; \
|
|
|
|
|
|
fi
|
|
|
|
|
|
@pm2 save
|
|
|
|
|
|
@echo "pm2 已啟動 cursor-api-proxy(http://$(HOST):$(PORT))"
|
|
|
|
|
|
|
|
|
|
|
|
## 用 pm2 啟動 OpenCode 代理(設定 + 啟動一步完成)
|
|
|
|
|
|
pm2-opencode: opencode pm2
|
|
|
|
|
|
@echo "OpenCode 設定已更新並用 pm2 啟動代理"
|
|
|
|
|
|
|
2026-04-01 04:02:41 +00:00
|
|
|
|
## 寫入 ~/.claude/settings.json(ANTHROPIC_BASE_URL、三個 DEFAULT_* 模型;需 jq)
|
|
|
|
|
|
claude-settings:
|
|
|
|
|
|
@command -v jq >/dev/null 2>&1 || { echo "需要 jq"; exit 1; }
|
|
|
|
|
|
@mkdir -p $$(dirname "$(CLAUDE_SETTINGS)")
|
|
|
|
|
|
@jq -n \
|
|
|
|
|
|
--arg base "http://$(ANTHROPIC_BASE_HOST):$(PORT)" \
|
|
|
|
|
|
--arg token "$(ANTHROPIC_AUTH_TOKEN)" \
|
|
|
|
|
|
--arg sonnet "$(ANTHROPIC_DEFAULT_SONNET_MODEL)" \
|
|
|
|
|
|
--arg opus "$(ANTHROPIC_DEFAULT_OPUS_MODEL)" \
|
|
|
|
|
|
--arg haiku "$(ANTHROPIC_DEFAULT_HAIKU_MODEL)" \
|
|
|
|
|
|
'{ env: { ANTHROPIC_BASE_URL: $$base, ANTHROPIC_AUTH_TOKEN: $$token, ANTHROPIC_DEFAULT_SONNET_MODEL: $$sonnet, ANTHROPIC_DEFAULT_OPUS_MODEL: $$opus, ANTHROPIC_DEFAULT_HAIKU_MODEL: $$haiku } }' \
|
|
|
|
|
|
> "$(CLAUDE_SETTINGS).tmp" && mv "$(CLAUDE_SETTINGS).tmp" "$(CLAUDE_SETTINGS)"
|
|
|
|
|
|
@echo "已寫入 $(CLAUDE_SETTINGS)(BASE_URL=http://$(ANTHROPIC_BASE_HOST):$(PORT))"
|
|
|
|
|
|
|
|
|
|
|
|
## 將 ~/.claude.json 的 hasCompletedOnboarding 設為 true(繞過初次引導;需 jq)
|
|
|
|
|
|
claude-onboarding:
|
|
|
|
|
|
@command -v jq >/dev/null 2>&1 || { echo "需要 jq"; exit 1; }
|
|
|
|
|
|
@test -f "$(CLAUDE_JSON)" || { echo "找不到 $(CLAUDE_JSON)"; exit 1; }
|
|
|
|
|
|
@jq '.hasCompletedOnboarding = true' "$(CLAUDE_JSON)" > "$(CLAUDE_JSON).tmp" && mv "$(CLAUDE_JSON).tmp" "$(CLAUDE_JSON)"
|
|
|
|
|
|
@echo "已設定 $(CLAUDE_JSON) hasCompletedOnboarding=true"
|
|
|
|
|
|
|
|
|
|
|
|
## 一次執行 claude-settings + claude-onboarding
|
|
|
|
|
|
claude-cursor-setup: claude-settings claude-onboarding
|
|
|
|
|
|
@echo "Cursor/Claude Code 本機設定已套用"
|
|
|
|
|
|
|
2026-04-01 00:53:34 +00:00
|
|
|
|
## 編譯並用 pm2 啟動 + 設定 Claude Code 環境變數
|
|
|
|
|
|
pm2-claude-code: pm2
|
|
|
|
|
|
@echo ""
|
|
|
|
|
|
@echo "Claude Code 設定:將以下指令加入你的 shell 啟動檔(~/.bashrc 或 ~/.zshrc):"
|
|
|
|
|
|
@echo ""
|
|
|
|
|
|
@echo " export ANTHROPIC_BASE_URL=http://$(HOST):$(PORT)"
|
|
|
|
|
|
@echo " export ANTHROPIC_API_KEY=$(if $(API_KEY),$(API_KEY),dummy-key)"
|
|
|
|
|
|
@echo ""
|
|
|
|
|
|
@echo "或在當前 shell 執行:"
|
|
|
|
|
|
@echo ""
|
|
|
|
|
|
@echo " export ANTHROPIC_BASE_URL=http://$(HOST):$(PORT)"
|
|
|
|
|
|
@echo " export ANTHROPIC_API_KEY=$(if $(API_KEY),$(API_KEY),dummy-key)"
|
|
|
|
|
|
@echo " claude"
|
|
|
|
|
|
@echo ""
|
|
|
|
|
|
|
|
|
|
|
|
## 停止 pm2 中的代理
|
|
|
|
|
|
pm2-stop:
|
|
|
|
|
|
pm2 stop cursor-api-proxy 2>/dev/null || echo "cursor-api-proxy 未在執行"
|
|
|
|
|
|
|
|
|
|
|
|
## 查看 pm2 日誌
|
|
|
|
|
|
pm2-logs:
|
|
|
|
|
|
pm2 logs cursor-api-proxy
|
|
|
|
|
|
|
2026-03-31 01:26:33 +00:00
|
|
|
|
## 顯示說明
|
|
|
|
|
|
help:
|
|
|
|
|
|
@echo "可用目標:"
|
2026-04-01 00:53:34 +00:00
|
|
|
|
@echo " make env 產生 .env(先在 Makefile 頂端填好變數)"
|
|
|
|
|
|
@echo " make build 編譯 cursor-api-proxy 二進位檔"
|
|
|
|
|
|
@echo " make run 編譯並載入 .env 執行"
|
|
|
|
|
|
@echo " make pm2 編譯並用 pm2 啟動代理"
|
|
|
|
|
|
@echo " make pm2-stop 停止 pm2 中的代理"
|
|
|
|
|
|
@echo " make pm2-logs 查看 pm2 日誌"
|
|
|
|
|
|
@echo " make pm2-claude-code 啟動代理 + 輸出 Claude Code 設定指令"
|
|
|
|
|
|
@echo " make opencode 編譯並設定 OpenCode(更新 opencode.json)"
|
|
|
|
|
|
@echo " make pm2-opencode 設定 OpenCode + 啟動代理"
|
|
|
|
|
|
@echo " make opencode-models 編譯、設定 OpenCode 並同步模型列表"
|
2026-04-01 04:02:41 +00:00
|
|
|
|
@echo " make claude-settings 寫入 ~/.claude/settings.json(模型與 BASE_URL)"
|
|
|
|
|
|
@echo " make claude-onboarding 設定 ~/.claude.json hasCompletedOnboarding=true"
|
|
|
|
|
|
@echo " make claude-cursor-setup 同上兩步一次完成"
|
2026-04-01 00:53:34 +00:00
|
|
|
|
@echo " make clean 刪除二進位檔與 .env"
|
2026-03-31 01:26:33 +00:00
|
|
|
|
@echo ""
|
|
|
|
|
|
@echo "覆寫範例:"
|
|
|
|
|
|
@echo " make env PORT=9000 API_KEY=mysecret TIMEOUT_MS=60000"
|
2026-04-01 00:53:34 +00:00
|
|
|
|
@echo " make pm2-claude-code PORT=8765 API_KEY=mykey"
|
|
|
|
|
|
@echo " make pm2-opencode PORT=8765"
|
2026-04-01 04:02:41 +00:00
|
|
|
|
@echo " make claude-settings PORT=8766 ANTHROPIC_BASE_HOST=localhost ANTHROPIC_DEFAULT_OPUS_MODEL=claude-4.6-opus-high"
|