Claude Code 帮助文档

### 详细的安装和使用指南

### 快速开始
Claude Code 是一个强大的AI编程助手，支持多种编程语言和开发环境。以下是快速开始指南：

1. 会员要求
注册一个我们的会员：https://api.zhiyunai168.com/console/log

API KEY：创建一个key

![](/media/202508/2025-08-11_111829_1924580.9552555181239838.png)

网络：需要稳定的互联网连接

余额：确保账户跟key有足够的使用余额

2. 系统要求
Windows：Windows 10 或更高版本（需要管理员权限）
macOS：macOS 10.15 或更高版本（需要 root 权限）
Linux：支持主流发行版（Ubuntu、Debian、CentOS、Fedora等，需要 root 权限）
WSL：支持 Windows Subsystem for Linux
内存：建议至少 4GB RAM
3. 快速安装
Windows PowerShell（推荐）：
**需要以管理员身份运行 PowerShell**
![](/media/202508/2025-08-11_125537_3553390.6901782839977315.png)
```cpp
irm https://1.api5.ai/setup.ps1 | iex
```

![](/media/202508/2025-08-11_124954_8513600.9278408882879604.png)

Linux / macOS / WSL:
```cpp
curl -o install.sh https://1.api5.ai/install.sh && bash install.sh
```
**需要 root 权限执行安装脚本**

安装完成后的配置说明：
1. 重新打开一个新的终端窗口
2. 输入命令：claude
3. 在配置过程中，请一直按 回车键 使用默认设置
API KEY 使用说明
 请妥善保管您的 API KEY，不要分享给他人或在公开场合展示。

手动安装
1.2 安装步骤
使用npm进行全局安装：
```python
curl -o install.sh https://1.api5.ai/install.sh && bash install.sh
```
 重要: 不要使用 sudo npm install -g，这可能导致权限问题和安全风险。

安装完成后，导航到您的项目目录并启动Claude Code：
```cpp
cd your-awesome-project
claude
```
配置文件设置
您可以通过配置文件的方式设置 API KEY，这样无需每次手动输入。

创建或编辑配置文件：
```cpp
# 用户设置 (全局)
~/.claude/settings.json

# 项目设置 (项目级)
.claude/settings.json
```

配置文件示例：

```cpp
{
    "env": {
        "ANTHROPIC_API_KEY": "您的APIkey",
        "ANTHROPIC_BASE_URL": "https://https://api.zhiyunai168.com",
        
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
        "CLAUDE_MODEL": "Claude"
    },
    "permissions": {
        "allow": [],
        "deny": []
    }
}
```
 配置文件设置后，Claude Code 将自动读取配置，无需重复输入 API KEY。项目级设置优先于全局设置。

### 使用指南
#### 基本命令
claude - 启动 Claude Code 交互式会话
claude --help - 显示帮助信息
claude --version - 显示版本信息
/help - 在交互模式下显示帮助
/clear - 清除会话历史
/cost - 查看 Token 使用量和费用
/exit - 退出 Claude Code
### 首次使用
完成安装后，导航到您的项目目录
运行 claude 命令启动交互式会话
首次使用时，系统会提示您配置 API KEY
从 Claude Code 页面 复制您的 API KEY
按照提示完成配置，即可开始使用
### 日常使用
交互模式使用：

在项目根目录运行 claude
使用自然语言描述需求，如：
"帮我创建一个用户登录页面"
"修复这个函数中的 bug"
"优化这段代码的性能"
"为这个函数添加单元测试"
Claude Code 会分析您的代码库并提供解决方案
确认修改后，代码将自动应用到您的项目中
### 常用操作示例：

````cpp
# 启动 Claude Code
claude

# 示例对话
> 帮我创建一个 React 组件用于显示用户信息
> 修复 src/utils/api.js 中的错误处理
> 为 getUserData 函数添加类型定义
> 运行测试并修复失败的用例
````
### 核心功能
**智能代码编辑：**跨文件编辑和重构代码
**自动化测试：**运行测试并修复失败的用例
**Bug 修复：**智能检测并修复代码问题
**Git 集成：**自动创建提交和 Pull Request
**代码理解：**分析和解释复杂的代码结构
**多语言支持：**支持主流编程语言和框架
**项目初始化：**快速搭建项目结构
**代码审查：**提供代码质量建议和最佳实践
### 高级功能
**MCP 扩展：**通过模型上下文协议连接外部工具
**权限管理：**分层权限系统保护敏感操作
**安全防护：**内置提示注入攻击防护
**成本控制：**实时监控 Token 使用量和费用
**团队协作：**支持团队开发工作流程
 Claude Code 目前处于 Beta 阶段，会根据使用量产生费用。建议使用 /cost 命令定期查看使用情况。

### 余额和计费说明
计费方式
Claude Code 采用按使用量计费的方式：

根据实际使用的 Token 数量计费（包括输入、输出、缓存等）
每日提供一定额度的免费使用余额
不同复杂度的任务消耗不同的 Token 数量
可在 Claude Code 页面 实时查看余额和使用记录
### 余额管理
**今日余额：**每日重置，显示当前可用额度
**使用记录：**详细记录每次使用的 Token 消耗和费用
**历史查询：**可查看最近3天的使用历史
**余额不足：**当余额不足时，请联系管理员充值
### 节省成本技巧
明确描述需求，避免重复修改
对于简单任务，使用精简的描述
避免频繁的小修改，尽量一次性完成
合理利用缓存机制，避免重复计算
定期查看使用记录，了解消耗模式
### 常见问题
### Q: 安装失败怎么办？
A: 请检查：1) 是否有管理员/root权限；2) 网络连接是否正常；3) 防火墙是否阻止了下载；4) 确保使用的是官方安装脚本。如问题持续，请联系技术支持。
### Q: API KEY 无效怎么办？
A: 请确认：1) 会员是否已过期；2) API KEY 是否从 Claude Code 页面 正确复制；3) 是否有多余的空格或换行；4) 重新登录账户获取最新的 API KEY。
### Q: 会员过期了还能使用吗？
A: 会员过期后无法获取 API KEY，也无法使用 Claude Code 功能。请及时续费会员以继续使用服务。
### Q: 余额不足怎么办？
A: 当今日余额不足时，您可以等待第二天余额重置，或联系管理员申请增加额度。余额会每日自动重置。
### Q: 如何升级到最新版本？
A: 运行命令 claude-code update 即可自动升级到最新版本。建议定期更新以获得最佳体验。
### Q: 支持哪些项目类型？
A: Claude Code 支持几乎所有编程语言和项目类型，包括 Web 开发、移动应用、桌面程序、数据科学、机器学习等。支持 VS Code、IntelliJ IDEA、Vim 等主流编辑器。
### Q: 如何查看使用记录？
A: 登录后访问 Claude Code 页面，在页面底部可以查看最近3天的详细使用记录，包括 Token 消耗和费用明细。