Claude Code 安装使用指南

文章目录1. 基础环境与工具安装2. Claude账号问题3. 核心配置使用兼容模型绕过Claude登录验证方案一通过命令行设置环境变量Windows 用户 (CMD 命令提示符)macOS / Linux 用户 (Shell)方案二通过配置文件修改环境变量1. 文件结构总览2. 详细配置指南4. 启动与常用指令一、程序启动与退出二、常用交互指令含补充说明三、补充注意事项Claude Code 对于中国大陆用户直接使用面临网络与账号双重门槛。但可以通过本地部署 国产大模型兼容层GLM/DeepSeek方案实现无障碍安装使用。操作起来很简单只需要3个步骤即可。1. 基础环境与工具安装Claude Code 依赖 Node.js 环境运行。**请确保已安装 **Node.js。下载Nodejs之后双击安装即可。打开终端Windows 推荐 PowerShell/CMDMac 使用 Terminal按顺序执行以下命令完成从检查到安装的全流程检查 Node.js 环境必须有版本号返回node-vnpm-v安装 Claude Code使用 -g 进行全局安装npminstall-ganthropic-ai/claude-code验证安装claude--version看到版本号即安装成功。输出示例2.1.2 (Claude Code)如果在npm install这一步遇到卡顿建议搜索watt toolkit加速器windows应用商店搜索然后安装或者使用国内npm中转具体做法是在npm install命令后面添加参数npminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com2. Claude账号问题安装完成后需要解决“谁来驱动”的问题根据你的网络与账号情况选择路径路径 A标准模式美国、欧洲等支持地区如果你身处海外环境且有 Anthropic 账号直接运行claude login系统会打开浏览器让你登录Claude进行 OAuth 授权。登录完成后即可顺畅使用Claude Code。那么对于你来说现在已经安装成功了。路径 B兼容模式中国大陆推荐国内用户无需注册 Anthropic 账号可直接使用智谱 GLM或DeepSeek的 API 来驱动 Claude Code。这两者均提供了官方兼容接口。具体看第三步。3. 核心配置使用兼容模型绕过Claude登录验证为了让 Claude Code 连接到兼容模型智谱GLM, DeepSeek)。请求 / 响应结构与 Anthropic 基本一致可直接作为 Claude Code 的后端不需要登录 Anthropic 官网账号方案一通过命令行设置环境变量我们需要配置BASE_URL和API_KEY为了避免每次重启终端丢失配置以下命令将直接写入系统永久环境变量。智谱 GLM Base URL:https://open.bigmodel.cn/api/anthropicDeepSeek Base URL:https://api.deepseek.com/anthropic请根据你的系统复制对应的命令块运行只需运行一次Windows 用户 (CMD 命令提示符)使用 setx 命令写入用户级永久变量setx ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic setx ANTHROPIC_AUTH_TOKEN 你的_GLM_API_KEY setx ANTHROPIC_MODEL glm-4.6注意运行后需重启 CMD 窗口才会生效macOS / Linux 用户 (Shell)echoexport ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic~/.zshrcechoexport ANTHROPIC_AUTH_TOKEN你的_GLM_API_KEY~/.zshrcechoexport ANTHROPIC_MODELglm-4.6~/.zshrcsource~/.zshrc如果使用DeepSeek则使用DeepSeek的url和api key模型名则是deepseek-chat。方案二通过配置文件修改环境变量通过修改本地配置文件可以强制 Claude Code (CLI) 连接到 DeepSeek 或其他兼容 Anthropic 协议的模型并跳过官方的浏览器登录验证。1. 文件结构总览需要修改的文件位于用户根目录下。请确保文件位置和层级完全一致C:\Users\用户名\ │ ├── .claude.json -- 【状态文件】 修改这个文件内容添加hasCompletedOnboarding: true, │ └── .claude\ -- 【配置文件夹】 这是claude全局文件夹 └── ⚙️ settings.json -- 【配置文件】 新建这个settings.json文件并添加环境变量2. 详细配置指南配置 API 连接 (.claude\settings.json)此文件用于接管网络请求将其重定向到第三方服务如 GLM/DeepSeek。路径:C:\Users\你的用户名\.claude\settings.json内容: 新建这个setting.json文件用记事本打开在里面添加下面这段内容{env:{// 将地址改为 DeepSeek 或 GLM 的 Anthropic 兼容接口ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,// 填写对应的 API KeyANTHROPIC_AUTH_TOKEN:你的API Key,// 禁用遥测和联网检查防止因地区问题导致的报错CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1}}绕过登录验证 (.claude.json)此文件用于伪造“老用户”状态防止 CLI 启动时弹出浏览器进行 OAuth 验证。路径:C:\Users\你的用户名\.claude.json内容: 用记事本打开这个文件在其中添加一项hasCompletedOnboarding:true,// 核心告诉程序已完成新手引导直接进入对话4. 启动与常用指令环境变量配置完毕后无需登录直接启动即可。一、程序启动与退出● 启动程序在命令行中输入 claude然后回车无需额外参数直接执行即可。○ 成功标志出现 “Welcome to Claude Code” 欢迎语且未弹出浏览器若弹出浏览器说明环境变量配置存在异常需重新检查配置。● 退出程序在交互界面输入exit回车即可正常退出若交互界面卡顿可使用快捷键 CtrlC 强制退出。二、常用交互指令含补充说明●/clear清除当前对话的上下文记忆核心作用节省 Token 消耗开启新任务、切换对话主题时推荐使用清除后不会影响历史对话记录。●/compact压缩当前上下文内容核心作用处理长对话、复杂任务时使用会保留对话关键信息剔除冗余内容压缩后可使用 CtrlO 查看压缩后的完整上下文纠正原“chrlo”为笔误。●/help查看所有可用命令及详细用法若忘记某条指令功能可随时输入该指令查询。●Shift回车在对话框中换行输入长文本、多行内容时使用避免一次性输入导致格式混乱。●ShiftTab切换交互模式切换后可实现不同操作逻辑如从对话模式切换至命令快捷模式具体模式差异可结合 /help 指令查看。●!命令执行系统 bash 命令注意需谨慎使用避免输入高危命令防止误操作系统文件或配置。●/rewind回滚对话撤销上一步对话操作若输入错误指令、发送错误内容可使用该指令回退。●/resume恢复之前的对话会话若中途退出交互、误清除上下文可使用该指令回到最近一次的对话状态。●/init生成项目级别的 CLAUDE.md 文件生成位置为当前命令行所在的项目根目录用于规范项目内 Claude 使用规则。●/memory打开当前已有的 CLAUDE.md 文件默认使用系统自带的文本编辑器打开方便查看、编辑文件内容。三、补充注意事项所有交互指令均为小写输入时需区分大小写大写指令会被识别为无效命令Token 消耗与上下文长度正相关长期使用可定期用 /clear 或 /compact 优化避免 Token 耗尽若启动失败、指令无效优先检查环境变量配置是否正确或重启命令行后重新尝试。