AI 编程 Claude Code

安装部署

面向 Windows 11 + WSL (Ubuntu) 用户的“Claude Code + Kimi K2”从零到一完整落地流程

前置检查

在 Windows 终端里执行 wsl -l -v
确保你有一个 Ubuntu 22.04/24.04 且状态为 Running。
在 Ubuntu Shell 里执行 `node -v`
若返回 v18↑ 则跳过下一步；否则继续。

安装/升级 Node.js（Ubuntu 内）

sudo apt update && sudo apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

- 验证：node -v 应 ≥ 18。

安装 Claude Code（全局）

sudo npm install -g @anthropic-ai/claude-code

- 验证：claude –version

能输出版本号即可

获取 Kimi K2 API Key

浏览器打开 [https://platform.moonshot.cn](https://platform.moonshot.cn)

• 注册 / 登录 → 右上角「API Keys」→ 「Create new」

  • 复制形如 `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` 的 Key。  
  （新账号有 15 元免费额度，用完再充值即可）

配置环境变量（WSL Ubuntu）

- 一次性方式（适合测试）

export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
claude

- 如果想「永久生效」，把上面两行追加到 ~/.bashrc，以后只需输入 claude 即可启动：

echo 'export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' >> ~/.bashrc
source ~/.bashrc

- ps: 如果设置 ANTHROPIC_API_KEY 没有用，要设置 ANTHROPIC_AUTH_TOKEN

首次启动 & 权限提示

- 第一次运行会提示是否允许读写代码目录，选 Yes。

如遇到权限报错，加 –dangerously-skip-permissions：

claude --dangerously-skip-permissions

在Linux中运行网页服务

需要通过浏览器访问生成的网页：

第一步：在 WSL Ubuntu 中启动 Node.js 服务

假设 Claude Code 生成的项目目录为 ~/my-web，并且已经包含 package.json：

cd ~/my-web
npm install          # 安装依赖
npm run dev          # 或 npm start，具体看 package.json 中的脚本

如果项目没有 dev 脚本，也可以用 npx serve 或 npx http-server 临时起一个服务。

经测试：npx serve 这个挺好使

第二步：让服务监听所有网络接口（不限于 localhost）

默认情况下，很多 Node.js 框架（如 Vite、Next.js、Express）只监听 localhost， 只能本机访问。你需要让它监听 0.0.0.0，这样其他设备才能通过 IP 访问。

常见框架配置方式：

框架/工具	启动命令示例	监听地址说明
Vite	npm run dev – –host 0.0.0.0	自动绑定到 `0.0.0.0:5173`
Next.js	npm run dev	默认监听 `0.0.0.0:3000`
Express（自定义）	app.listen(3000, '0.0.0.0')	手动设置监听地址
http-server	npx http-server -p 8080 -a 0.0.0.0	明确指定地址和端口

第三步：获取 WSL 的 IP 地址（用于其他 Windows 终端访问）

在 WSL Ubuntu 中运行：

ip addr | grep eth0

你会看到类似：inet 172.28.120.45/20

记下这个 IP，比如 `172.28.120.45`。

第四步：在 Windows 或其他终端访问

打开浏览器，输入：http://172.28.120.45:3000

如果端口不是 3000，请根据实际服务端口修改。

可选：防火墙设置（如无法访问）

如果你在 Windows 上启用了防火墙，可能需要放行对应端口：

打开“Windows Defender 防火墙” → 高级设置 → 入站规则 → 新建规则 → 端口 → TCP → 输入端口号 → 允许连接。

总结一句话

在 WSL 中运行 npm run dev – –host 0.0.0.0，拿到 WSL 的 IP 地址后，其他 Windows 终端就能通过浏览器访问 http://WSL_IP:端口查看 Claude Code 生成的网页了。

在Windows中直接访问WSL Ubuntu Linux 中的文件

在Windows中，可以通过多种方式访问WSL（Windows Subsystem for Linux）中的文件系统。以下是常用方法及示例：

方法一：通过文件资源管理器访问

打开Windows文件资源管理器
在地址栏中输入 \\wsl$，然后按回车键
选择你需要访问的WSL发行版（例如Ubuntu）
导航到 /home/your_username 目录，即可查看和操作WSL中的文件。

示例：\\wsl$\Ubuntu\home\your_username

目录