> For the complete documentation index, see [llms.txt](https://docs.xxooapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xxooapi.com/xin-shou-ru-men-xxooapi.md).

# 新手入门 | xxooAPI

## 新手入门

如果你是第一次接触 Claude Code、Codex、终端 AI 工具，从这里开始。

## 新手入门：这些工具到底是什么

在开始配置之前，先花 3 分钟理清几个基本概念。如果你已经熟悉，直接跳到 [注册与充值](/zhu-ce-yu-chong-zhi.md)。

### 两家 AI 公司，两类产品

目前在 AI 编码工具领域最具代表性的两家公司是 **OpenAI** 和 **Anthropic**。它们各自有两类产品：

| 公司        | 网页聊天版（给普通人） | 终端工具（给开发者）      |
| --------- | ----------- | --------------- |
| OpenAI    | ChatGPT     | **Codex CLI**   |
| Anthropic | Claude（网页）  | **Claude Code** |

网页版只能聊天；**Claude Code 和 Codex 能直接在你的电脑里读写文件、执行命令、帮你完成工作**。它们不是“更强的聊天”，而是“长了手脚的助手”。

### 什么是终端

**终端**（Terminal）是电脑里一个专门用来输入命令的窗口，通常看起来像一个黑色方框，很多人叫它“黑框框”。Claude Code 和 Codex 都运行在终端里。

**如何打开终端**

* **Windows**：按 `Win` 键 → 输入 `Terminal` 或 `PowerShell` → 回车
* **macOS**：按 `Command + 空格` → 输入 `Terminal` → 回车
* **Linux**：桌面环境通常是 `Ctrl + Alt + T`

### 什么是 API

API 就是 **让软件程序去和 AI 大脑说话的通道**。

* 你在网页和 Claude 聊天 = 人直接对 AI 说话
* 软件（Claude Code、Cursor 等）通过 API 调用 AI = 软件替你对 AI 说话

所以 Claude Code 本质上是一个终端界面的客户端，它通过 API 把你的请求发给模型，再把结果返回到终端。

### 这些工具跑在哪儿

**你的电脑 + 云端 AI 模型**。你的电脑负责打开终端、显示结果；真正的理解和生成由云端模型完成。**所以使用时必须联网。**

### 为什么很多人用不起来

知道这些工具的人多，能稳定用起来的人少，常见卡点：

1. **需要科学上网**：官方 API 在国内直连不稳定
2. **官方订阅贵**：Claude Pro $20/月起，Max $200/月
3. **封号风险**：机房 IP 容易被风控，封了退款流程繁琐
4. **API 按量计费失控**：不熟悉的新手一天烧掉几十美金是常见的
5. **多工具配置重复**：Cursor、Codex、Claude Code 都要单独接一次

### xxooAPI 解决了什么

xxooAPI 把上面 5 件事一次性解决：

* **无需梯子**：国内直连
* **更便宜**：1 RMB = 1 USD 额度，按量付费永不过期，月卡 $50/天起
* **不会封号**：请求通过 xxooAPI 的企业账号池转发，风险在我们这边
* **一个 Key 通吃**：Claude Code / Codex / Cursor / VS Code 共享同一个密钥
* **透明计费**：每一次调用的输入/输出 Token 都在 [使用记录](https://xxooapi.com/console/log) 里看得到

### 谁适合用 xxooAPI

* 想体验 Claude Code、Codex，但不想折腾海外账号和代理
* Windows / macOS 用户想在本地终端跑 AI 编码工具
* 对成本敏感，或者想先小额试用
* 用多种 AI 工具（Cursor + Claude Code + Codex），不想每个都单独买

准备好了就继续下一步 → [注册与充值](/zhu-ce-yu-chong-zhi.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xxooapi.com/xin-shou-ru-men-xxooapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
