大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
Claude Code 我也用了几个月了，这里整理一份尽量讲清楚安装、配置、启动和常用命令，方便第一次接触的人快速上手。
 

另外在2026.3.31号发生了一件AI圈的大事，ClaudeCode部分源码泄露了出来，本文后面也会带大家一起瞅瞅，并无偿免费提供对应源码和文档 ~

欢迎大家一起交流讨论

如果你是第一次装 Claude Code，最短路径就是这 4 步：

1. 安装 Node.js，版本必须 >= 18
2. Windows 用户额外安装 Git，并使用 Git Bash
3. 安装 Claude Code
4. 配置 settings.json 后启动

如果你只是想快速跑起来，可以先看这几个核心命令：

node --version npm --version claude --version claude 

1. 安装 Node.js

Claude Code 依赖 Node.js，版本必须 >= 18。

macOS

推荐使用 Homebrew 安装：

brew install node 

安装完成后，验证版本：

node --version npm --version 

Windows

操作步骤：

1. 从 Node.js 官网 下载 LTS 版本安装包（.msi）。
2. 运行安装程序，按默认选项安装即可，建议安装到 C 盘。
3. 安装完成后，打开“命令提示符”或 PowerShell，执行下面命令确认安装成功。

node --version npm --version 

补充说明：

• 建议优先安装 LTS 版本，稳定性更好。
• 如果 node --version 能正常返回版本号，说明 Node.js 基本没问题。

C:Users>node --version v24.11.1 C:Users>npm --version 11.6.2 

2. 安装 Git（仅 Windows 需要）

Windows 用户需要安装 Git Bash 来运行 Claude Code。

操作步骤：

1. 从 Git 官网 下载最新版 Git。
2. 运行下载的 .exe 文件，一路默认安装即可，建议安装到 C 盘。
3. 安装完成后，在开始菜单搜索 Git Bash。
4. 打开 Git Bash，如果能看到命令行界面，说明安装完成。

补充说明：

• 在 Windows 上，Claude Code 更推荐通过 Git Bash 使用。
• 如果你后续装好了 Claude Code，但命令运行异常，先检查是不是没有用 Git Bash。

macOS / Linux

在终端中直接全局安装：

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

如果遇到网络问题，可以使用国内镜像：

npm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com 

Windows（使用 Git Bash）

操作步骤：

1. 打开 Git Bash
2. 推荐先安装 pnpm，这样更不容易遇到依赖问题
3. 再使用 pnpm 安装 Claude Code
4. 等待安装完成

先安装 pnpm：

npm install -g pnpm pnpm setup 

再安装 Claude Code：

pnpm install -g @anthropic-ai/claude-code 

如果网络不佳，可添加镜像：

pnpm install -g @anthropic-ai/claude-code --registry https://registry.npmmirror.com 

补充说明：

• pnpm setup 执行后，如果命令仍未生效，通常重开一次终端即可。
• Windows 环境下用 pnpm 安装，兼容性通常会更稳一点。

验证安装

在终端中输入下面命令，查看是否显示版本号：

claude --version 

如果能正常输出版本号，就说明 Claude Code 已经安装成功。

C:Users>claude --version 2.1.85 (Claude Code) 

1. Windows 额外配置环境变量

Windows 需要额外添加一个环境变量：CLAUDE_CODE_GIT_BASH_PATH

操作步骤：

1. 右键“此电脑”
2. 进入“属性”
3. 打开“高级系统设置”
4. 点击“环境变量”
5. 在“系统变量”或“用户变量”中点击“新建”，推荐设置到系统变量里面

填写如下内容：

• 变量名：CLAUDE_CODE_GIT_BASH_PATH
• 变量值：你的 bash.exe 实际路径，例如 C:Program FilesGitbinbash.exe

补充说明：

• 如果 Git 安装路径不是默认位置，这里要改成你自己的真实路径。
• 配好后建议重新打开一次终端，避免环境变量未刷新。

2. 通用配置：创建 settings.json

配置文件路径如下：

• macOS / Linux：~/.claude/settings.json
• Windows：C:Users[你的用户名].claudesettings.json

如果目录或文件不存在，请手动创建。

在 settings.json 中写入以下内容：

{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx", "ANTHROPIC_BASE_URL": "https://anyrouter.top", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1, "API_TIMEOUT_MS":  }, "permissions": { "allow": [], "deny": [] } } 

说明：

• 将 sk-xxxxxx 替换为你购买的 API Key。
• ANTHROPIC_BASE_URL 可以根据你使用的代理服务地址调整。
• 保存文件时确认扩展名是 .json，不是 .txt。

补充建议：

• 如果你是第一次配置，建议先按示例原样填写，确保能跑通后再微调。
• API_TIMEOUT_MS 设置大一些，可以减少网络波动导致的超时报错。

3. 清理旧版本（如有）

如果你之前安装过其他版本的 Claude Code，建议先卸载：

npm uninstall -g @anthropic-ai/claude-code 

并删除对应的环境变量（如果有）。

这样做的好处是：

• 避免新旧版本冲突
• 避免读取到历史残留配置
• 出现异常时更容易排查问题

在终端中输入：

claude 

Windows 用户请使用 Git Bash 启动。

首次启动时，程序一般会提示你选择主题等初始设置，随后会询问是否使用当前配置文件中的 API Key，选择“是”即可。

成功进入后，还会有一个然你确认是否授权当前运行文件夹的权限，选择Yes,I trust this folder就可以，之后你会看到 Claude Code 的交互界面，这时就可以开始使用了。

使用时注意这几点

• 确保 Node.js 版本 >= 18，否则 Claude Code 无法运行。
• 如果遇到网络超时，可以适当调大 API_TIMEOUT_MS。
• 如果在 Windows 的 Git Bash 里提示 pnpm: command not found，先确认你执行过 pnpm setup，然后重新打开终端。
• 如果 claude 命令找不到，优先检查是不是安装后没有重开终端，或者环境变量还没刷新。

1. 在 IDE 编辑器里使用

可以下载Claude Code插件或者cc GUI

Claude Code这个插件是用命令行的，cc GUI这个是有界面的，上手会更快一些，根据自己的实际情况选择即可。

2、切换供应商工具

推荐CC-Switch进行不同供应商进行切换，之后我也会写一篇文章介绍。猴急的可以自己去github上搜，star最多的那个就是。

下面我把 Claude Code 的常见命令按功能整理了一下，按需使用

1. CLI 启动命令（终端启动时使用）

2. 高级 CLI 标志

3. 斜杠命令（交互式会话内使用）

项目初始化与记忆管理

上下文管理

/compact 和 /clear 的区别：

• /compact：压缩并保留关键信息，通常能释放 60% - 80% 空间，适合继续当前任务。
• /clear：完全清空上下文，信息不会保留，适合切换全新任务。

成本与资源监控

模型与配置

模型选择建议：

• Sonnet 4.6（默认）：适合日常编码、重构、Bug 修复。
• Opus 4.6：适合复杂多步规划、架构决策、关键生产代码。
• Haiku 4.5：适合简单编辑、样板代码、快速提问。

开发辅助

诊断与帮助

/doctor 主要检查：

• Node.js 版本（>= 18）
• API Token 有效性
• Anthropic 服务器连接
• 配置文件 JSON 格式
• 文件系统权限

自定义扩展

创建说明：

在 .claude/commands/ 目录下创建 .md 文件，文件名就是命令名，支持 \(ARGUMENTS 变量捕获参数。

4. 键盘快捷键（交互式会话内）

5. 扩展机制（高级功能）

自定义命令

变量支持：

• \)ARGUMENTS：命令后的全部参数
• \(FILE：当前活动文件
• \)PROJECT：项目根目录
• $SELECTION：当前选中文本

Skills（技能）

Hooks（钩子）

子代理类型

6. 实战工作流示例

场景 1：新项目初始化

claude > /init > /memory 

适用场景：

• 第一次在新项目里接入 Claude Code
• 想把项目规则和约束沉淀到 CLAUDE.md

场景 2：长会话成本控制

> /context > /compact > /cost 

适用场景：

• 对话时间比较长
• 上下文快满了
• 想控制 token 成本

场景 3：代码审查自动化

> /simplify > /diff > git commit -m “…” 

适用场景：

• 功能写完后做一次快速自查
• 提交前先看 AI 改了什么

场景 4：CI/CD 集成（headless）

# 单次审查并输出 JSON claude -p “Review PR #123”  –allowedTools Read  –max-turns 5  –output-format json > review.json 

适用场景：

• 自动化脚本
• 持续集成
• 批量处理单次任务

Claude Code 的开源快照有 50 万行 TypeScript，包含 66+ 工具、React/Ink TUI、MCP 协议、OAuth 认证、多代理系统等复杂功能。

源码解析地址一：https://zhu.github.io/claude-code-cookbook

源码解析地址二：https://windy3f3f3f3f.github.io/claude-code-from-scratch

源码解析地址三：https://linux.do/u/khalilgao/activity/topics

原始源码下载在公主号后台回复CC源码，会有对应的源码和源码解析文档。