Claude Code wsl部署及pycharm使用

1. 安装

   参考这俩帖子：

   https://juejin.cn/post/7518241866363699200

   https://cloud.tencent.com/document/product/1772/129442

   1.1 安装 WSL2 和 Ubuntu

   # 设置默认版本
   wsl --set-default-version 2
   
   # 更新 WSL（可能遇到 403 错误）
   wsl --update
   
   # 安装 Ubuntu（失败多试几次，不用梯子）
   wsl --install -d Ubuntu-22.04

   1.2 将 WSL 迁移到其他磁盘（可选但推荐）

   #创建目标目录
   New-Item -ItemType Directory -Path "E:\WSL" -Force
   New-Item -ItemType Directory -Path "E:\WSL\Ubuntu-22.04" -Force
   New-Item -ItemType Directory -Path "E:\WSL\backups" -Force
   
   #导出现有安装。
   wsl --shutdown
   wsl --export Ubuntu-22.04 E:\WSL\backups\ubuntu-22.04-backup.tar
   
   #注销原安装
   wsl --unregister Ubuntu-22.04
   
   #导入到新位置。
   wsl --import Ubuntu-22.04 E:\WSL\Ubuntu-22.04 E:\WSL\backups\ubuntu-22.04-backup.tar --version 2
   
   #设置默认用户。
   wsl -d Ubuntu-22.04 -u root bash -c "echo '[user]' > /etc/wsl.conf"
   ws1 -d Ubuntu-22.04 -u root bash -c "echo 'default=yourusername' >> /etc/ws1.conf"
   wsl --shutdown

    

   1.3 在 WSL 中安装claude code

   # 更新系统
   apt update && sudo apt upgrade -y
   
   
   
   # 安装开发工具
   # 基础工具
   apt install -y build-essential git curl wget software-properties-common
   
   
   
   # 安装 Node.js（用于 Claude Code）
   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
   apt-get install -y nodejs
   
   
   
   安装 Claude Code
   # 全局安装
   npm install -g @anthropic-ai/claude-code
   # 验证安装
   claude --version
   
   
   
   新建~/.claude/settings.json
   {
       "env": {
           "ANTHROPIC_AUTH_TOKEN": "<USER_API_KEY>",
           "ANTHROPIC_BASE_URL": "https://api.lkeap.cloud.tencent.com/plan/anthropic",
           "ANTHROPIC_MODEL": "<Model_Name>"
       }
   }
   
   
   编辑~/.claude.json
   {
     "hasCompletedOnboarding": true
   }

   1.4 pycharm配置终端

   File → Settings → Tools → Terminal

   • Shell path: wsl -d Ubuntu-22.04 -u root

    

    

   2. 配置

   2.1 设置沙箱模式

   wsl安装的linux默认不带ubblewrap socat，使用命令安装：

   apt-get install bubblewrap socat

    

   claude开启配置：
   /sandbox

   mode下选择Sandbox BashTool, with auto-allow     优先沙箱执行命令

    

   Overrides下选择Strict sandbox mode     严格沙箱模式，严格沙盒模式:模型调用的所有Bash命令必须在沙盒中运行，除非它们明确列在excludedCommands中（config设置），看情况设置，配置麻烦。

    

    

    

   3. 使用

   /add-dir <path>	为当前会话期间的文件访问添加工作目录。大多数 .claude/ 配置不会从添加的目录中发现
   /agents	管理 agent 配置
   /btw <question>	提出快速附加问题，无需添加到对话中
   /chrome	配置 Claude in Chrome 设置
   /clear	清除对话历史记录并释放上下文。别名：/reset、/new
   /color [color|default]	为当前会话设置提示栏颜色。可用颜色：red、blue、green、yellow、purple、orange、pink、cyan。使用 default 重置
   /compact [instructions]	压缩对话，可选择性地提供焦点说明
   /config	打开设置界面以调整主题、模型、输出样式和其他偏好设置。别名：/settings
   /context	将当前上下文使用情况可视化为彩色网格。显示上下文密集型工具、内存膨胀和容量警告的优化建议
   /copy [N]	将最后一个助手响应复制到剪贴板。传递数字 N 以复制第 N 个最新响应：/copy 2 复制倒数第二个。当存在代码块时，显示交互式选择器以选择单个块或完整响应。在选择器中按 w 将选择内容写入文件而不是剪贴板，这在 SSH 上很有用
   /cost	显示令牌使用统计信息。有关订阅特定的详细信息，请参阅成本跟踪指南
   /desktop	在 Claude Code Desktop 应用中继续当前会话。仅限 macOS 和 Windows。别名：/app
   /diff	打开交互式差异查看器，显示未提交的更改和每轮差异。使用左/右箭头在当前 git 差异和单个 Claude 轮次之间切换，使用上/下浏览文件
   /doctor	诊断并验证您的 Claude Code 安装和设置
   /effort [low|medium|high|max|auto]	设置模型工作量级别。low、medium 和 high 在会话间保持。max 仅适用于当前会话，需要 Opus 4.6。auto 重置为模型默认值。不带参数时，显示当前级别。立即生效，无需等待当前响应完成
   /exit	退出 CLI。别名：/quit
   /export [filename]	将当前对话导出为纯文本。使用文件名时，直接写入该文件。不使用文件名时，打开对话框以复制到剪贴板或保存到文件
   /extra-usage	配置额外使用量以在达到速率限制时继续工作
   /fast [on|off]	切换快速模式开启或关闭
   /feedback [report]	提交关于 Claude Code 的反馈。别名：/bug
   /branch [name]	在此点创建当前对话的分支。别名：/fork
   /help	显示帮助和可用命令
   /hooks	查看工具事件的 hook 配置
   /ide	管理 IDE 集成并显示状态
   /init	使用 CLAUDE.md 指南初始化项目。设置 CLAUDE_CODE_NEW_INIT=1 以获得交互式流程，该流程还会引导您完成 skills、hooks 和个人内存文件
   /insights	生成报告，分析您的 Claude Code 会话，包括项目领域、交互模式和摩擦点
   /install-github-app	为存储库设置 Claude GitHub Actions 应用。引导您选择存储库并配置集成
   /install-slack-app	安装 Claude Slack 应用。打开浏览器以完成 OAuth 流程
   /keybindings	打开或创建您的快捷键配置文件
   /login	登录到您的 Anthropic 账户
   /logout	从您的 Anthropic 账户登出
   /mcp	管理 MCP server 连接和 OAuth 身份验证
   /memory	编辑 CLAUDE.md 内存文件，启用或禁用 auto-memory，并查看自动内存条目
   /mobile	显示二维码以下载 Claude 移动应用。别名：/ios、/android
   /model [model]	选择或更改 AI 模型。对于支持的模型，使用左/右箭头调整工作量级别。更改立即生效，无需等待当前响应完成
   /passes	与朋友分享一周免费的 Claude Code。仅在您的账户符合条件时可见
   /permissions	管理工具权限的允许、询问和拒绝规则。打开交互式对话框，您可以按范围查看规则、添加或删除规则、管理工作目录，以及查看最近的自动模式拒绝。别名：/allowed-tools
   /plan [description]	直接从提示进入 Plan Mode。传递可选描述以进入 Plan Mode 并立即开始该任务，例如 /plan fix the auth bug
   /plugin	管理 Claude Code plugins
   /powerup	通过带有动画演示的快速交互式课程发现 Claude Code 功能
   /pr-comments [PR]	获取并显示来自 GitHub pull request 的评论。自动检测当前分支的 PR，或传递 PR URL 或编号。需要 gh CLI
   /privacy-settings	查看和更新您的隐私设置。仅对 Pro 和 Max 计划订阅者可用
   /release-notes	查看完整的更改日志，最新版本最接近您的提示
   /reload-plugins	重新加载所有活跃 plugins 以应用待处理的更改，无需重启。报告每个已重新加载组件的计数并标记任何加载错误
   /remote-control	使此会话可从 claude.ai 进行远程控制。别名：/rc
   /remote-env	为使用 --remote 启动的网络会话配置默认远程环境
   /rename [name]	重命名当前会话并在提示栏上显示名称。不使用名称时，从对话历史记录自动生成一个
   /resume [session]	按 ID 或名称恢复对话，或打开会话选择器。别名：/continue
   /review	已弃用。改为安装 code-review plugin：claude plugin install code-review@claude-plugins-official
   /rewind	将对话和/或代码倒回到上一个点，或从选定的消息进行总结。请参阅 checkpointing。别名：/checkpoint
   /sandbox	切换 sandbox mode。仅在支持的平台上可用
   /schedule [description]	创建、更新、列出或运行 Cloud scheduled tasks。Claude 会以对话方式引导您完成设置
   /security-review	分析当前分支上的待处理更改以查找安全漏洞。审查 git 差异并识别注入、身份验证问题和数据泄露等风险
   /skills	列出可用的 skills
   /stats	可视化每日使用情况、会话历史记录、连续记录和模型偏好
   /status	打开设置界面（状态选项卡），显示版本、模型、账户和连接性。在 Claude 响应时工作，无需等待当前响应完成
   /statusline	配置 Claude Code 的状态行。描述您想要的内容，或不带参数运行以从您的 shell 提示自动配置
   /stickers	订购 Claude Code 贴纸
   /tasks	列出并管理后台任务。也可用作 /bashes
   /terminal-setup	为 Shift+Enter 和其他快捷键配置终端快捷键。仅在需要它的终端中可见，如 VS Code、Alacritty 或 Warp
   /theme	更改颜色主题。包括浅色和深色变体、色盲友好（道尔顿化）主题和使用您终端颜色调色板的 ANSI 主题
   /upgrade	打开升级页面以切换到更高的计划层级
   /usage	显示计划使用限制和速率限制状态
   /vim	在 Vim 和普通编辑模式之间切换
   /voice	切换推送通话语音听写。需要 Claude.ai 账户