Claude Code 终端使用教程

✍️作者简介：小北编程（专注于HarmonyOS、Android、Java、Web、TCP/IP等技术方向）
🐳博客主页： 开源中国、稀土掘金、51cto博客、博客园、知乎、简书、慕课网、CSDN
🔔如果文章对您有一定的帮助请👉关注✨、点赞👍、收藏📂、评论💬。
🔥如需转载请参考【转载须知】

Claude Code 安装与初始化

前言

Claude Code 是 Anthropic 推出的一款 Agentic 编程工具，将 AI 编程助手带到终端 CLI 中。安装后，你只需在项目目录下执行 claude 命令，即可通过自然语言与 AI 协作完成编码、调试、重构、代码审查等任务。无需切换界面，所有交互都在你熟悉的终端中完成。

然而，由于 Claude 官方服务对中国大陆地区的限制，国内开发者直接使用存在网络和支付门槛。本文将从零开始，手把手带你完成 Claude Code 的安装，并通过配置国产模型（Kimi/Qwen/DeepSeek）实现平替，让你在终端中免费或低成本享受 AI 编程体验。

一、环境要求

环境要求 下载地址
操作系统 macOS / Windows / Linux
Node.js ≥ 18.0.0 Node.js 官网：https://nodejs.org/
npm ≥ 9.0.0 Node已带有npm如需指定版本安装： npm install -g npm@11.17.0
Claude Code GitHub GitHub：https://github.com/anthropics/claude-code

二、环境检查与安装

1. 安装步骤

# 如果网络延迟，先配置淘宝镜像源（安装前执行）
npm config set registry https://registry.npmmirror.com

# 通过 npm 全局安装
npm install -g @anthropic-ai/claude-code

# 已安装后，更新到最新版本
claude install

在上述安装中如果不支持 npm 命令请检查是否安装 Node.js
如未安装前往 Node.js 官网下载安装 LTS：https://nodejs.org/

如果 Node.js 安装成功 可返回上面的执行 npm命令操作

验证是否安装成功

分别执行以下命令，如果都能正常返回对应的版本号，则表示安装成功。
# 可以使用 -version 简称 -v 
claude -v 
npm -v 
node -v

2. 官方推荐安装方式（由于时间问题未验证）

官方已明确表示，通过npm安装的方式已废弃（deprecated），并推荐使用其他包管理器或脚本安装
Claude Code 安装参考

项目 要求 / 推荐方式 说明
操作系统 macOS / Windows / Linux 官方支持的主流系统
安装方式 (推荐) macOS/Linux:
curl -fsSL https://claude.ai/install.sh | bash

macOS/Linux (Homebrew):
brew install --cask claude-code

Windows (推荐):
irm https://claude.ai/install.ps1 | iex

Windows (WinGet):
winget install Anthropic.ClaudeCode		 官方推荐的安装方法，更稳定可靠。

三、修改 claude 配置文件

1、根据当前操作系统，打开对应位置的 .claude.json 文件：

系统 配置文件路径 示例
Windows C:\Users\用户名\.claude.json C:\Users\DELL\.claude.json
macOS ~/.claude.json /Users/用户名/.claude.json
Linux ~/.claude.json /home/用户名/.claude.json

2、编辑配置文件

使用 VS Code、Notepad、Cursor 等文本编辑器打开文件，并确保包含以下配置：

{
  "hasCompletedOnboarding": true
}

如果文件中已经存在其他配置，只需添加或修改该字段即可。

示例：

{
  "hasCompletedOnboarding": true,
  "theme": "dark"
}

四、配置环境变量及大模型

⚠️ 重要提示：国产模型厂商的 API 接口格式必须与 Anthropic API 兼容，才能通过 ANTHROPIC_BASE_URL 配置使用。建议优先选择明确标注「Anthropic 兼容 API」的服务商。

1.获取 Kimi API Key

访问 API 渠道平台
注册 / 登录账号
进入「API Key 管理」创建新 Key
复制 Key（格式：sk-xxxxxxxx）

⚠️ 注意：现在的大模型基本都需要收费，可根据自己的需求使用自己的大模型

2.设置环境变量（macOS / Linux / Windows）

Windows 用户配置环境变量

通过「系统属性」→「环境变量」→「新建系统变量」添加：

变量名 值
ANTHROPIC_AUTH_TOKEN sk-your-key
ANTHROPIC_BASE_URL https://api.xxx.com
ANTHROPIC_MODEL kimi-k2.6

或通过命令行临时设置：

set ANTHROPIC_AUTH_TOKEN=sk-your-key

Anthropic 环境变量配置说明

变量名 说明
ANTHROPIC_AUTH_TOKEN 自定义 Authorization 头的值（系统会自动添加 Bearer 前缀）。
ANTHROPIC_API_KEY API 密钥，作为 X-Api-Key 请求头发送。
ANTHROPIC_BASE_URL API 的基础 URL 地址。
ANTHROPIC_MODEL 覆盖默认使用的模型。
ANTHROPIC_SMALL_FAST_MODEL 指定 Haiku 级别模型，用于后台任务以平衡速度与成本。
MAX_THINKING_TOKENS 设置思考模式下的 Token 预算上限（设为 0 可禁用思考模式）。
DISABLE_COST_WARNINGS 设为 1 时可禁用费用相关的警告提示。

编辑配置文件增加环境变量

# Mac 编辑配置文件
# 1. 先确认你用的是哪种 Shell
echo $SHELL

# 2. 根据 Shell 类型编辑配置文件
# → 如果输出 /bin/zsh，编辑 ~/.zshrc
# → 如果输出 /bin/bash，编辑 ~/.bash_profile

# 编辑方式二选一（选你顺手的）：
nano ~/.zshrc          # 终端内编辑（保存：Ctrl+O，退出：Ctrl+X）（注：Ctrl = control）
code ~/.zshrc          # VS Code 编辑（保存：Command+S）

# 3. 让配置生效
source ~/.zshrc        # 如果用的是 bash，改成 source ~/.bash_profile


# 方式一：当前终端会话生效
export ANTHROPIC_AUTH_TOKEN="sk-your-key"  # 替换成自己的key
export ANTHROPIC_BASE_URL="https://api.xxx.com" # 替换为你的代理地址
export ANTHROPIC_MODEL="kimi-k2.6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k2.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k2.6"
export CLAUDE_CODE_SUBAGENT_MODEL="kimi-k2.6"
# 方式二：如需永久生效，写入 ~/.zshrc 或 ~/.bashrc
echo 'export ANTHROPIC_MODEL="kimi-k2.6"' >> ~/.zshrc

注意：这填写自己的 ANTHROPIC_AUTH_TOKEN 替换成自己的 token 密钥
注意： 这里的 ANTHROPIC_BASE_URL 需要根据自己申请的 url

为什么需要用国产模型平替？

由于以下原因，直接使用 Claude 官方 API 可能存在困难：

  • 🌍 网络访问限制：Claude 官方 API 需要境外网络环境，国内直连可能不稳定或无法访问
  • 🚫 地区限制：Anthropic 官方服务暂未对中国大陆地区开放注册和使用
  • 💳 支付门槛：国际信用卡支付对国内开发者不够友好

解决方案：国产模型平替

使用国产大模型替代 Claude 官方模型，通过配置 ANTHROPIC_BASE_URL 指向国内厂商的 API 地址，即可正常使用 Claude Code 的核心功能：

# Kimi（月之暗面）- 超长上下文，适合处理大型代码库
export ANTHROPIC_BASE_URL="https://api.moonshot.cn/v1"
export ANTHROPIC_MODEL="moonshot-v1-8k"

# Qwen（通义千问）- 阿里云出品，代码能力强
export ANTHROPIC_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export ANTHROPIC_MODEL="qwen-coder-plus"

# DeepSeek - 高性价比，推理能力强
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_MODEL="deepseek-chat"

对比说明

方案 优点 缺点
Claude 官方 模型效果最佳，代码能力最强 需要代理，国内无法直接使用，支付不便
国产模型平替 无需代理，国内直连，支付方便 部分场景下代码能力略逊于 Claude 4 系列

最终建议

💡 建议：有代理条件的开发者优先使用 Claude 官方 API（ANTHROPIC_BASE_URL 设为 https://api.anthropic.com）；网络受限的开发者推荐使用 Kimi 或 Qwen 作为平替，两者在代码理解和生成方面表现较为接近。

3 . 在 Claude Code settings.json 中设置

进入你的项目目录 编辑 ~/.claude/settings.json（如果不存在则创建），添加 env 配置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}

五、使用 Claude

# 进入你的项目目录
cd my-demo
# 启动 Claude Code（首次运行会自动初始化配置）
claude
# 或显式初始化
claude init
# 如果是已有项目目录结构
# 生成的文档结构
my-demo/
├── .claude/
│ ├── CLAUDE.md ← 项目级规则文件（核心）
│ ├── memory/ ← 上下文记忆存储
│ └── settings.json ← 工具配置
└── src/


# 再次进入需要重新启动大模型
claude
# 在交互终端中输入
> /help
# 看到指令列表即表示环境就绪
# 尝试第一条指令
> /usage
# 输出当前会话 Token 消耗

注意：

Claude Code 初始化（claude init）适用于已有项目。

在执行初始化之前，需要先具备一个真实的代码工程，例如 Android / iOS / HarmonyOS / React Native / Node 等项目。

claude init 的作用是：
- 为现有项目生成 .claude 配置
- 建立项目级规则（CLAUDE.md）
- 帮助 Claude Code 理解当前代码结构

它不是项目脚手架工具，不能用来创建新工程。
如果需要新项目，应使用对应框架的初始化命令（如 create-react-native-app、Android Studio 模板等）。

注意：
你现在的项目里没有 .claude/ 文件夹，是正常的，原因是：

👉 Claude Code 不会自动创建完整 .claude/ 目录结构
👉 只有在你显式执行初始化流程或手动创建时才会出现

🔥 为什么不会自动生成 .claude/？
因为 Claude Code 的设计理念是：
轻量接入，而不是强框架

它只负责：
读取代码
理解项目
使用 CLAUDE.md 作为规则入口

.claude/（可选扩展结构）
只有你自己创建才有意义：
mkdir -p .claude/memory
touch .claude/settings.json

六、Claude Code 常用命令总结

1. Claude CLI 命令参考

命令 说明 示例
claude 启动交互式对话模式。 claude
claude "任务" 执行一次性任务（非交互模式）。 claude "修复构建错误"
claude -p "查询" 执行查询后立即退出（适合脚本调用）。 claude -p "解释这个函数"
claude -c 继续当前目录下最近的对话。 claude -c
claude -r 恢复之前的某个对话。 claude -r
claude commit 快速创建 Git 提交（通常配合 AI 生成提交信息）。 claude commit

2. 交互模式内置命令

在交互模式中，可以使用以下内置命令：

命令 功能
/help 显示帮助信息
/clear 清除对话历史
/config 打开设置面板
/model 切换模型
/mcp 管理 MCP 服务
/compact 压缩上下文
/memory 管理记忆
/login 切换账号
exit 或 Ctrl+C 退出交互模式

3. Claude CLI 对话交互示例：

# 启动交互模式，进行多轮对话
 claude
# 分析项目
> 这个项目是做什么的？
# 修 Bug
> 用户提交空表单时没有提示，帮我修复这个问题
# 编写测试
> 为计算器函数编写单元测试
# 重构代码
> 把认证模块改成 async/await 写法
# Git 操作
> 提交我的修改，写一个描述性的提交信息
> 为这个功能创建一个 PR
# 代码审查
> 帮我 review 一下这个 PR 的改动
# 解释代码
> 解释一下这个函数的逻辑
# 添加注释
> 给这段代码加上中文注释
# 性能优化
> 分析一下这个接口的性能瓶颈
# 生成文档
> 为这个 API 生成使用文档
# 调试问题
> 这个报错是什么意思？怎么解决？

# 快速查询（单次问答后退出）
claude -p "如何查看 Linux 端口占用？"
# 执行一次性任务
claude "帮我格式化这个 JSON 文件"

4. 管道和脚本化操作

Claude Code 遵循 Unix 哲学，支持管道和脚本化操作：

# 错误日志分析（修正：tail -f 实时监控配合查询）
tail -100 app.log | claude -p "分析这些错误日志，找出最严重的问题"

# Git 代码审查
git diff main | claude -p "审查这些改动，指出潜在问题和改进建议"

# 代码质量检查
git diff --cached | claude -p "检查这段代码的安全隐患和性能问题"

# 自动生成提交信息
git diff --cached | claude -p "根据这次改动生成符合 Conventional Commits 格式的提交信息"

# 文件内容处理
cat README.md | claude -p "帮我优化这份文档的表达和结构"

# 批量翻译
cat zh.json | claude -p "将这个 JSON 中的中文值翻译成英文"

# 测试覆盖率分析
npm run test:coverage | claude -p "分析测试覆盖率报告，指出测试薄弱环节"

# 依赖安全检查
npm audit | claude -p "分析安全漏洞，按严重程度排序并给出修复建议"

# 持续集成脚本（在 CI 中使用）
if [ $? -ne 0 ]; then
    echo "构建失败，分析错误："
    npm run build 2>&1 | claude -p "分析构建失败原因并给出解决方案"
fi

# 组合多个命令
git log --oneline -10 | claude -p "总结最近 10 次提交的主要内容" | tee summary.txt

# 文档生成自动化
ls src/*.js | xargs -I {} cat {} | claude -p "为所有函数生成 JSDoc 注释"

5 . 常用脚本示例

.husky/pre-commit - Git 提交前代码审查：

#!/bin/sh
git diff --cached | claude -p "快速检查这段代码是否有明显问题，有问题就输出 WARNING，没问题就输出 OK"

bin/review-pr.sh - PR 自动审查脚本：

#!/bin/bash
git diff main...HEAD | claude -p "审查这个 PR 的改动，输出：\n1. 主要变更概述\n2. 潜在问题\n3. 优化建议"

七、总结

Claude Code 本质上是一个终端里的 AI 编程伙伴。它不会取代你的编程能力，但能显著提升你的效率——把重复性、机械性的工作交给 AI，让你专注于更有创造力的部分。

本文从零开始，带你完成了 Claude Code 的安装、配置到使用的完整闭环：

阶段 关键动作 验收标准
⚙️ 环境准备 安装 Node.js ≥ 18.0.0 node -v 正常输出版本号
📦 安装工具 npm install -g @anthropic-ai/claude-code claude -v 正常输出版本号
🔑 配置模型 设置 ANTHROPIC_AUTH_TOKEN 等环境变量 claude -p "hello" 正常返回
🚀 项目使用 进入项目目录执行 claude 进入交互式对话界面

这篇文章帮你解决了什么问题？

问题 解决方案 对应章节
Claude 官网打不开 配置国产模型平替（Kimi/Qwen/DeepSeek） 第四章
国内无法注册 Claude 通过 ANTHROPIC_BASE_URL 指向国内 API 第四章
终端不会配置环境变量 提供 nano/code 两种编辑方式，分步指引 第四章
不知道如何开始使用 提供交互对话、单次查询、管道脚本三种模式 第五、六章
每次都要重新配置 写入 ~/.zshrc 永久生效 第四章

核心配置三要素

回顾整个安装过程，最关键的其实就是这三步：

# 1️⃣ 安装工具
npm install -g @anthropic-ai/claude-code

# 2️⃣ 配置密钥（写入 ~/.zshrc）
export ANTHROPIC_AUTH_TOKEN="sk-xxx"
export ANTHROPIC_BASE_URL="https://your-api.com"

# 3️⃣ 开始使用
cd your-project && claude

实用资源

注意事项

  • 🔑 API Key 需妥善保管，避免泄露
  • 💰 大模型 API 均为付费服务，注意用量控制
  • 🔄 国产模型需确认 API 格式与 Anthropic 兼容

✍️写作不易，如果文章对您有些许的帮助请帮忙点赞👍收藏📂您的支持是我写下去的动力💪

无论是哪个阶段，坚持努力都是成功的关键。不要停下脚步，继续前行，即使前路崎岖，也请保持乐观和勇气。相信自己的能力，你所追求的目标定会在不久的将来实现。加油！

posted @ 2026-06-26 11:19  小北编程  阅读(2)  评论(0)    收藏  举报