CodexMobile

Install

本地安裝

1. 建立 Python 環境

cd <repo-root>
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -e .

2. 建立設定檔

cp .env.example .env

先填好 CODEXMOBILE_APP_API_TOKEN、 CODEXMOBILE_MAC_SERVICE_TOKEN、 CODEXMOBILE_PUBLIC_API_URL。

3. 啟動核心服務

source .venv/bin/activate
codexmobile
codexmobile-app-api
codexmobile-mac-service

4. 手機端接入

在手機端填入 API URL 與 Token，或透過 Mac 端配對流程自動寫入。

Token 要怎麼取得

CODEXMOBILE_APP_API_TOKEN

這是手機端連 VPS API 用的 Token。你需要在 VPS 的 .env 裡自行生成並填入，再把同一個值填到手機端。

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

CODEXMOBILE_MAC_SERVICE_TOKEN

這是 VPS Relay 連回 Mac 本機服務時使用的內部 Token。Mac 與 VPS 兩端必須使用同一個值。

python3 -c "import secrets; print(secrets.token_urlsafe(32))"

本地安裝完成後要確認的事

  1. Mac 菜單欄已啟動，並且顯示連線正常。
  2. VPS API URL 可從手機瀏覽器打開。
  3. 手機端已填入正確的 API URL 與 APP API TOKEN。
  4. 手機端和桌面端可以打開同一個項目會話。

建議先設定專案根目錄

如果你希望手機端「新建項目」時，直接在固定根目錄底下建立專案，請先在桌面端或服務設定中指定一個專案根目錄。例如： 

/Users/<your-user>/APPtest

這樣手機端只需要輸入專案名稱，例如 test01，就可以在該根目錄下建立： 

/Users/<your-user>/APPtest/test01