ZXBLOG-Claude Code 简介与安装

最近在深度使用 Claude Code，发现真的很香！即整理了一份全面的指南，从零开始逐步了解 Claude Code 的核心功能、高级特性和最佳实践。

这篇博客实际上更像是一本工具书，让我自己在使用时也能随时参考其内容，更好的使用这个强大的 AI 工具。

一、Claude Code 简介

1.1 什么是 Claude Code?

Claude Code(CC)是由 Anthropic 开发的系统级 AI Agent,它不仅是一个代码编写工具,更是一个可以通过自然语言指令完成各种电脑任务的智能助手。

核心特性:

全功能访问：拥有系统级权限,可执行文件操作、运行命令、管理进程等

超大上下文：支持 200K token 上下文窗口,可处理大型项目

高度可扩展：支持 MCP、Skills、Plugins、Hooks 等多种扩展方式
多代理协作：支持子代理(Subagents)并行处理复杂任务

自然交互：支持自然语言指令,无需学习复杂命令语法

1.2 Claude Code vs 传统工具

核心差异:

传统工具：单一功能,需要人工操作多个工具完成复杂任务

Claude Code：系统级 AI Agent,通过自然语言指令即可完成全流程任务

二、安装与配置

2.1 前置准备

必需工具:

工具	用途	安装地址
Node.js	运行环境	nodejs.org
Git	版本控制	git-scm.com
API Key	模型服务	智谱GLM/月之暗面K2/阿里Qwen等

验证安装:

# 检查 Node.js 版本 
node -v  
# 检查 Git 版本 
git --version

2.2 安装 Claude Code

全局安装(推荐):

npm install -g @anthropic-ai/claude-code

验证安装:

claude --version

2.3 配置模型

Claude Code 支持多种模型配置方式,你可以根据自己的需求选择合适的模型。

方式一:手动配置(通用方式)

手动配置适用于所有兼容 Anthropic API 的模型。配置方式如下:

在本机设置环境变量（推荐方式：编辑配置文件）

macOS / Linux：~/.claude/settings.json

Windows：%USERPROFILE%/.claude/settings.json

示例 settings.json（请替换API_KEY）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "API_KEY",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_MODEL": "模型名称",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_SMALL_FAST_MODEL":"模型名称"
  }
}

可以直接在你C盘用户目录下，比如：C:\Users\10133，下创建 .claude 文件夹，里面创建，settings.json 填入以上内容。

同时要在~/.claude.json 文件中加入：

"hasCompletedOnboarding": true

.claude.json 文件一般与你创建的 .claude 文件夹平级，如果第一次使用没有.claude.json文件，你可以直接运行下 claude 再回来用户目录下，会发现这个文件。

常用国内模型配置示例:

模型	API地址	模型名称	获取API Key
智谱 GLM-4.7	`https://open.bigmodel.cn/api/anthropic`	`glm-4.7`	open.bigmodel.cn/
Kimi K2	`https://api.moonshot.cn/anthropic`	`kimi-k2-turbo-preview`	platform.moonshot.cn/console/acc…
通义千问	`https://dashscope.aliyuncs.com/apps/anthropic`	`qwen-coder-plus`	bailian.console.aliyun.com/
DeepSeek	`https://api.deepseek.com/anthropic`	`deepseek-chat`	platform.deepseek.com/

到这里配置好settings.json，claude.json，claude code一般就可以使用了，可以进入你的项目目录中，然后运行：claude

其它命令：

危险模式(跳过权限确认):

claude --dangerously-skip-permissions

Headless 模式(非交互式):

git diff | claude -p "解释这些更改"

ZXBLOG

Good Luck To You!

Claude Code 简介与安装