claude code 国内使用注意事项

# copilot-instructions

## 一、项目上下文

### 项目简介（示例）

xxxx 是 yyyy，主要功能是 zzzz。

### 技术栈（示例）

- **框架**：Next.js 15 (App Router, RSC)
- **语言**：TypeScript 严格模式（`strict: true`）
- **UI 组件库**：shadcn/ui (new-york style) + Radix UI + Tailwind CSS v4
- **状态管理**：React 内置状态 + `useChat` hook (`@ai-sdk/react`)
- **路由**：Next.js App Router (`app/` 目录)
- **构建**：Next.js 内置 (Turbopack dev)
- **Lint/格式化**：ESLint (next/core-web-vitals + next/typescript)
- **包管理器**：pnpm
- **工具库**：
  - `react-resizable-panels` — 可拖拽调整大小的面板

### 目录结构

```text

```

### 关键架构细节

1. xxx
2. yyy

### 编码约定（示例）

- 使用项目根目录别名 `@/*`。
- 使用 Tailwind utility classes 和 `cn()` 合并 class。
- 使用函数组件和 hooks，不使用 class 组件。
- 使用 `async/await`，不使用 `.then()` 链。
- 导入顺序：React/Next → 第三方库 → 本地模块 → 类型。

### Commit 规范

遵循 Conventional Commits：`type(scope): description`

- **type**：`feat` / `fix` / `docs` / `style` / `refactor` / `perf` / `test` / `build` / `ci` / `chore` / `revert`
- **scope**：`layout` / `chat` / `vnc` / `event-store` / `debug-panel` / `tool-viz` / `api` / `components` / `types` / `utils` / `config`
- 允许使用中文 commit message。

### 语言偏好

- 变量名、函数名、类型名：英文
- 代码注释：英文
- 与用户对话：中文

---

## 二、禁止事项

- 不使用 `any`，改用 `unknown` 或明确类型。
- 不使用 `moment`，改用 `dayjs`；不使用 `lodash`，改用 `lodash-es`。
- 未经用户明确要求，不引入新的第三方依赖。
- 未经明确要求，不生成 changelog、总结文档或交接文档。
- 不移除现有功能，VNC、聊天和流式传输必须保持可用。
- 不破坏现有 `POST /api/chat` 的请求与响应契约。

---

## 三、行为准则

### 编码前先思考

- 明确说明假设。
- 如果存在多种解释，不要默默选择，直接列出。
- 如果有更简单的方法，直接指出。
- 如果关键点不清楚，先停下来确认。

### 保持简洁

- 用最少的必要代码解决问题。
- 避免推测性抽象和不必要的灵活性。

### 精准修改

- 只修改必要部分。
- 保持现有代码风格。
- 如果改动导致某些导入、变量或函数不再使用，顺手删除。
- 每一行改动都必须直接服务于当前任务。

### 自行验证

- 回读修改后的代码，确认逻辑完整。
- 检查类型是否正确，确保没有隐式 `any`。
- 多步骤任务按步骤完成并逐步验证。
- 修 bug 时先理解根因，再验证原始场景已被覆盖。

本机
  ↓
sing-box（统一代理出口，监听 7890）
  ↓
机场节点（翻墙 + obfs 混淆）
  ↓
静态 ISP 代理（美国住宅 IP 出口）
  ↓
目标网站（Claude、GitHub 等）

brew install sing-box
brew install obfs4proxy  # 提供 obfs-local 插件

{
  "log": {
    "level": "info"
  },
  "inbounds": [
    {
      "type": "mixed",
      "tag": "in",
      "listen": "127.0.0.1",
      "listen_port": 7890,
      "sniff": true,
      "sniff_override_destination": true
    }
  ],
  "outbounds": [
    {
      "type": "direct",
      "tag": "direct"
    },
    {
      "type": "shadowsocks",
      "tag": "airport",
      "server": "机场节点 IP，如 1.1.1.1",
      "server_port": 机场节点端口,
      "method": "机场节点加密方式",
      "password": "机场节点密码",
      "plugin": "obfs-local",
      "plugin_opts": "obfs=http;obfs-host=84Ynf0aa6L.microsoft.com"
    },
    {
      "type": "socks",
      "tag": "residential",
      "server": "静态 ISP 代理 IP",
      "server_port": 静态 ISP 代理端口,
      "version": "5",
      "username": "用户名",
      "password": "密码",
      "detour": "airport"
    }
  ],
  "route": {
    "final": "residential"
  }
}

sudo sing-box run -c ~/sing-box/config.json

INFO[0000] network: updated default interface en0, index 6
INFO[0000] inbound/mixed[in]: tcp server started at 127.0.0.1:7890
INFO[0000] sing-box started (0.00s)

export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export all_proxy="socks5://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5://127.0.0.1:7890"

协议：SOCKS5
地址：127.0.0.1
端口：7890

curl -I https://www.google.com

curl ipinfo.io