【从能人智工到人工智能】第零篇——环境初始化

先点击右边按钮展开。

再点击右边按钮配置。

把 自动挂载磁盘，处理/etc/fstab，启用 Windows 交互，追加 Windows 路径 ,四个默认勾选全部取消掉，然后点击保存并重启发行版。

最终配置如下

打开文件管理器

进入etc

打开wsl.conf编辑

添加

[automount]
enabled = false
mountFsTab = false
 
[interop]
enabled = false
appendWindowsPath = false

使用 PowerShell 重启

wsl --shutdown

1. 获取 Windows 主机 IP

cat /etc/resolv.conf | grep nameserver | awk '{print $2}'

2. 点击 WSL Dashboard 的侧栏网络进行配置，记得保存

3. 重启实例可以通过下面命令看是否配置成功

env | grep -i proxy

4. 如果报错了 Connection refused，记得看局域网代理有没有打开，一般默认是只监听127.0.0.1

设置中文语言环境

1. 执行 locale 命令查看当前系统语言配置，如果是 LANG=zh_CN.UTF-8 就不用继续配置
   否则编辑 /etc/locale.gen 文件，将以下配置放开，去除前面的 # 注释就可以，我这里是在165行和505行，如果你和我一样安装的 Ubuntu

en_US.UTF-8 UTF-8

zh_CN.UTF-8 UTF-8

否则的话 Debian 仓库里可能默认没有这个文件，需要安装，然后编辑 /etc/locale.gen 文件把 en_US.UTF-8 UTF-8 放开

sudo apt install -y language-pack-zh-hans

2. 然后生成语言环境缓存

sudo locale-gen

3. 执行 echo $LANG 查看是否是 zh_CN.UTF-8，如果不是参考上面可以在 $HOME/.bashrc 或 $HOME/.zshrc 等文件中添加

export LANG=zh_CN.UTF-8

设置默认中文字体

1. 安装字体文件
   我这里是使用思源黑体/宋体和 Maple Mono NF CN

安装 思源黑体/宋体

sudo apt install -y fonts-noto-cjk fonts-noto-cjk-extra

安装 Maple Mono NF CN
这里选择安装 v7.9，等 v8.0 完善了再安装，可以先安装到 Windows ，解压出来
进入/usr/share/fonts，新建一个文件夹maple-mono-nf-cn，直接把解压出来的所有 .ttf 复制到里面

刷新缓存并验证

fc-cache -fv
fc-list | grep -i "Maple Mono NF CN" | head -5

2. 修改系统默认字体。添加配置文件 ~/.config/fontconfig/fonts.conf 或 /etc/fonts/local.conf，内容如下：

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>

  <!-- 默认 sans-serif → 思源黑体 -->
  <match target="pattern">
    <test qual="any" name="family"><string>sans-serif</string></test>
    <edit name="family" mode="assign" binding="same">
      <string>Noto Sans CJK SC</string>
    </edit>
  </match>

  <!-- 默认 serif → 思源宋体 -->
  <match target="pattern">
    <test qual="any" name="family"><string>serif</string></test>
    <edit name="family" mode="assign" binding="same">
      <string>Noto Serif CJK SC</string>
    </edit>
  </match>

  <!-- 默认 monospace → Maple Mono NF CN -->
  <match target="pattern">
    <test qual="any" name="family"><string>monospace</string></test>
    <edit name="family" mode="assign" binding="same">
      <string>Maple Mono NF CN</string>
    </edit>
  </match>

</fontconfig>

刷新缓存

fc-cache -fv

验证映射生效，只要这三个都指向了你配置的字体，配置就没问题

fc-match sans-serif
fc-match serif
fc-match monospace

设置完可以再试试使用下面命令看看中文是否正常

yad --title "WSLg Test" --text "WSLg GUI正常！"

1. Git
   查看是否安装

git -v

提示bash: git: command not found代表没有安装，通过下面命令安装

sudo apt install -y git

2. Python
   查看是否安装或者使用python3 -V也是可以的(要大写V)

python3 --version

提示bash: python3: command not found代表没有安装，通过下面命令安装

sudo apt install -y python3

直接使用python --version会报错，需要把python链接到python3

apt install -y python-is-python3

这时候使用python不带3就正常了

python --version

3. Node
   查看是否安装

node -v

正常新环境是会报错提示`Command 'node' not found，参考 Node官网命令 安装

# 下载并安装 nvm：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 代替重启 shell
\. "$HOME/.nvm/nvm.sh"
# 下载并安装 Node.js：
nvm install 24
# 验证 Node.js 版本：
node -v
# 验证 npm 版本：
npm -v

4. Tmux
   查看是否安装

tmux -V

提示bash: tmux: command not found代表没有安装，通过下面命令安装

sudo apt install -y tmux

5. uv
   查看是否安装或者使用uv -V也是可以的(要大写V)

uv --version

提示bash: uv: command not found代表没有安装，通过下面命令安装

curl -LsSf https://astral.sh/uv/install.sh | sh

6. ripgrep
   查看是否安装或者使用rg -V也是可以的(要大写V)

rg --version

提示bash: rg: command not found代表没有安装，通过下面命令安装

sudo apt install ripgrep

7. unzip
   查看是否安装

unzip -v

提示bash: unzip: command not found代表没有安装，通过下面命令安装

sudo apt install -y unzip

8. bun
   查看是否安装

bun -v

提示bash: bun: command not found代表没有安装，通过下面命令安装

curl -fsSL https://bun.com/install | bash

9. 安装 GitHub CLI

• 添加官方 GPG 密钥，软件源，最后更新并安装，参考官方安装文档

(type -p wget >/dev/null || (sudo apt update && sudo apt install wget -y)) \
	&& sudo mkdir -p -m 755 /etc/apt/keyrings \
	&& out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
	&& cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
	&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
	&& sudo mkdir -p -m 755 /etc/apt/sources.list.d \
	&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
	&& sudo apt update \
	&& sudo apt install gh -y

• 安装成功验证

gh --version

• 认证登录（在 WSL 建议使用 token 登录，简单一点）

gh auth login

• 验证登录

gh auth status

• Git 认证

gh auth setup-git

• 验证 Git 认证

printf "protocol=https\nhost=github.com\n\n" | git credential fill

• 先新建一个上游
• 可以新建一个key(用默认的也可以)
• 在“路由”页面上，打开默认密钥使用的路由或者新建一个路由，然后 “添加规则”

• 添加转发规则：条件 “模型” ，然后输入 *claude* 。 * 匹配任何字符，匹配不区分大小写。
• 在 “转发至” 下，选择 “指定型号” ，选择上游并输入型号名称。可以添加备份，备份将按顺序尝试。将该规则置于任何其他匹配项之上。参考 官方说法
• 改写参数可以设置恒定推理参数，解决 Claude Code 使用第三方模型的一些不支持的推理参数并且更好的支持 Ultracode

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_THRIFTY_SONIC": "0",
    "CLAUDE_CODE_NEW_INIT": "1",
    "MCP_TIMEOUT": "60000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_AUTH_TOKEN": "sk-you-token-to-here",
    "ANTHROPIC_BASE_URL": "https://anyrouter.top",
    "ANTHROPIC_MODEL": "opus[1m]"
  },
  "cleanupPeriodDays": 9999,
  "alwaysThinkingEnabled": true,
  "autoDreamEnabled": true,
  "attribution": {
    "commit": "",
    "pr": ""
  },
  "permissions": {
    "allow": [
      "Bash",
      "Edit",
      "Glob",
      "Grep",
      "KillShell",
      "LS",
      "LSP",
      "MultiEdit",
      "NotebookEdit",
      "NotebookRead",
      "Read",
      "Skill",
      "Task",
      "TaskCreate",
      "TaskGet",
      "TaskList",
      "TaskOutput",
      "TaskStop",
      "TaskUpdate",
      "TodoWrite",
      "ToolSearch",
      "WebFetch",
      "WebSearch",
      "Write"
    ],
    "deny": []
  },
  "outputStyle": "default",
  "statusLine": {
    "type": "command",
    "command": "ccstatusline-zh",
    "padding": 0,
    "refreshInterval": 10
  }
}