Fork me on GitHub

Claude Code使用指南

字数统计: 1.4k字   |   阅读时长≈ 5分

Claude Code 使用指南

简介

Claude Code 是由 Anthropic 开发的 AI 智能代理编码工具，运行在命令行终端中，帮助开发者将自然语言描述转化为实际代码。它不是简单的聊天机器人，而是能直接操作文件、运行命令和处理 Git 等任务的”AI 配对程序员”。

安装

前提条件

  • Node.js v18 或更高版本（nodejs.org 下载安装）
  • npm（随 Node.js 一起安装）
  • Git（git-scm.com 下载安装）

各平台安装命令

平台 命令
macOS / Linux curl -fsSL https://claude.ai/install.sh | bash
macOS Homebrew brew install --cask claude-code
Windows PowerShell irm https://claude.ai/install.ps1 | iex
npm（通用） npm install -g @anthropic-ai/claude-code

Windows 注意： 安装时请以管理员身份运行 PowerShell，否则可能出现权限错误（EPERM）。

验证安装

1
claude --version

登录方式

启动 Claude Code 后会出现三种登录方式：

选项 说明 费用
Claude 订阅账号 需要 Pro / Max / Team / Enterprise 月订阅制（Pro $20/月）
Anthropic Console 注册 console.anthropic.com 按 Token 用量计费，新用户有免费额度
第三方平台 AWS / Azure / Google Cloud 按云服务计费

免费账号不能使用第一种方式。

配置第三方模型（推荐国内用户）

国内用户由于网络限制，无法直接访问 Anthropic API，推荐使用第三方模型中转。

方法：修改配置文件

打开配置文件：

1
2
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"
notepad "$env:USERPROFILE\.claude\settings.json"

DeepSeek 配置（免费额度，国内可直接访问）

在 platform.deepseek.com 注册获取 API Key，然后填入：

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-chat",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

其他第三方模型（以 LongCat 为例）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API Key",
    "ANTHROPIC_BASE_URL": "https://api.longcat.chat/anthropic",
    "ANTHROPIC_MODEL": "LongCat-Flash-Chat",
    "ANTHROPIC_SMALL_FAST_MODEL": "LongCat-Flash-Chat",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "LongCat-Flash-Chat",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "LongCat-Flash-Chat",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "6000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

保存后重新启动 Claude Code 即可生效，无需每次手动设置环境变量。

基本使用流程

1. 启动

1
2
cd 你的项目目录
claude

2. 初始化项目

1
/init

Claude Code 会读取整个项目结构，生成 CLAUDE.md 文件保存项目知识。后续每次启动都会优先读取该文件，快速了解项目背景。

3. 日常对话编程

直接用自然语言描述需求，例如：

1
帮我写一个用户登录的 API 接口，使用 JWT 认证

Claude Code 会自动读写文件、执行命令、修改代码。

4. 压缩上下文（节省费用）

当一个任务告一段落时，执行：

1
/compact

压缩之前的对话记录，有效减少 Token 消耗。

5. 开始新任务

开始新任务前建议清理上下文：

1
/clear

常用命令速查

命令 作用
/init 初始化项目，生成 CLAUDE.md
/login 登录账号
/clear 清除当前会话上下文
/compact 压缩对话记录，减少 Token 消耗
/resume 查看并恢复历史会话
/config 打开配置界面
/help 查看所有可用命令

恢复历史对话

关闭终端后，历史对话记录会保留在本地。重新打开后：

1
claude --resume

或启动后输入 /resume，选择想继续的历史会话。

删除对话记录

删除当前会话上下文（推荐日常使用）：

1
/clear

删除所有历史记录：

1
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\projects"

手动选择删除某个项目的记录：

1
explorer "$env:USERPROFILE\.claude\projects"

官方文档

FAQ（常见问题）

Q1：Windows 执行官方安装脚本报错”Failed to download binary”

原因： 国内网络无法直接访问 claude.ai。

解决方案：

  1. 改用 npm 安装（需要先安装 Node.js v18+）：
    1
    npm install -g @anthropic-ai/claude-code
  2. 或配置代理后再执行安装脚本：
    1
    2
    $env:HTTPS_PROXY = "http://127.0.0.1:7890"
    irm https://claude.ai/install.ps1 | iex

Q2：npm 安装报错 EPERM（权限不足）

原因： 当前终端没有管理员权限。

解决方案： 右键 PowerShell → 选择”以管理员身份运行”，再重新执行安装命令。

或手动授权安装目录：

1
2
icacls "D:\Software\Nodejs\node_global" /grant "%USERNAME%":F /T
npm install -g @anthropic-ai/claude-code

Q3：启动后提示”Unable to connect to Anthropic services”

原因： 国内网络无法访问 api.anthropic.com。

解决方案：

  1. 使用代理（在 PowerShell 中）：
    1
    2
    3
    $env:HTTPS_PROXY = "http://127.0.0.1:7890"
    $env:HTTP_PROXY = "http://127.0.0.1:7890"
    claude
  2. 或配置第三方模型中转（推荐，见上方”配置第三方模型”章节）。

Q4：$env:HTTPS_PROXY 命令报错”文件名、目录名或卷标语法不正确”

原因： 在 CMD（命令提示符）中运行了 PowerShell 专属语法。

解决方案： 请使用 PowerShell 而非 CMD。

若必须使用 CMD，改用以下语法：

1
2
set HTTPS_PROXY=http://127.0.0.1:7890
set HTTP_PROXY=http://127.0.0.1:7890

Q5：设置代理后，浏览器访问网页也会走代理吗？

不会。 $env:HTTPS_PROXY 只影响当前 PowerShell 窗口内运行的程序，关闭窗口后自动失效，不影响浏览器和其他软件。

Q6：免费账号可以使用 Claude Code 吗？

免费账号不支持第一种登录方式（需要 Pro 及以上订阅）。

可选方案：

  • 注册 console.anthropic.com，使用第二种登录方式，新用户有免费额度，用完后按量付费。
  • 配置 DeepSeek 等第三方模型，完全绕过 Anthropic 账号限制。

Q7：如何切换不同的 AI 模型？

修改 ~/.claude/settings.json 文件中的以下字段即可：

1
2
3
"ANTHROPIC_BASE_URL": "新的API地址",
"ANTHROPIC_AUTH_TOKEN": "新的API Key",
"ANTHROPIC_MODEL": "新的模型名称"

保存后重启 Claude Code 生效。

赏

谢谢你请我吃糖果

支付宝
微信

扫一扫，分享到微信

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia-plus根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

一个努力学习，积极向上的程序员。