WSL+Ubuntu + AI (Claude, SpecKit, iFlow) 常用命令

目录

• WSL 命令
  • 升级并查看 WSL 版本
• Ubuntu 命令
  • 系统升级
  • 挂载fstab
  • 常用rsync同步命令
  • 常用npm命令
  • nrm命令 (npm加速镜像管理)
  • 下载并安装deb包
  • 卸载deb包
• Claude 命令
  • Claude 配置 API
  • HTTP代理设置
  • 常用命令
  • Add MCP
    • MCP服务器作用域
    • 添加MCP服务器
    • 常用MCP
• Claude code 安装
• 添加完会显示:File modified: /root/.claude.json [project: /opt/claude]
• iFlow安装
• 项目范围安装
• 全局安装
• Context7 的使用非常直观，只需在提示中添加 use context7 即可触发服务器。
  • • 查看已安装的MCP服务器
    • 删除MCP服务器
    • 测试MCP服务器
    • 查看MCP状态
  • Claude URL
• Spec-Kit命令
  • 核心命令:规范驱动开发工作流程的基本命令：
  • 可选命令:用于提高质量和验证的其他命令：

WSL 命令

升级并查看 WSL 版本

#在PowerShell中运行以下命令：
wsl --version
wsl --update
wsl --shutdown #关闭WSL
wsl #打开WSL

#示例：
PS C:\Users\JohnC> wsl --version
WSL 版本: 2.5.9.0
内核版本: 6.6.87.2-1
WSLg 版本: 1.0.66
MSRDC 版本: 1.2.6074
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows: 10.0.26200.6899
PS C:\Users\JohnC> wsl --update
正在检查更新。
正在更新适用于 Linux 的 Windows 子系统: 2.6.1。

PS C:\Users\JohnC> wsl --version
WSL 版本: 2.6.1.0
内核版本: 6.6.87.2-1
WSLg 版本: 1.0.66
MSRDC 版本: 1.2.6353
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows: 10.0.26200.6899
PS C:\Users\JohnC>

Ubuntu 命令

系统升级

sudo apt update && apt upgrade -y

挂载fstab

sudo nano /etc/fstab
示例代码：
# UNCONFIGURED FSTAB FOR BASE SYSTEM
# //192.168.123.105/Public/myCode /mnt/wd_mycode cifs credentials=/etc/samba/credentials_wd,vers=3.0,uid=1000,gid=1000 0 0
# //192.168.123.104/MyCode3 /mnt/nas_mycode cifs credentials=/etc/samba/credentials_nas,vers=3.0,uid=1000,gid=1000 0 0
# /root/.nvm/versions/node/v24.7.0/bin  /mnt/d/MyData/CherryStudio/claude  none  bind  0  0


#测试挂载是否成功
sudo mount -a

常用rsync同步命令

rsync -av /mnt/wd_mycode/mystocks_spec/ /opt/claude/mystocks_spec/
rsync -av /opt/claude/AIstock/ /opt/claude/mystocks_spec/temp/
rsync -av /mnt/wd_mycode/mystocks_spec/ /opt/claude/mystocks_spec/
rsync -av /mnt/d/Download/CSDN/tdxpy/ /opt/claude/mystocks_spec/temp/

常用npm命令

npm cache clean --force

nrm命令 (npm加速镜像管理)

npm registry manager can help you switch different npm registries easily and quickly

#安装命令
(stock) root@Desktop-CLF:/opt/iflow# npm install -g nrm
added 31 packages in 9s
6 packages are looking for funding
  run `npm fund` for details

(stock) root@Desktop-CLF:/opt/iflow# nrm ls
* npm ---------- https://registry.npmjs.org/
  yarn --------- https://registry.yarnpkg.com/
  tencent ------ https://mirrors.tencent.com/npm/
  cnpm --------- https://r.cnpmjs.org/
  taobao ------- https://registry.npmmirror.com/
  npmMirror ---- https://skimdb.npmjs.com/registry/
  huawei ------- https://repo.huaweicloud.com/repository/npm/
(stock) root@Desktop-CLF:/opt/iflow# nrm test
* npm ---------- 805 ms
  yarn --------- 824 ms
  tencent ------ 1116 ms
  cnpm --------- 1145 ms
  taobao ------- 295 ms
  npmMirror ---- 1719 ms (Fetch error, if this is your private registry, please ignore)
  huawei ------- 563 ms
(stock) root@Desktop-CLF:/opt/iflow# nrm use taobao
 SUCCESS  The registry has been changed to 'taobao'.

下载并安装deb包

(stock) root@Desktop-CLF:/opt/claude/download# wget https://prod.download.desktop.kiro.dev/releases/202510142329--distro-linux-x64-deb/202510142329-distro-linux-x64.deb
...
Saving to: ‘202510142329-distro-linux-x64.deb’
202510142329-distro-linux-x64.deb   100%[===================================================================>] 177.00M  10.5MB/s    in 20s
2025-10-17 12:08:43 (9.05 MB/s) - ‘202510142329-distro-linux-x64.deb’ saved [185603480/185603480]

(stock) root@Desktop-CLF:/opt/claude/download# sudo dpkg -i 202510142329-distro-linux-x64.deb

若安装时提示 “依赖关系未满足”（常见错误），使用 apt 修复：

bash
sudo apt -f install

该命令会自动安装缺失的依赖，并完成 .deb 包的配置。

卸载deb包

方法一：直接通过原 .deb 文件查看其内置的包名：
dpkg -I 202510142329-distro-linux-x64.deb | grep "Package:"
再用sudo apt remove --purge 包名

方法二：已知包名称
首先需要明确 .deb 包实际安装的软件包名称（可能是 kiro 或类似名称，比如 kiro-linux-x64），执行以下命令查询：
bash
dpkg -l | grep -i kiro
卸载后，清理不再需要的依赖和缓存：
bash
sudo apt autoremove -y # 移除无用依赖
sudo apt autoclean # 清理缓存的安装包

再次查询包状态，确认已卸载：
bash
dpkg -l | grep -i kiro

Claude 命令

原厂手册:https://docs.claude.com/en/docs/intro
国内翻译:https://gaccode.com/document/claude-code-best-practices-zh

Claude 配置 API

# 对于 bash (默认)
cd your-project-folder

#基础配置
# 设置API密钥（如果需要）
export ANTHROPIC_API_KEY=your_api_key
# 设置自定义模型
export ANTHROPIC_MODEL=claude-3-5-sonnet-20241022
# 设置基础URL（用于代理）
export ANTHROPIC_BASE_URL=https://your-proxy.com/v1

#持久化配置
echo 'export ANTHROPIC_BASE_URL="https://claude-code.club/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-token"' >> ~/.bashrc
source ~/.bashrc
claude

HTTP代理设置

# 设置代理
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# 设置npm代理
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

常用命令

#启动命令
命令	功能	示例
claude	启动交互模式	claude
claude -p "任务"	快速执行单个任务	claude -p "创建一个React组件"
claude --continue	继续上次对话	claude -c
claude --resume	选择历史对话	claude -r
claude --help	显示帮助信息	claude -h
claude --version	显示版本信息	claude -v

#会话内命令
/compact	压缩对话上下文	保留核心信息，节省Token
/clear	清除对话历史	完全重置当前对话
/history	查看历史对话	选择之前的对话继续
/edit	编辑记忆文件	修改用户或项目记忆
/model	切换AI模型	选择不同的Claude模型
/help	显示帮助	查看所有可用命令
/exit	退出Claude Code	返回普通终端

Add MCP

https://docs.claude.com/en/docs/claude-code/mcp
https://platform.iflow.cn/mcp

MCP服务器作用域

作用域 配置位置 适用场景 命令标志
Local 当前目录 项目特定工具 默认
User ~/.claude.json 全局常用工具 -s user
Project .mcp.json 团队共享工具 -s project

添加MCP服务器

方法1：命令行添加（推荐新手）
# 基本语法
claude mcp add <名称> [选项] -- <命令> [参数...]

方法2：编辑配置文件（推荐高级用户）

{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
      "env": {}
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

方法三：git-mcp 把一切都变成MCP（我也不知道咋用）
使用git-mcp：https://github.com/idosal/git-mcp
GitMCP，全称是Git Model Context Protocol，它是一个免费、开源的远程服务器。简单来说，它的核心功能就是将任何一个GitHub项目（无论是代码仓库还是GitHub Pages页面），都变成一个可以被AI工具直接访问和理解的“文档中心”。你甚至可以把它想象成一个为AI量身定制的“GitHub实时百科全书”，让你的AI助手能够随时随地获取到项目最新、最准确的文档和代码。它通过实现了Model Context Protocol (MCP) 这个标准，让支持该协议的AI工具，比如Cursor、Claude Desktop等，能够像调用本地工具一样，向GitMCP请求项目相关的信息。这样一来，AI就不再受限于训练数据的时效性，可以直接从GitHub这个“源头活水”里获取知识，大大减少了AI生成内容时的“幻觉”现象。

以 Claude 为例，配置步骤如下：

    打开 Claude 的配置文件（通常是 claude_config.json）。
    添加 GitMCP 服务器地址：

    {
    "mcpServers": {
    "gitmcp": {
    "command": "https://gitmcp.io/{owner}/{repo}",
    "args": [],
    "env": {}
    }
    }
    }

    将 {owner} 和 {repo} 替换为你的 GitHub 用户名和仓库名，比如 octocat 和 Hello-World。
    保存配置，Claude 即可通过 GitMCP 访问项目。

#参考：https://www.kdjingpai.com/gitmcp/

常用MCP

0. Context7 MCP Server
官网：https://context7.com/ 这里可以申请：CONTEXT7_API_KEY
Up-to-date code documentation for LLMs and AI code editors 

Claude code 安装

claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: YOUR_API_KEY"

添加完会显示:File modified: /root/.claude.json [project: /opt/claude]

iFlow安装

https://platform.iflow.cn/mcp

项目范围安装

iflow mcp add-json 'context7' "{"command":"npx","args":["-y","@iflow-mcp/context7-mcp@1.0.0"]}"

全局安装

iflow mcp add-json -s user 'context7' "{"command":"npx","args":["-y","@iflow-mcp/context7-mcp@1.0.0"]}"

Context7 的使用非常直观，只需在提示中添加 use context7 即可触发服务器。

1. 文件系统访问（必装）
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects ~/Desktop
或
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem ~/Documents ~/Projects
用途：让Claude直接读写文件，修改代码

2. GitHub集成
claude mcp add github -s user -e GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github
用途：管理issues、PRs、代码审查

3. 网页浏览器控制
claude mcp add puppeteer -s user -- npx -y @modelcontextprotocol/server-puppeteer
用途：自动化网页操作、爬虫、测试

4. 数据库连接（PostgreSQL）
claude mcp add postgres -s user -e DATABASE_URL=postgresql://user:pass@localhost/db -- npx -y @modelcontextprotocol/server-postgres
用途：直接查询和操作数据库

5. API调用工具
claude mcp add fetch -s user -- npx -y @kazuph/mcp-fetch
用途：调用各种REST API

6. 搜索引擎
claude mcp add search -s user -e BRAVE_API_KEY=your_key -- npx -y @modelcontextprotocol/server-brave-search
用途：搜索最新信息

7. Slack集成
claude mcp add slack -s user -e SLACK_TOKEN=your_token -- npx -y @modelcontextprotocol/server-slack
用途：发送消息、管理频道

8. 时间管理
claude mcp add time -s user -- npx -y @modelcontextprotocol/server-time
用途：时区转换、日期计算

9. 内存存储
claude mcp add memory -s user -- npx -y @modelcontextprotocol/server-memory
用途：跨对话保存信息

10. Sequential Thinking（思维链）
claude mcp add thinking -s user -- npx -y @modelcontextprotocol/server-sequential-thinking
用途：复杂问题分步骤思考

11. UChrome DevTools MCP server
#参考:https://github.com/ChromeDevTools/chrome-devtools-mcp
claude mcp add chrome-devtools npx chrome-devtools-mcp@latest

MCP管理命令

查看已安装的MCP服务器

claude mcp list

删除MCP服务器

claude mcp remove <server_name>

测试MCP服务器

claude mcp test <server_name>

查看MCP状态

/mcp
运行本项目
bash

Claude URL

在提示中粘贴具体 URL，Claude 会自动拉取和阅读。为避免同一域名反复请求权限（如 docs.foo.com），用 ‎⁠/permissions⁠ 添加域名到允许列表。

Spec-Kit命令

安装:
(stock) root@Desktop-CLF:/opt/claude# uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git
Updated https://github.com/github/spec-kit.git (3b000fce4de8ff8dbed8d2bff32d9eecabd8f908)
Resolved 20 packages in 1.59s
Built specify-cli @ git+https://github.com/github/spec-kit.git@3b000fce4de8ff8dbed8d2bff32d9eecabd8f908
Prepared 1 package in 2.39s
Uninstalled 1 package in 58ms
Installed 1 package in 18ms

• specify-cli==0.0.18 (from git+https://github.com/github/spec-kit.git@89f4b0b38a42996376c0f083d47281a4c9196761)

• specify-cli==0.0.20 (from git+https://github.com/github/spec-kit.git@3b000fce4de8ff8dbed8d2bff32d9eecabd8f908)
  Installed 1 executable: specify
  (stock) root@Desktop-CLF:/opt/claude#

核心命令:规范驱动开发工作流程的基本命令：

命令 描述
/speckit.constitution 创建或更新项目管理原则和开发指南
/speckit.specify 定义要构建的内容（要求和用户情景）
/speckit.plan 使用您选择的技术堆栈创建技术实施计划
/speckit.tasks 生成可作的任务列表以供实施
/speckit.implement 执行所有任务，按照计划构建功能

可选命令:用于提高质量和验证的其他命令：

命令 描述
/speckit.clarify 澄清未指定区域（之前推荐;以前/speckit.plan/quizme)
/speckit.analyze 跨工件一致性和覆盖率分析（运行时间后、之前/speckit.tasks/speckit.implement)
/speckit.checklist 生成自定义质量清单，以验证需求的完整性、清晰度和一致性（例如“英语单元测试”）