前言

昨天在服务器上配置好了 Claude code，发现其编码性能和效率都非常不错。

然而，尝试用它修改带 UI 界面的客户端程序时颇为不便，因为服务器没有图形化界面，无法直接将应用界面直接显示到开发机上，调试起来颇为不便。

因此，本文在 windows 系统上部署 Claude code，让开发体验更为丝滑。

WSL方案

由于 Claude code(原本) 只支持 Linux 和 MacOS 系统，因此在 windows 中可以通过 WSL 配置一套 Ubuntu 系统。

当然，也可以用 VMvare 这类虚拟机软件，但性能开销比 windows 自带的 wsl 高很多。

首先可以在 windows 的微软商店中下载 ubuntu 系统，这里以Ubuntu 22.04 为例，其它系统也可以。

也可以直接用 wsl 安装，但我的 win10系统用wsl直接安装存在一点小问题，于是选择直接在商店下载安装。

wsl --install -d Ubuntu-22.04

安装完后，重启电脑，进入软件界面，会提示新建用户名和密码。

之后，在 Cursor 中，安装一个 WSL 的插件。

安装完后，就可以直接打开 WSL 的终端，它会自动将当前项目挂载到系统中。

然后，就可以参照前文，到镜像站去创建key，进行相同步骤的配置。

镜像站地址：https://anyrouter.top/register?aff=kUGb

配置完之后，它就能正确读取文件内容。

Windows原生部署方案

然而，当我折腾完时，突然发现它的更新公告：

What's new:• Added support for native Windows (requires Git for Windows)• Added support for Bedrock API keys through environment variable AWS_BEARER_TOKEN_BEDROCK• Settings: /doctor can now help you identify and fix invalid setting files• `--append-system-prompt` can now be used in interactive mode, not just --print/-p.• Increased auto-compact warning threshold from 60% to 80%

它现在可以直接原生支持windows系统了。

在安装号 npm 的前提下，可以直接安装：

npm install -g @anthropic-ai/claude-code --ignore-scripts

安装完后，用命令启动：

npx win-claude-code@latest

如果能正常启动，参照前文相同的方式配置环境变量，就可以再终端使用了。

由于 windows 的启动命令和其它系统有所不同，可以创建一个别名。

在用户目录下创建一个claude.bat

输入以下内容：

@echo off
npx win-claude-code@latest %*

保存后，将该路径添加到用户Path环境变量。

重启终端，就可以直接用claude启动了。

配置完后，就可以优雅得在 Cursor 中搭配使用。

Claude code 使用技巧

参考 Claude 官方文档，在让它修改代码前，建议让它先熟悉一下项目文件，对后续提问创造有利的上下文条件。

此外，CLI 还有以下参考命令和参数，可以应对会话恢复、权限跳过等常用情况。

CLI 命令参考：

命令	描述	示例
claude	启动交互式 REPL	claude
claude "query"	启动 REPL，并使用初始提示词	claude "explain this project"
claude -p "query"	使用 SDK 查询并退出	claude -p "explain this function"
cat file | claude -p "query"	处理管道内容	cat logs.txt | claude -p "explain"
claude -c	继续最近的一次对话	claude -c
claude -c -p "query"	使用 SDK 继续最近对话	claude -c -p "Check for type errors"
claude -r "<session-id>" "query"	通过 ID 恢复对话会话	claude -r "abc123" "Finish this PR"
claude update	更新到最新版本	claude update
claude mcp	配置 Model Context Protocol (MCP) 服务器	详见 Claude Code MCP 文档

CLI 参数：

参数（Flag）	描述	示例
--add-dir	添加 Claude 可以访问的额外工作目录（路径必须为有效目录）	claude --add-dir ../apps ../lib
--allowedTools	设置无需提示即可允许使用的工具列表（可配合 settings.json 使用）	"Bash(git log:*)" "Bash(git diff:*)" "Read"
--disallowedTools	设置无需提示即可禁止使用的工具列表（可配合 settings.json 使用）	"Bash(git log:*)" "Bash(git diff:*)" "Edit"
--print, -p	以非交互模式输出 Claude 响应（适合脚本使用，详见 SDK 文档）	claude -p "query"
--output-format	指定输出格式（可选项：text、json、stream-json）	claude -p "query" --output-format json
--input-format	指定输入格式（可选项：text、stream-json）	claude -p --output-format json --input-format stream-json
--verbose	启用详细日志模式，显示完整交互过程（调试推荐）	claude --verbose
--max-turns	在非交互模式下限制 Agent 回合数	claude -p --max-turns 3 "query"
--model	设置当前会话所使用的模型（如 sonnet、opus 或模型全名）	claude --model claude-sonnet-4-20250514
--permission-mode	启动时设置权限模式（详见权限模式文档）	claude --permission-mode plan
--permission-prompt-tool	在非交互模式下指定一个 MCP 工具来处理权限请求提示	claude -p --permission-prompt-tool mcp_auth_tool "query"
--resume	恢复指定会话（通过 ID 或交互方式选择）	claude --resume abc123 "query"
--continue	在当前目录加载最近对话	claude --continue
--dangerously-skip-permissions	跳过权限请求提示（请谨慎使用）	claude --dangerously-skip-permissions