尧图网站建设 
目录前言一、简介二、环境准备2.1 系统支持2.2 前置依赖三、Claude Code 的安装3.1 方式一原生安装3.2 方式二npm 安装四、配置代理网络或者绕过IP校验4.1 方式一配置代理网络4.2 方式二修改配置绕过IP校验五、配置 API Key 环境变量5.1 全局配置5.2 配置文件内配置六、常见问题前言在AI编程助手层出不穷的今天Anthropic推出的Claude Code以其独特的Agentic Coding智能体编程 理念脱颖而出。它不是一个简单的代码补全插件而是一个直接运行在你终端里的AI同事。本文将为你提供一份手把手的教程涵盖从环境准备、跨平台安装、项目配置到高级命令与最佳实践的完整流程。无论你是Mac、Linux还是Windows用户都能在这篇文章中找到属于自己的Claude Code打开方式。一、简介Claude Code是一个运行在终端中的AI智能体。与Copilot这类“下一行预测”工具不同你只需要在命令行中描述任务目标它就能自主规划步骤读取相关文件、理解整个代码库、执行Shell命令、甚至操作Git提交最终完成你的指令。其核心优势在于上下文感知通过智能体式搜索探索你的项目而非简单的索引。工具调用可以直接调用Git、MCP服务器等外部工具。安全可控默认在执行高风险操作如写入文件、运行命令前请求用户授权。产品官网https://claude.com/product/claude-code中文文档https://code.claude.com/docs/zh-CN/quickstart二、环境准备在安装之前请确保你的系统满足以下要求。2.1 系统支持macOS: 10.14Linux: Ubuntu 18.04, CentOS 7, 以及其他主流发行版Windows: Windows 10/11 (推荐使用 PowerShell 或 Git Bash)2.2 前置依赖Claude Code主要通过npm包分发因此Node.js是必需项。检查Node.js是否安装win R 输入 cmd打开终端输入以下命令确保版本在16.0以上推荐18。node--versionnpm--version如果你还没有安装Node.js请前往 nodejs.org下载安装长期支持版LTS。关于Node.js的安装可参考博客Node.js 与 npm 的安装与配置详细教程检查Git是否安装版本不做要求Claude Code在执行任务的时候会用到Git的一个bash命令 Git Bash是Git for Windows提供的一个模拟类Unix的命令行工具它为Claude Code提供了必要的终端环境支持执行相关命令所以需要安装可以通过查看Git版本号的命令验证是否安装了Gitgit--version如果没有安装Git可参考博客Git - 的安装与使用 进行安装三、Claude Code 的安装Claude Code有两种安装方式。个人比较推荐使用npm进行安装 ~3.1 方式一原生安装在官方文档中提供了Claude Code的安装方式有本地安装、Homebrew安装 和WinGet安装可以安装官方文档的方式来进行安装这里我就直接复制官网上的本地安装方式macOS, Linux, WSL:curl-fsSLhttps://claude.ai/install.sh|bashWindows PowerShell:irm https://claude.ai/install.ps1|iexWindows CMD:curl-fsSLhttps://claude.ai/install.cmd-oinstall.cmdinstall.cmddel install.cmd3.2 方式二npm 安装Claude Code是基于npm的形式安装的Linux/macOS安装# 全局安装 Claude Codesudonpminstall-ganthropic-ai/claude-code# 验证安装claude--versionWindows安装# 以管理员身份打开 Powershell 或命令提示符# 全局安装npminstall-ganthropic-ai/claude-code# 验证安装claude--version这里我就只演示在Windows下安装通过Win R输入cmd调出 命令提示符安装成功之后可以通过以下命令查看帮助文档claude--help四、配置代理网络或者绕过IP校验当我们安装完 Claude Code 时通过 claude 命令便可以启动claude如果你的电脑能够直接访问外网那么运行之后它 Claude Code 就能直接正常启动让你选择一个主题选择主题之后它会提供三种登录方式让你选择订阅 Claude 账户有专业版、高级版、团队版或企业版使用 API 使用计费方式第三方平台以上情况之后的步骤我就不做赘述了在国内更多情况下我们是不能直接访问外网的就会出现以下情况Unable to connect to Anthropic servicesFailed to connect to api.anthropic.com: ERR_BAD_REQUEST运行之后你会发现报了以上的错误这是因为 Claude Code 工具会校验位置信息国内是无法使用的我们有两种方式可以解决这个问题① 配置代理网络 ② 修改配置绕过校验PS我个人是比较推荐使用方式二4.1 方式一配置代理网络在当前项目目录下创建.claude/settings.json{evn:{HTTP_PROXY:http://127.0.0.1:7890,HTTPS_PROXY:http://127.0.0.1:7890}}这样做是为了给 Claude Code 配置网络代理让它在运行时通过你指定的代理服务器这里是 127.0.0.1:7890来访问外部网络。4.2 方式二修改配置绕过IP校验在C盘下C:\User\{username}找到claude的json配置文件.claude.json添加以下配置hasCompletedOnboarding:true,然后保存即可做完以上配置我们再次启动Claude Code就能发现Claude Code是启动成功的它会问你是否需要去读取这个目录文件如果我们选择Yes它会出现一个报错提示not login正常你启动的话它会用到Claude Code自带的一个模型Sonnet 4.6模型但这个模型是要收费的一个月最低也要17$这里我们可以使用API的方式就不需要去登录Claude Code的账户五、配置 API Key 环境变量这里我以接入七牛云和deepSeek的 API 为例接入七牛云API进入 七牛云 的 AI 大模型https://www.qiniu.com/ai/agent打开 七牛云 的控制台你可以创建一个 API keysk-c6159***********************783a在 七牛云 的模型广场选择一个模型例如qwen3-coder-480b-a35b-instructPS模型可以不设置如果不设置默认是claude-4.6-sonnet然后找到它的 Anthropic BaseURLhttps://api.qnaigc.com接入DeepSeek API打开 deepSeek 的 API 开放平台API 开放平台https://platform.deepseek.com/usage然后创建一个API KEY然后再打开接口文档就能找到它的Anthropic BaseURL和模型了5.1 全局配置# 临时设置setANTHROPIC_API_KEYsk-c6159***********************783asetANTHROPIC_BASE_URLhttps://api.qnaigc.com# 模型不设置默认使用 claude-4.6-sonnetsetANTHROPIC_MODELqwen3-coder-480b-a35b-instruct# 永久设置setx ANTHROPIC_API_KEYsk-c6159***********************783asetx ANTHROPIC_BASE_URLhttps://api.qnaigc.com# 模型不设置默认使用 claude-4.6-sonnetsetx ANTHROPIC_MODELqwen3-coder-480b-a35b-instruct5.2 配置文件内配置在C:\Users\{uername}\.claude\settings.json添加以下配置{env:{ANTHROPIC_API_KEY:sk-c6159***********************783a,ANTHROPIC_BASE_URL:https://api.qnaigc.com,ANTHROPIC_MODEL:qwen3-coder-480b-a35b-instruct,CLAUDE CODE ATTRIBUTION HEADER:0}}这里我是通过全局配置设置API的配置完之后这个时候我们就可以在项目中启动Claude Code六、常见问题1、 如果你按照以上方式配置好了 API 但是使用 claude 命令运行之后它还是提示你登录我们可以关闭 开发软件 或者重新打开一个文件夹打开命令提示符启动claude选择Yes之后它会提示你是否要使用API key选择Yes之后就能跳过登录了2、 模型不可用或者重新换个模型或者不进行设置 Claude Code 安装与配置（详细教程）
目录前言一、简介二、环境准备2.1 系统支持2.2 前置依赖三、Claude Code 的安装3.1 方式一原生安装3.2 方式二npm 安装四、配置代理网络或者绕过IP校验4.1 方式一配置代理网络4.2 方式二修改配置绕过IP校验五、配置 API Key 环境变量5.1 全局配置5.2 配置文件内配置六、常见问题前言在AI编程助手层出不穷的今天Anthropic推出的Claude Code以其独特的Agentic Coding智能体编程 理念脱颖而出。它不是一个简单的代码补全插件而是一个直接运行在你终端里的AI同事。本文将为你提供一份手把手的教程涵盖从环境准备、跨平台安装、项目配置到高级命令与最佳实践的完整流程。无论你是Mac、Linux还是Windows用户都能在这篇文章中找到属于自己的Claude Code打开方式。一、简介Claude Code是一个运行在终端中的AI智能体。与Copilot这类“下一行预测”工具不同你只需要在命令行中描述任务目标它就能自主规划步骤读取相关文件、理解整个代码库、执行Shell命令、甚至操作Git提交最终完成你的指令。其核心优势在于上下文感知通过智能体式搜索探索你的项目而非简单的索引。工具调用可以直接调用Git、MCP服务器等外部工具。安全可控默认在执行高风险操作如写入文件、运行命令前请求用户授权。产品官网https://claude.com/product/claude-code中文文档https://code.claude.com/docs/zh-CN/quickstart二、环境准备在安装之前请确保你的系统满足以下要求。2.1 系统支持macOS: 10.14Linux: Ubuntu 18.04, CentOS 7, 以及其他主流发行版Windows: Windows 10/11 (推荐使用 PowerShell 或 Git Bash)2.2 前置依赖Claude Code主要通过npm包分发因此Node.js是必需项。检查Node.js是否安装win R 输入 cmd打开终端输入以下命令确保版本在16.0以上推荐18。node--versionnpm--version如果你还没有安装Node.js请前往 nodejs.org下载安装长期支持版LTS。关于Node.js的安装可参考博客Node.js 与 npm 的安装与配置详细教程检查Git是否安装版本不做要求Claude Code在执行任务的时候会用到Git的一个bash命令 Git Bash是Git for Windows提供的一个模拟类Unix的命令行工具它为Claude Code提供了必要的终端环境支持执行相关命令所以需要安装可以通过查看Git版本号的命令验证是否安装了Gitgit--version如果没有安装Git可参考博客Git - 的安装与使用 进行安装三、Claude Code 的安装Claude Code有两种安装方式。个人比较推荐使用npm进行安装 ~3.1 方式一原生安装在官方文档中提供了Claude Code的安装方式有本地安装、Homebrew安装 和WinGet安装可以安装官方文档的方式来进行安装这里我就直接复制官网上的本地安装方式macOS, Linux, WSL:curl-fsSLhttps://claude.ai/install.sh|bashWindows PowerShell:irm https://claude.ai/install.ps1|iexWindows CMD:curl-fsSLhttps://claude.ai/install.cmd-oinstall.cmdinstall.cmddel install.cmd3.2 方式二npm 安装Claude Code是基于npm的形式安装的Linux/macOS安装# 全局安装 Claude Codesudonpminstall-ganthropic-ai/claude-code# 验证安装claude--versionWindows安装# 以管理员身份打开 Powershell 或命令提示符# 全局安装npminstall-ganthropic-ai/claude-code# 验证安装claude--version这里我就只演示在Windows下安装通过Win R输入cmd调出 命令提示符安装成功之后可以通过以下命令查看帮助文档claude--help四、配置代理网络或者绕过IP校验当我们安装完 Claude Code 时通过 claude 命令便可以启动claude如果你的电脑能够直接访问外网那么运行之后它 Claude Code 就能直接正常启动让你选择一个主题选择主题之后它会提供三种登录方式让你选择订阅 Claude 账户有专业版、高级版、团队版或企业版使用 API 使用计费方式第三方平台以上情况之后的步骤我就不做赘述了在国内更多情况下我们是不能直接访问外网的就会出现以下情况Unable to connect to Anthropic servicesFailed to connect to api.anthropic.com: ERR_BAD_REQUEST运行之后你会发现报了以上的错误这是因为 Claude Code 工具会校验位置信息国内是无法使用的我们有两种方式可以解决这个问题① 配置代理网络 ② 修改配置绕过校验PS我个人是比较推荐使用方式二4.1 方式一配置代理网络在当前项目目录下创建.claude/settings.json{evn:{HTTP_PROXY:http://127.0.0.1:7890,HTTPS_PROXY:http://127.0.0.1:7890}}这样做是为了给 Claude Code 配置网络代理让它在运行时通过你指定的代理服务器这里是 127.0.0.1:7890来访问外部网络。4.2 方式二修改配置绕过IP校验在C盘下C:\User\{username}找到claude的json配置文件.claude.json添加以下配置hasCompletedOnboarding:true,然后保存即可做完以上配置我们再次启动Claude Code就能发现Claude Code是启动成功的它会问你是否需要去读取这个目录文件如果我们选择Yes它会出现一个报错提示not login正常你启动的话它会用到Claude Code自带的一个模型Sonnet 4.6模型但这个模型是要收费的一个月最低也要17$这里我们可以使用API的方式就不需要去登录Claude Code的账户五、配置 API Key 环境变量这里我以接入七牛云和deepSeek的 API 为例接入七牛云API进入 七牛云 的 AI 大模型https://www.qiniu.com/ai/agent打开 七牛云 的控制台你可以创建一个 API keysk-c6159***********************783a在 七牛云 的模型广场选择一个模型例如qwen3-coder-480b-a35b-instructPS模型可以不设置如果不设置默认是claude-4.6-sonnet然后找到它的 Anthropic BaseURLhttps://api.qnaigc.com接入DeepSeek API打开 deepSeek 的 API 开放平台API 开放平台https://platform.deepseek.com/usage然后创建一个API KEY然后再打开接口文档就能找到它的Anthropic BaseURL和模型了5.1 全局配置# 临时设置setANTHROPIC_API_KEYsk-c6159***********************783asetANTHROPIC_BASE_URLhttps://api.qnaigc.com# 模型不设置默认使用 claude-4.6-sonnetsetANTHROPIC_MODELqwen3-coder-480b-a35b-instruct# 永久设置setx ANTHROPIC_API_KEYsk-c6159***********************783asetx ANTHROPIC_BASE_URLhttps://api.qnaigc.com# 模型不设置默认使用 claude-4.6-sonnetsetx ANTHROPIC_MODELqwen3-coder-480b-a35b-instruct5.2 配置文件内配置在C:\Users\{uername}\.claude\settings.json添加以下配置{env:{ANTHROPIC_API_KEY:sk-c6159***********************783a,ANTHROPIC_BASE_URL:https://api.qnaigc.com,ANTHROPIC_MODEL:qwen3-coder-480b-a35b-instruct,CLAUDE CODE ATTRIBUTION HEADER:0}}这里我是通过全局配置设置API的配置完之后这个时候我们就可以在项目中启动Claude Code六、常见问题1、 如果你按照以上方式配置好了 API 但是使用 claude 命令运行之后它还是提示你登录我们可以关闭 开发软件 或者重新打开一个文件夹打开命令提示符启动claude选择Yes之后它会提示你是否要使用API key选择Yes之后就能跳过登录了2、 模型不可用或者重新换个模型或者不进行设置