windows 11 wsl cc 开发环境备忘

0x00 TLDR

尝试了几天Linux 主机远程开发，还是有点不方便，今天 直接在 windows 11 的 wsl 环境下，构建cc开发环境。
至少，生成的代码在windows 环境下，还可以同步使用IDEA进行查看

• 补充
  windows 11 下，在 Microsoft Store 中安装 Fluent Terminal、Ubuntu 24.04 LTS

0x01 wsl

本文使用 ubuntu 22.04
更新 /etc/apt/sources.list 内容

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse    

• 补充 24.04

deb https://mirrors.aliyun.com/ubuntu/ noble main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ noble main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ noble-security main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ noble-security main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ noble-updates main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ noble-updates main restricted universe multiverse

# deb https://mirrors.aliyun.com/ubuntu/ noble-proposed main restricted universe multiverse
# deb-src https://mirrors.aliyun.com/ubuntu/ noble-proposed main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ noble-backports main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ noble-backports main restricted universe multiverse

然后刷新镜像源列表: sudo apt update
安装一个测试依赖:

sudo apt install unzip

0x02 fnm、node、npm

• 安装 fnm:
  curl -fsSL https://fnm.vercel.app/install | bash
  初始化fnm 文件变量，手动执行 fnm env ，把结果放到 ~/.bashrc

• 安装 node:

# 安装最新版 node
fnm install --latest
# 查看已安装列表
fnm list 
# 激活当前使用中的
fnm use 25.2.1
# 设置默认版本
fnm default 25.2.1

可以打开一个新的 wsl窗口验证一下:

node -v
npm -v

配置两个加速：

• fnm 加速: export FNMR_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/fnm
• node 加速 npm config set registry https://registry.npmmirror.com

0x03 java

sudo apt install openjdk-17-jdk -y
sudo apt install maven -y
sudo apt install mysql-server-8.0 

配置 maven 加速, 这里默认不使用私库，全部使用主仓库
vim ~/.m2/settings.xml

<settings>
  <mirrors>
    <mirror>
      <id>aliyunmaven</id>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
      <mirrorOf>*</mirrorOf>
    </mirror>                                                                                                                               </mirrors>
</settings>  

0x04 Claude Code

npm install -g @anthropic-ai/claude-code
npm install -g @fission-ai/openspec@latest

配置使用智谱AI的API给cc使用

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN="zhipu api key"

0x05 MCP

本地 mysql 数据库操作 mcp.

• 下载mcp源码，手动安装

git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql
npm i
npm run build

• 在某个目录下，启动过 claude
• 编辑 ~/.claude.json, 找到上述目录相关的配置处，更新 mcpServer字段

      "mcpServers": {
        "mcp-server-mysql": {
          "command": "node",
          "args": [
            "{your_path}/mcp-server-mysql/dist/index.js"
          ],
          "env": {
            "MYSQL_HOST": "127.0.0.1",
            "MYSQL_PORT": "3306",
            "MYSQL_USER": "user",
            "MYSQL_PASS": "123456",
            "MYSQL_DB": "demo",
            "ALLOW_INSERT_OPERATION": "true",
            "ALLOW_DDL_OPERATION": "true",
            "ALLOW_UPDATE_OPERATION": "true",
            "ALLOW_DELETE_OPERATION": "true"
          }
        }
      },

2025/12/29更新：
把上述内容，放到 ~/.claude.json 的顶级位置，即可完成全局配置。

0x06 Rust 安装

• 配置加速源

export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup
export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup

• 上述配置生效后，使用阿里云的源进行在线安装：

curl --proto '=https' --tlsv1.2 -sSf https://mirrors.aliyun.com/repo/rust/rustup-init.sh | sh

• 配置 crates 加速, ~/.cargo/config.toml

[source.crates-io]
replace-with = 'aliyun'

[source.aliyun]
registry = "sparse+https://mirrors.aliyun.com/crates.io-index/"

• 安装交叉编译 工具
  下载安装 zig ： https://ziglang.org/download/，

cargo install --locked cargo-zipbuild

• 验证

rustup target add x86_64-pc-windows-msvc
cargo zigbuild -v --release --target x86_64-pc-windows-msvc

0x07 Vibe Coding

差不多了，接下来就可以开工写代码了。
记得常用一句: 解决 mvn spring-boot:run 编译错误

0x08 补充,github 加速

在地址前面加 https://gh-proxy.org/
git clone https://gh-proxy.org/https://github.com/benborla/mcp-server-mysql.git

阿里去加速配置中心： https://developer.aliyun.com/mirror/

0x09 bun 环境安装

从国内镜像源安装 bun

curl -fsSL https://gitee.com/akirarika/bun-cn/raw/main/install.sh | bash -
bun --version

配置镜像加速
vim ~/.bunfig.toml

[install]
registry = "https://registry.npmmirror.com/"     

0x0A Claude Code增加 Hook 配置

使用场景, vibe code 一般来说会需要数分钟时间。需要在完成的时间点发送消息通知用户。此时，可以通过 Stop Hook 来完成。

vim ~/.claude/settings.json

{
    "hooks": {
        "Stop": [
        {
            "matcher": "",
                "hooks": [
                {
                    "type": "command",
                    "command": "bash ~/.claude/hooks/weixin_notify.sh"
                }
                ]
        }
        ]
    }
}

0x0B 精简指令列表（2026/1/8更新)

npm install -g @anthropic-ai/claude-code
npm install -g @fission-ai/openspec@latest
npm install -g uipro-cli

mkdir work_dir
cd work_dir
openspec init
claude # 执行 openspec init 最后一段话，生成opensec 初始文件
vim openspec/project.md # 手动添加技术栈
uipro init --ai claude # 导入 ui-ux-pro-max ，用于UI风格控制
npx vibe-kanban # 多任务管理看板

0x0C tmux

参考: https://go.lightnode.com/zh/tech/install-tmux-on-ubuntu