【2025/8/15】Claude Code教程-支持API【最新篇】

【2025/8/15】Claude Code教程-支持API【最新篇】Claude Code 是为编写代码而生的 Agent 您可以像与人对话一样 使用自然语言轻松实现的想法 无需任何学习成本 只需等待一杯咖啡的时间 Claude Code 就可以为您解决所有问题 Visual Studio Code 包括 Cursor 和 Windsurf 等流行分支 JetBrains IDEs 包括 PyCharm WebStorm IntelliJ 和 GoLand

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



  • Claude Code是为编写代码而生的Agent,您可以像与人对话一样,使用自然语言轻松实现的想法,无需任何学习成本。
  • 只需等待一杯咖啡的时间,Claude Code就可以为您解决所有问题。
  • Visual Studio Code(包括 Cursor 和 Windsurf 等流行分支)
  • JetBrains IDEs(包括 PyCharm、WebStorm、IntelliJ 和 GoLand)

fk.hshwk.org/

(使用兑换码激活)

✅ 纯正Max号池搭建:拒绝第三方掺假,确保每次调用都是官方品质。

🚫 无需魔法:国内外直连,秒速响应

📊 (独家) 缓存透明计费:每一笔记录都清晰可查,不乱扣费。

🚀 (独家) 兼容官网各种报错,更少的报错

🚀 一键登录授权,无需修改配置文件

🚀 (独家) 自动检测官方版本 并一键升级

操作系统: macOS 10.15+、Ubuntu 20.04+/Debian 10+ 或通过 WSL 的 Windows (下文有)

硬件: 最少 4GB RAM

软件: Node.js 18+

1、使用 npm 全局安装 CLI 工具

 
  

2、在安装后,您可以访问您的项目文件夹,并在该目录下的终端输入以下命令直接运行 Claude Code

 
  

3、弹出登录即可使用


  1. 前置要求:
    1. Node.js(nodejs.org/)
    2. 依赖 (git-scm.com/downloads)
  2. 完成上述安装后,执行以下命令安装
 
   

~~Claude Code for Windows当前不受支持,~~但您仍可以通过WSL在Windows上部署:

WSL (Windows Subsystem for Linux),微软开源的Linux on Windows框架。

安装WSL,必须满足以下要求

  • Windows 11 或 Windows 10 21H2以上,专业版/工作站版/企业版(非家庭版,需支持Hyper-V)
  • CPU 需支持且已在 BIOS/UEFI 中启用虚拟化

安装必要的功能:

  • 在 启动以下功能:
    • Virtual Machine Platform(虚拟机平台)
    • Windows Subsystem for Linux Support(WSL1)

安装 WSL:

  • 选择您的系统版本下载 WSL 安装包或访问GitHub下载最新版本:
    • 64-Bit WSL-2.5.9.0 [推荐]
    • ARM64 WSL-2.5.9.0
    • ARM64_MicrosoftStore WSL-2.5.9.0

安装虚拟机:

  • 安装后,您可以在微软应用商店中安装最新的Ubuntu 24.04 LTS 或通过以下命令安装
    •  
    • 您也可通过选择其他系统版本
    • 安装后,您可以在终端输入访问安装的操作系统。
      • 首次用需要设置用户名和密码
        • 如果您通过开始菜单的应用访问一次,直接关闭窗口而不输入用户名和密码,下次访问将使用root用户
      • Windows将安装的操作系统虚拟机视作一个应用,如Ubuntu 24.04 LTS 会出现在您的开始菜单

安装node.js(如果您已经安装 Node.js,请确保版本为 18.0 或更高版本的要求)

 
   

确保您的npm与 Node.js可用后,请您通过以下命令安装代理的Claude Code:

 
   
  • 如果您先前安装过 Claude Code,请您务必先通过以下命令卸载
    •  

在安装后,您可以访问您的项目文件夹,并在该目录下的终端输入以下命令直接运行 Claude Code

 
   

在这之后,您需要选择主题、并允许ClaudeCode 访问所在目录文件。

恭喜您!您已经完成了 Claude Code的安装与部署🎉🎉🎉

对于 WSL 使用的推荐:

  • 如果您首次使用WSL,请在弹出的 页面了解使用帮助,您也可以在 中找到入口。
  • WSL 不只是 命令行版本的 Linux 操作系统。他是桌面环境!
    • 如果您是高级用户,或想使用桌面环境,建议您访问此Github仓库获取帮助。
  • 我们推荐您使用VSCode的WSL插件, 连接并使用您的WSL
    • 推荐您在安装插件后使用 启动VSCode,这样启动可使用 Claude Code IDE 插件。
  • 我们推荐您在(这是一个应用,安装WSL后可在开始菜单找到)配置如下功能:
    • 网络 > 网络模式 = Mirrored
      • 这将使 WSL 共享本地端口与IP。
    • 网络 > 已启用自动代理 = 打开
      • 在登录前不要启用,确保您的代理允许本地LAN连接,否则这将导致网络失效。
      • 如果您不清楚这是什么,请不要打开此功能
  • 对于Windows本身的文件系统,您可以通过以下命令访问。WSL将您的每个磁盘视为下的一个文件夹
    •  
    • 如果您需要跨文件系统编辑文件,建议您为Claude Code添加以下记忆:
    •  
    • 如果您需要访问 WSL 的文件系统,您可以通过资源管理器访问以下目录实现:
    •  
    • 我们十分不推荐直接跨文件系统传输文件并跨平台运行,这可能导致一些意外的bug。

(如果使用上面镜像安装教程就不需要用API安装方式了)

以下是 Windows、macOS 和 Linux 系统下设置 和 环境变量的详细方法:

Windows 系统

方法1:临时设置(仅当前终端有效)
  • PowerShellCMD 中执行:
    •  
方法2:永久设置(全局生效)
  1. 图形界面
    1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
    2. 在「用户变量」或「系统变量」中新建:
      • 变量名:
      • 变量值:
    3. 同样方法添加
  2. PowerShell 永久设置
    1.  
    2. 重启终端后生效。
方法3:配置settings.json
  • 创建 文件,内容如下:
    •  

macOS 系统

方法1:临时设置(仅当前终端有效)
  • 终端 中执行:
    •  
方法2:永久设置
  1. 编辑 shell 配置文件(根据使用的 shell 选择):
    1.  
  2. 立即生效:
    1.  
方法3:配置settings.json
  • 创建 文件,内容如下:
    •  

Linux 系统

方法1:临时设置(仅当前终端有效)
  • 终端 中执行:
    •  
方法2:永久设置
  1. 编辑 shell 配置文件(根据使用的 shell 选择):
    1.  
  2. 立即生效:
    1.  
方法3:配置settings.json
  • 创建 文件,内容如下:
    •  

通用验证方法

在所有系统中,可以通过以下命令验证是否设置成功:

 
      

docs.anthropic.com/zh-CN/docs/…


  • Claude Code 提供两种主要的交互方式:
    • 交互模式:运行 启动 REPL 会话
    • 单次模式:使用 进行快速命令
    • 您可以参考:
    •  
  • 对于 Claude Code Client的常用参数和功能,您可以访问官方文档:CLI 使用和控制 - Anthropic
  • 您可以直接在IDE中看到Claude Code的改动,在IDE中与其交互。
  • 现在支持 VSCode 与 JetBrains
  • 如果您使用Linux / MacOS,您可以直接使用该插件
    • 如果您使用VSCode,在VSCode的内置终端唤起Claude Code,插件将被自动安装
    • 如果您使用JetBrains,您需要通过此链接下载:Claude Code [Beta] - IntelliJ IDEs Plugin | Marketplace
  • 您可能需要手动指定IDE,通过在Claude Code进行以下交互选择
 
       
  • 对于更多的用法,您可以参考Claude Code的官方文档:IDE integrations - Anthropic

方法一:直接安装插件

方法二、基于wsl

使用本质:在cursor中本地连接Ubuntu终端使用Claude Code,可以可视化代码的操作!步骤如下:

序号 操作 图例 1 打开cursor 2 点击左下角终端图标 3 在弹出来的选项框里点击第三个;在弹出来的新选项框里点击Ubuntu选项,cursor就会自动连接Ubuntu系统。 连接完成后显示

没有Connect to WSL using Distro选项

若打开只有2个选项,没有五个选项,原因是没有安装扩展,安装扩展之后重启即可。

按下图依次点击,进入扩展界面。

扩展详情页

在搜索框里搜索WSL,找到图示这个扩展,不要选错,点击安装。安装过程需要翻墙,不然可能会因为网络安装失败。

此时再点击就有5个选项,选择第三个就行!

  • 我们强烈推荐您使用Claude 4 Sonnet(默认的),其使用体验与Claude 4 Opus没有明显差别,但计费倍率仅为1/5。
  • 如果更换请查阅官网指令

  • Claude Code 通常会有长上下文,我们建议您使用以下斜杠命令来压缩以节省点数,较长的上下文往往需要更多点数。

 
       

6. 恢复以前的对话:

  • 使用以下命令可以恢复您上次的对话
    •  
    • 这会立即恢复您最近的对话,无需任何提示。
  • 您如果需要显示时间,可以输入此命令
    •  
    • 这会显示一个交互式对话选择器,显示:
      • 对话开始时间
      • 初始提示或对话摘要
      • 消息数量
    • 使用箭头键导航并按Enter选择对话,您可以使用这个方法选择上下文。
  • 您可以使用以下任何方法:
    • 将图像拖放到Claude Code窗口中(在MacOS上)
    • 复制图像并使用粘贴到CLI中(在MacOS上)
    • 提供图像路径
    •  
  • 您可以完全使用自然语言要求他进行工作,如:
    •  
  • 您需要通过自然语言要求其进行深入思考
    •  
    • 推荐您在使用复杂问题的时候使用这一功能,这也会消耗大量的额度点数。
  • 您可以使用以下命令设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。
    •  
    • 包括常用命令(构建、测试、lint)以避免重复搜索
    • 记录代码风格偏好和命名约定
    • 添加特定于您项目的重要架构模式
    • CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。
    • 更多关于记忆的设置,您可以访问此官方文档了解:Claude Code 概述 - Anthropic
    • 在官方文档中,此部分记录了记忆的常用用法:管理Claude的内存 - Anthropic
  • Claude Code 提供非交互模式,用于无头执行。这在非交互上下文(如脚本、管道和 Github Actions)中运行 Claude Code 时特别有用。
  • 使用 () 在非交互模式下运行 Claude,如:
    •  
  • 模型上下文协议(MCP)是一个开放协议,使LLM能够访问外部工具和数据源。
  • 这是高级功能,您可以访问此文档获取更多配置信息:Introduction - Model Context Protocol
  • Claude Code不仅支持接入MCP,同样支持作为MCP服务器等各类高级功能,您可以访问此文档获得更多信息:教程 - Anthropic
  • Claude Code 支持使用自然语言操作Git,如:
 
       
  • 您可以使用工作树创建隔离的编码环境。
  • 如果您您需要同时处理多个任务,并在Claude Code实例之间完全隔离代码,您可以使用此功能:
    • Git工作树允许您从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录,文件是隔离的,同时共享相同的Git历史。在官方Git工作树文档中了解更多。
    • 创建新工作树
      •  
      • 这会创建一个包含存储库单独工作副本的新目录。
    • 在每个工作树中运行Claude Code
      •  
    • 在另一个终端中:
      •  
    • 管理您的工作树
      •  
    • 每个工作树都有自己独立的文件状态,非常适合并行Claude Code会话
    • 在一个工作树中所做的更改不会影响其他工作树,防止Claude实例相互干扰
    • 所有工作树共享相同的Git历史和远程连接
    • 对于长时间运行的任务,您可以让Claude在一个工作树中工作,同时您在另一个工作树中继续开发
    • 使用描述性目录名称,以便轻松识别每个工作树的任务
    • 记得根据项目的设置在每个新工作树中初始化开发环境。根据您的技术栈,这可能包括:
      • JavaScript项目:运行依赖安装(、)
      • Python项目:设置虚拟环境或使用包管理器安装
      • 其他语言:遵循项目的标准设置流程
  • 识别未文档化的代码
    •  
  • 生成文档
    •  
  • 理解陌生代码
    •  
  • 智能编辑代码
    •  
  • 测试或编辑您的代码
 
       

14. 常见的斜杠命令:

 
       

  • 使用 快速记忆
    • 通过以 开始输入来即时添加记忆
  • 始终使用描述性变量名
    • 系统会提示你选择要将其存储在哪个记忆文件中。
  • 终端中的换行
    • 使用以下方式输入多行命令:
    • 快速转义:输入 “ 后按 Enter
    • 键盘快捷键:Option+Enter(或配置后的 Shift+Enter)
      • 在终端中设置 Option+Enter:
        • 对于 Mac Terminal.app
          • 打开设置 → 配置文件 → 键盘
          • 勾选”将 Option 键用作 Meta 键”
        • 对于 iTerm2 和 VSCode 终端:
          • 打开设置 → 配置文件 → 按键
          • 在常规设置下,将左/右 Option 键设置为”Esc+”
        • iTerm2 和 VSCode 用户提示:在 Claude Code 中运行 以自动配置 Shift+Enter 作为更直观的替代方案。
        • 有关配置详情,请参见官方文档:设置中的终端设置。
  • Vim 模式
    • Claude Code 支持一部分 Vim 键绑定,可以通过 启用或通过 配置。
    • 支持的功能包括:
      • 模式切换:(到 NORMAL),/,/,/(到 INSERT)
      • 导航:///,//,//,/
      • 编辑:,////,////,(重复)

  • 400 - :您的请求格式或内容存在问题。我们也可能对下面未列出的其他 4XX 状态码使用此错误类型。
  • 401 - :您的 API 密钥存在问题。
  • 403 - :您的 API 密钥没有使用指定资源的权限。
  • 404 - :未找到请求的资源。
  • 413 - :请求超过了允许的最大字节数。 建议使用/compact命令
  • 429 - :您的账户达到了速率限制。
  • 500 - :Anthropic 系统内部发生了意外错误。
  • 529 - :Anthropic 的 API 暂时过载。
  • 当 Anthropic API 在所有用户中遇到高流量时,可能会出现 529 错误。在极少数情况下,如果您的组织使用量急剧增加,您可能会看到此类错误。 为避免 529 错误,请逐步增加流量并保持一致的使用模式。

当通过 SSE 接收流式响应时,可能在返回 200 响应后发生错误,在这种情况下错误处理不会遵循这些标准机制。

  • Claude Code可以被用作Claude用作类Unix工具:教程 - Anthropic
  • Claude Code支持自定义斜杠指令:教程 - Anthropic
  • Claude Code支持使用添加命令参数:教程 - Anthropic
  • Claude Code支持高级设置,您可以参考此文档:Claude Code 设置 - Anthropic
    • 命令行参数
    • 本地项目设置
    • 共享项目设置
    • 用户设置
  • Claude Code的安全设置,请参考此官方文档:管理权限和安全 - Anthropic

小讯
上一篇 2026-04-04 19:53
下一篇 2026-04-04 19:51

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/222961.html