diff --git a/docker-compose.yml b/docker-compose.yml
index 7aebc0e..c8404aa 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -19,6 +19,9 @@ services:
       OPENCODE_MODE: embedded
       OPENCODE_HOSTNAME: 0.0.0.0
       OPENCODE_PORT: 4096
+      # Client 模式：连接外部服务地址，不依赖容器内 CLI
+      # OPENCODE_MODE: client
+      # OPENCODE_CLIENT_BASE_URL: "http://host.docker.internal:4096"
     volumes:
       - /home/ubuntu/.config/opencode:/root/.config/opencode
       - /home/ubuntu/.local/share/opencode:/root/.local/share/opencode
diff --git a/package.json b/package.json
index fdc5fc1..98f140e 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
     "install:opencode": "bun install --cwd .opencode",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "typecheck:opencode": "bun run --cwd .opencode typecheck",
-    "dev": "bun run typecheck:opencode && bun --watch src/server.ts",
+    "dev": "bun --watch src/server.ts",
     "build": "bun run check",
     "check": "bun run typecheck && bun run typecheck:opencode",
     "start": "bun src/server.ts",