Claude Code 安装与配置教程：Windows/macOS/L

为什么先理顺 Claude Code 接入

很多开发者第一次接触 Claude Code，真正耗时的往往不是命令怎么敲，而是环境是否满足要求、认证能不能正常完成，以及网络链路是否稳定。尤其在国内，如果你还想把 Claude、GPT、Gemini 这些主流模型放进同一套开发流程里，先把 Claude Code 安装与配置这件事处理好，会比后面反复排障省心得多。

这篇内容不沿用原始草稿的展开方式，而是按“先跑通、再完善、最后优化”的顺序来梳理。核心前提只有一个：Claude Code 依赖 Node.js 运行，最低建议 Node.js 18，实际使用更推荐 Node.js 20 LTS。若想装得更稳，npm 8 及以上更合适，推荐 10.x；Git 不是强制项，但 2.0 以上、最好 2.40+；系统层面，Windows 10+、macOS 12+ 和主流 Linux 发行版都能支持。

先跑通最小可用安装流程

如果你只是想先确认 Claude Code 能不能在机器上跑起来，最短路径并不复杂：先检查 Node.js 版本，再全局安装 CLI，最后启动一次完成首次认证。只要版本输出正常，并且第一次启动能进入登录流程，基础环境通常就算搭好了。

node --version npm install -g @anthropic-ai/claude-code claude --version claude

安装完成后，最值得优先记住的几个命令是单次任务执行、继续上次会话和跳过权限确认。前两者适合日常开发，第三个虽然能减少交互步骤，但也意味着你要更清楚工具即将执行什么，因此不适合在不确定的场景里滥用。

claude -p "创建一个Python快速排序函数" claude --continue claude --dangerously-skip-permissions

不同系统怎么装：Windows、macOS、Linux

Windows 环境更推荐通过 WSL 使用 Claude Code，而不是直接在原生终端里硬配。原因很简单：Claude Code 的整体使用体验更偏向 Unix/POSIX 语义，WSL 往往能减少兼容性问题。常见做法是先安装 WSL，再装 Ubuntu，进入系统后更新软件并补齐 curl、wget、git、build-essential 等常用依赖。

wsl --install wsl --list --online wsl --install -d Ubuntu sudo apt update && sudo apt upgrade -y sudo apt install -y curl wget git build-essential node --version npm install -g @anthropic-ai/claude-code claude --version

在 macOS 上，流程会直接一些。常见做法是先用 Homebrew 安装 Node.js 20，再用 npm 安装 Claude Code；如果你不想走 Homebrew，也可以直接安装 Node.js 官方发行包，然后执行同样的 npm 命令。

brew install node@20 npm install -g @anthropic-ai/claude-code claude --version

Linux 的区别主要在发行版。Ubuntu 或 Debian 用户先更新软件列表；CentOS、RHEL、Fedora 使用 yum 或 dnf；Arch Linux 直接用 pacman。无论哪条路径，目标都一样：确保本机具备可用的 Node.js 与 npm，然后再安装 Claude Code。

# Ubuntu / Debian sudo apt update sudo apt-get install -y nodejs npm install -g @anthropic-ai/claude-code

CentOS / RHEL
sudo yum install nodejs npm install -g @anthropic-ai/claude-code
Fedora
sudo dnf install nodejs npm install -g @anthropic-ai/claude-code
Arch Linux
sudo pacman -S nodejs npm npm install -g @anthropic-ai/claude-code

认证和配置怎么做：API Key、模型、BASE_URL

Claude Code 第一次启动时，通常会自动引导你完成认证。如果浏览器授权过程没有顺利拉起，或者自动流程中断，可以改用手动初始化与手动登录。看到认证成功的提示之后，才说明这套 Claude Code 安装流程真正进入可用状态。

claude claude init claude auth login --manual

✓ Authentication successful! ✓ Claude Code is ready to use.

如果你准备把 Claude Code 接入自己的日常工作流，环境变量通常还要补齐。最常见的就是 API Key、模型名称和 BASE_URL。若你希望在国内更稳定地访问 Claude、GPT、Gemini 等模型，可以把接入统一收敛到 api.clawsocket.com，再按平台文档填写对应参数；这样本地调试、命令行调用和脚本测试都更容易维护。为了避免每次开终端都重新输入，建议把配置写进 ~/.bashrc 或 ~/.zshrc。

export ClawSocketAPI_KEY=your_api_key export ClawSocketMODEL=claude-3-5-sonnet-20241022 export ClawSocketBASE_URL=api.clawsocket.com

echo 'export ClawSocketAPI_KEY=your_api_key' >> ~/.bashrc echo 'export ClawSocketMODEL=claude-3-5-sonnet-20241022' >> ~/.bashrc source ~/.bashrc

常用命令和会话能力：单次任务、续写、调试与文件处理

真正进入使用阶段后，Claude Code 最高频的命令通常集中在几类：进入交互模式、一次性执行任务、恢复上下文、查看帮助、检查版本，以及在指定工作目录里运行。除此之外，调试模式、静默执行和自定义配置文件也很实用，尤其适合脚本化或工程化场景。

claude claude -p "创建一个React组件" claude --continue claude --resume claude --help claude --version claude --config /path/to/config.json claude --debug claude --quiet claude --cwd /path/to/project

交互模式里还有一组很实用的斜杠命令。比如 /compact 可以压缩上下文、/clear 用来清空当前对话、/history 方便回看历史、/model 用于切换模型、/exit 直接退出程序。快捷键方面，ESC 可以中断任务，Ctrl+Z 可临时退出当前模式，Ctrl+V 能粘贴图片，Ctrl+C 用于强制结束，Tab 则负责补全命令和路径。

/compact /clear /history /edit /model /help /exit

除了问答与代码生成，Claude Code 对项目文件的处理也很常见。你可以让它分析工程结构、生成新功能文件、针对某个文件定位问题，甚至批量调整代码类型。对日常开发而言，这部分能力往往能明显降低重复劳动。

claude "分析这个项目的架构" claude "创建一个用户认证的API" claude "修复src/utils/auth.js中的bug" claude "将所有.js文件转换为TypeScript"

安装后如何自检，以及国内环境怎样更稳

完成 Claude Code 安装与配置后，先不要急着投入正式项目，最好做一轮最基础的自检：版本号能不能正常输出、帮助文档是否可读取、简单任务能否执行。若这三步都通过，通常意味着 CLI 安装、命令路径和运行时环境已经没有明显问题；反过来说，一旦这里失败，排查方向通常就是 Node.js 版本、全局安装是否成功、认证是否完成，或者 shell 配置有没有生效。

claude --version claude --help claude -p "echo 'Hello Claude Code'"

如果你的网络环境本身需要代理，可以继续按当前终端和 npm 的规则补充 HTTP/HTTPS 代理设置；如果 npm 包下载偏慢，也可以按照当前环境切换可用镜像或在安装时临时指定镜像。若你更在意的是多模型统一接入和本地开发稳定性，那么直接通过 api.clawsocket.com 来承接 Claude、GPT、Gemini 等模型会更省事。总结来说，这篇 Claude Code 教程最重要的结论并不复杂：先确认 Node.js 18+，优先使用 Node.js 20 LTS；按系统完成安装；把认证和环境变量一次配好；最后再用常用命令和验证流程确认整条链路可用。