Claude code在Windows上的配置流程

前言

昨天在服务器上配置好了 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直接安装存在一点小问题，于是选择直接在商店下载安装。

bash 复制代码

wsl --install -d Ubuntu-22.04

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

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

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

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

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

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

Windows原生部署方案

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

bash 复制代码

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 的前提下，可以直接安装：

bash 复制代码

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

安装完后，用命令启动：

bash 复制代码

npx win-claude-code@latest

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

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

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

输入以下内容：

bash 复制代码

@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"`	处理管道内容
`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`