Claude Code 完整教程

从注册账号到安装使用，轻松掌握 Claude Code AI 编程助手的完整流程。

注册 Claude Code 账号

访问 https://api.wanai.de 完成账号注册

步骤 1.1：选择注册方式

支持多种注册方式，选择您偏好的方式：

支持邮箱、LinuxDo、GitHub 三种注册方式

步骤 1.2：完成注册登录

根据选择的方式完成注册流程，登录成功后进入控制台：

登录成功后的控制台界面

步骤 1.3：进入 API 令牌页面

在左侧导航栏中找到并点击"API令牌"：

点击侧边栏的"API令牌"菜单

步骤 1.4：创建新的 API 令牌

点击"添加令牌"按钮：

点击"添加令牌"按钮

步骤 1.5：配置令牌参数

填写令牌信息：

名称：可以填写 "Claude Code" 或任意名称
额度：建议设置为"无限制"
令牌分组：选择claudecode分组
其他选项保持默认设置

填写令牌名称和配置额度

步骤 1.6：获取 API 令牌

点击"提交"后，系统会生成以 sk- 开头的 API 令牌：

🔑

重要提醒： 请立即复制并妥善保存您的 API 令牌（sk-xxx），这是后续使用 Claude Code 的关键凭证！

成功创建的 API 令牌（以 sk- 开头）

完成注册并获取 API 令牌后，跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。

1 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

Windows 安装方法

方法一：官网下载（推荐）

打开浏览器访问 https://nodejs.org/
点击 "LTS" 版本进行下载（推荐长期支持版本）
下载完成后双击 .msi 文件
按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey

choco install nodejs

# 或使用 Scoop

scoop install nodejs

Windows 注意事项

• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version

npm --version

如果显示版本号，说明安装成功了！

2 安装 Claude Code

安装 Claude Code

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 Claude Code

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

提示

• 建议使用 PowerShell 而不是 CMD，功能更强大
• 如果遇到权限问题，以管理员身份运行 PowerShell

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：PowerShell 临时设置（当前会话）

在 PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL = "https://api.wanai.de"

$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

方法二：PowerShell 永久设置（用户级）

在 PowerShell 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量（永久生效）

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.wanai.de", [System.EnvironmentVariableTarget]::User)

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

# 查看用户级环境变量

[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)

[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

💡 设置后需要重新打开 PowerShell 窗口才能生效。

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL

echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中验证：

echo %ANTHROPIC_BASE_URL%

echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

https://api.wanai.de

sk-xxxxxxxxxxxxxxxxxx

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

4 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录

cd C:\path\to\your\project

# 启动 Claude Code

claude

Windows 常见问题解决

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

以管理员身份运行 PowerShell
或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效

设置永久环境变量后需要：

重新启动 PowerShell 或 CMD
或者注销并重新登录 Windows
验证设置：echo $env:ANTHROPIC_BASE_URL

1 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

macOS 安装方法

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

# 更新 Homebrew

brew update

# 安装 Node.js

brew install node

方法二：官网下载

访问 https://nodejs.org/
下载适合 macOS 的 LTS 版本
打开下载的 .pkg 文件
按照安装程序指引完成安装

macOS 注意事项

• 如果遇到权限问题，可能需要使用 sudo
• 首次运行可能需要在系统偏好设置中允许
• 建议使用 Terminal 或 iTerm2

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

node --version

npm --version

如果显示版本号，说明安装成功了！

2 安装 Claude Code

安装 Claude Code

打开 Terminal，运行以下命令：

# 全局安装 Claude Code

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

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：临时设置（当前会话）

在 Terminal 中运行以下命令：

export ANTHROPIC_BASE_URL="https://api.wanai.de"

export ANTHROPIC_AUTH_TOKEN="你的API密钥"

💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

# 对于 zsh (默认)

echo 'export ANTHROPIC_BASE_URL="https://api.wanai.de"' >> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc

source ~/.zshrc

# 对于 bash

echo 'export ANTHROPIC_BASE_URL="https://api.wanai.de"' >> ~/.bash_profile

echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile

source ~/.bash_profile

4 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 Claude Code

claude

macOS 常见问题解决

安装时提示权限错误

尝试以下解决方法：

使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
或者配置 npm 使用用户目录：npm config set prefix ~/.npm-global

macOS 安全设置阻止运行

如果系统阻止运行 Claude Code：

打开"系统偏好设置" → "安全性与隐私"
点击"仍要打开"或"允许"
或者在 Terminal 中运行：sudo spctl --master-disable

环境变量不生效

检查以下几点：

确认修改了正确的配置文件（.zshrc 或 .bash_profile）
重新启动 Terminal
验证设置：echo $ANTHROPIC_BASE_URL

1 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

Linux 安装方法

方法一：使用官方仓库（推荐）

# 添加 NodeSource 仓库

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js

sudo apt-get install -y nodejs

方法二：使用系统包管理器

虽然版本可能不是最新的，但对于基本使用已经足够：

# Ubuntu/Debian

sudo apt update

sudo apt install nodejs npm

# CentOS/RHEL/Fedora

sudo dnf install nodejs npm

Linux 注意事项

• 某些发行版可能需要安装额外的依赖
• 如果遇到权限问题，使用 sudo
• 确保你的用户在 npm 的全局目录有写权限

验证安装是否成功

安装完成后，打开终端，输入以下命令：

node --version

npm --version

如果显示版本号，说明安装成功了！

2 安装 Claude Code

安装 Claude Code

打开终端，运行以下命令：

# 全局安装 Claude Code

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

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：临时设置（当前会话）

在终端中运行以下命令：

export ANTHROPIC_BASE_URL="https://api.wanai.de"

export ANTHROPIC_AUTH_TOKEN="你的API密钥"

💡 记得将 "你的API密钥" 替换为在上方 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件：

# 对于 bash (默认)

echo 'export ANTHROPIC_BASE_URL="https://api.wanai.de"' >> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc

source ~/.bashrc

# 对于 zsh

echo 'export ANTHROPIC_BASE_URL="https://api.wanai.de"' >> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc

source ~/.zshrc

4 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 Claude Code

claude

Linux 常见问题解决

安装时提示权限错误

尝试以下解决方法：

使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
或者配置 npm 使用用户目录：npm config set prefix ~/.npm-global
然后添加到 PATH：export PATH=~/.npm-global/bin:$PATH

缺少依赖库

某些 Linux 发行版需要安装额外依赖：

# Ubuntu/Debian

sudo apt install build-essential

# CentOS/RHEL

sudo dnf groupinstall "Development Tools"

环境变量不生效

检查以下几点：

确认修改了正确的配置文件（.bashrc 或 .zshrc）
重新启动终端或运行 source ~/.bashrc
验证设置：echo $ANTHROPIC_BASE_URL

🎉 恭喜你！

你已经成功注册账号、安装并配置了 Claude Code，现在可以开始享受 AI 编程助手带来的便利了。

如果在使用过程中遇到任何问题，可以查看官方文档或社区讨论获取帮助。

这里提供 ZCF（Zero Config Framework）工具的详细使用教程，帮助你快速上手 AI 开发工作流。

ZCF 工具简介

ZCF（Zero Config Framework）是一个零配置的 AI 开发利器，能够帮助我们快速设置 Claude Code 进行 AI 开发。只需通过简单的命令 npx zcf，即可启动交互式菜单，选择所需的操作。

🚀 核心特性

• 零配置，一键式设置
• 支持中文/英文多语言
• 智能安装和配置管理
• 自动更新功能

⚡ 高级功能

• BMad 企业级工作流系统
• Claude Code Router (CCR)
• API 成本优化
• 自定义路由支持

1 快速开始

直接运行 ZCF

最简单的使用方式，无需安装，直接运行：

# 启动 ZCF 交互式菜单

npx zcf

运行后会出现交互式菜单，根据提示选择您的配置选项，包括初始化 Claude Code、导入工作流程等。

ZCF交互式菜单

2 常用命令

基础命令

npx zcf

启动交互式菜单

npx zcf i

初始化 ZCF 配置

npx zcf u

更新工作流程

高级命令

npx zcf ccr

打开 CCR 管理菜单

npx zcf --help

查看帮助信息

npx zcf --version

查看版本信息

常见问题解决

运行 npx zcf 时提示网络错误

解决方法：

确保网络连接正常，可以访问 npm 仓库
尝试使用国内镜像：npm config set registry https://registry.npmmirror.com
检查防火墙设置，确保允许 Node.js 网络访问

配置 API 密钥后仍无法使用

检查以下几点：

确认 API 密钥格式正确（通常以 sk- 开头）
验证 API 密钥是否有足够的权限和额度
重新运行 npx zcf 进行重新配置

Node.js 版本不兼容

ZCF 需要 Node.js 14 或更高版本：

检查当前版本：node --version
更新 Node.js 到最新 LTS 版本
使用 nvm 管理多版本 Node.js 环境

🎯 开始你的 AI 开发之旅

现在你已经掌握了 ZCF 工具的使用方法，可以开始高效的 AI 开发工作了！

💡 小贴士：建议先用 npx zcf 体验交互式菜单，熟悉基本功能后再深入学习高级特性。

Claude Code 完整使用指南：从基础操作到高级特性，掌握AI编程的全部技能。跟着这个教程，让你成为AI编程的高手！

从零到一完整指南

实际案例演示

高级技巧分享

快速入门指南

完成注册和安装后，就可以开始使用Claude Code了！以下是基本的使用流程。

💡 第一次使用项目

cd your-project

claude

/init-project

强烈建议运行 /init-project 生成项目说明文档

🔧 基础开发流程

claude

你的开发需求

直接输入需求，AI会自动执行开发任务

💡 使用提示

Claude Code 支持中文交流，你可以用中文描述需求，AI 会理解并帮你完成开发任务。

1 核心工作流程

直接执行

适合小任务和修复

claude

修复登录页面的样式问题

遵循 SOLID、KISS、DRY、YAGNI 原则，快速完成任务。

功能开发

结构化的新功能开发

/feat 用户头像上传功能

分为规划和UI两个阶段，系统化开发新功能。

完整工作流

六阶段开发流程

/workflow 电商支付系统

从需求分析到最终交付，完整的开发生命周期。

2 高级功能和命令

📦 Git 工作流命令

/commit

智能提交：自动暂存和生成提交信息

/rollback

安全回滚：带备份的版本回退

/cleanBranches

分支清理：清理已合并的分支

/worktree

工作树管理：多分支并行开发

🎯 项目管理命令

/init-project

项目初始化：生成CLAUDE.md说明文档

/bmad-init

BMad工作流：企业级敏捷开发流程

🎨 AI输出样式

/output-style

切换AI回复的个性化风格

可用样式：engineer-professional（专业工程师）、 nekomata-engineer（猫娘工程师）、laowang-engineer（老王暴躁流）

3 实际使用案例

💬 真实对话演示：AI如何理解你的需求

你

"我想做一个在线商城，需要商品展示、购物车、下单支付功能"

"我来帮你完整规划并实现这个在线商城项目！我会使用 /workflow 来系统化开发，包括：
📋 需求分析：商品管理、用户系统、订单处理
🎨 UI设计：现代化购物界面设计
⚡ 技术架构：前后端分离架构
💻 代码实现：React+Node.js全栈开发
✅ 测试优化：自动化测试和性能优化"

结果： 30分钟内完成完整的电商系统原型，包含所有核心功能！

💻 案例1：开发一个博客网站

步骤1：初始化项目

mkdir my-blog && cd my-blog

claude

/init-project

步骤2：开发核心功能

/feat 文章发布和展示功能

步骤3：完善和优化

添加评论系统和用户登录功能

🔌 案例2：构建RESTful API

完整工作流开发

/workflow 用户管理API系统

AI会引导你完成：需求分析 → 方案设计 → 详细规划 → 代码实现 → 质量优化 → 最终评审

🔧 案例3：代码重构和维护

直接对话式修改

这个函数性能不好，帮我优化一下

把这些重复代码提取成公共方法

添加错误处理和日志记录

4 最佳实践与技巧

💬 高效提问技巧

✓ 具体描述需求："实现用户注册功能，包含邮箱验证"

✓ 提供上下文："这是一个Vue.js项目，使用Element UI"

✓ 明确期望："需要响应式设计，兼容移动端"

✓ 追加需求："还要支持第三方登录，微信和QQ"

✗ 避免模糊："帮我做个网站" 太笼统

🏆 神级提问示例：

"帮我做一个类似小红书的社交应用，主要功能包括图文发布、关注点赞、评论互动，使用React Native开发，要适配iOS和Android，UI风格要简洁现代，类似Instagram"

📁 项目文件管理

📋 规划文档保存在 .claude/plan/ 目录

🙈 可将 .claude/ 添加到 .gitignore

📚 CLAUDE.md 是项目说明文档，建议保留

🔄 定期使用 /init-project 更新项目文档

⚡ 使用 /commit 自动生成规范的commit信息

🎯 专业提示：

Claude Code 会学习你的项目结构和代码风格，使用越多越智能！建议在同一个项目中持续使用，AI会记住你的偏好和规范。

⚡ Claude Code 开发原则

SOLID

单一职责、开闭原则

KISS

保持简单明了

DRY

避免重复代码

YAGNI

你不会需要它

🚀 开始你的AI编程之旅

现在你已经掌握了Claude Code的使用方法，从简单的代码修改到复杂的项目开发，AI都能帮你搞定！

🏆 效率提升

开发速度提升10倍

🎯 质量保证

代码规范专业

💡 学习成长

AI助你学新技术

💡 记住：熟能生巧！多尝试不同的命令和工作流，找到最适合你的开发模式。

🌟 Claude Code 不仅是工具，更是你的编程伙伴。让AI成为你创造力的放大器！

Codex 教程（mycodex 接入）

按照本页步骤完成安装、配置与使用，即可在本地优雅地使用 Codex CLI 进行代码编辑、分析、重构与提交信息生成。

快速开始

1 安装 Codex

选择您偏好的安装方式：

# 使用 npm 或 Homebrew 安装

npm install -g @openai/codex

# 或：brew install codex

2 配置文件设置（~/.codex/）

创建 ~/.codex/ 目录，并新增以下文件：

~/.codex/config.toml

model_provider = "mycodex"

model = "gpt-5"

model_reasoning_effort = "high"

disable_response_storage = true

[model_providers.mycodex]

name = "mycodex"

base_url = "https://api.wanai.de/v1"

wire_api = "responses"

env_key = "mycodex"

~/.codex/auth.json

{

"OPENAI_API_KEY": null

}

提示

Windows 路径：%USERPROFILE%\.codex\
需先创建 .codex 目录再放置配置文件

3 设置 API Key 并开始使用

在终端设置环境变量（API Key 可从仪表盘获取）：

export mycodex="your-api-key-here"

进入你的项目目录后运行：

codex

配置说明

1）config.toml 关键字段

model_provider = "mycodex"

model = "gpt-5"

model_reasoning_effort = "high"

disable_response_storage = true

[model_providers.mycodex]

name = "mycodex"

base_url = "https://api.wanai.de/v1"

wire_api = "responses"

env_key = "mycodex"

2）auth.json 示例

{

"OPENAI_API_KEY": "your-api-key-here"

}

你也可以只通过环境变量 mycodex 提供密钥。

环境变量设置

设置与启动

export mycodex="your-api-key-here"

codex

建议将环境变量写入 ~/.bashrc 或 ~/.zshrc 以永久保存。

配置文件位置

macOS/Linux：~/.codex/
Windows：%USERPROFILE%\\.codex\\
确保目录已创建，并包含 config.toml 与 auth.json

使用示例

查看帮助

codex help

编辑文件

codex edit src/components/Button.tsx

分析代码

codex analyze --files src/

生成提交信息

codex commit

代码重构

codex refactor --pattern observer src/stores/

🎯 开始使用 Codex 提升效率

结合本页的安装与配置，即可在项目中高效完成代码编辑、分析与重构工作流。