# Claude Code

Cấu hình Claude Code để các lệnh gọi mô hình tương thích Anthropic đi qua Felo API Platform.

Dùng hướng dẫn này khi bạn muốn Claude Code sử dụng Felo API Platform thay vì gọi trực tiếp nhà cung cấp mô hình. Claude Code dùng endpoint Messages tương thích Anthropic.

**Không muốn cấu hình thủ công?** Hãy cài [CC Switch](https://ccswitch.io), một ứng dụng máy tính mã nguồn mở của bên thứ ba lưu cài đặt nhà cung cấp cho Claude Code và chuyển đổi giữa chúng chỉ với một cú nhấp. Thêm Felo làm nhà cung cấp, và bạn có thể chuyển giữa Felo API và gói đăng ký Claude mà không cần sửa biến môi trường. Lần chuyển đầu tiên trở lại gói đăng ký sẽ dùng luồng đăng nhập thông thường của Claude Code; các bước bên dưới hướng dẫn cách thêm Felo.

## Thiết lập CC Switch

Ví dụ bên dưới thêm Felo làm nhà cung cấp cho Claude Code. Các bước tương tự cũng đúng với bất kỳ nhà cung cấp tương thích Anthropic nào khác — chỉ endpoint, khóa và model ID thay đổi.

1. Trong CC Switch, chọn **Claude Code**, nhấp **Add provider**, rồi chọn **Custom Configuration**.

![Chọn Custom Configuration trong CC Switch](https://openapi.felo.ai/docs-assets/cc-switch/add-provider.png)

2. Nhập tên, dán khóa API Felo bạn đã tạo trong [trang API Keys của Felo API Platform](https://openapi.felo.ai/console/api-keys), và đặt **API Endpoint** thành `https://openapi.felo.ai/api`. URL website là tùy chọn.

![Nhập endpoint và khóa API Felo trong CC Switch](https://openapi.felo.ai/docs-assets/cc-switch/provider-form.png)

3. Mở **Advanced Options**. Đặt **Upstream Format** thành **Anthropic Messages (Native)** và giữ **Auth Field** ở `ANTHROPIC_AUTH_TOKEN (Default)`. Trong **Model Mapping**, ánh xạ **Sonnet** và **Opus** tới mô hình Felo bạn muốn dùng, chẳng hạn `gpt-6.1-sol`.

![Ánh xạ Sonnet và Opus tới một mô hình Felo trong CC Switch](https://openapi.felo.ai/docs-assets/cc-switch/model-mapping.png)

4. Nhấp **Add**, bật nhà cung cấp, rồi khởi chạy Claude Code. Nếu yêu cầu đầu tiên thành công, thiết lập đã hoàn tất.

Để chuyển lại gói đăng ký Claude, hãy chọn **Claude Official** trong CC Switch và làm theo luồng đăng nhập. Việc chuyển nhà cung cấp chỉ thay thế endpoint, khóa và ánh xạ mô hình — plugin, hook và cài đặt MCP của bạn được giữ nguyên.

## Thiết lập đề xuất

| Mục | Giá trị |
|------|-------|
| Phù hợp nhất với | chỉnh sửa kho lưu trữ, agent viết mã, nghiên cứu ngữ cảnh dài và phát triển ưu tiên terminal |
| Giao thức | Messages API tương thích Anthropic |
| Base URL | `https://openapi.felo.ai/api` |
| Ví dụ mô hình | `claude-sonnet-4-6` |
| Khóa API | `FELO_API_KEY` của bạn |

## Cấu hình Claude Code

Để cấu hình Claude Code thủ công, hãy tạo khóa trong [trang API Keys của Felo API Platform](https://openapi.felo.ai/console/api-keys) và đặt các biến môi trường. Cùng một khóa hoạt động trên các giao thức mô hình, máy khách agent, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page và các API SuperAgent.

```bash
export FELO_API_KEY="YOUR_API_KEY"
export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
```

### Tệp cài đặt tùy chọn

Dùng tệp cài đặt khi bạn muốn base URL và mô hình được áp dụng mỗi lần Claude Code khởi động. Giữ khóa API trong shell hoặc trình quản lý bí mật của bạn.

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}
```

Bạn cũng có thể chọn mô hình cho một phiên:

```bash
claude --model claude-sonnet-5
```

## Xác minh thiết lập

Chạy một tác vụ nhỏ sau khi lưu cấu hình:

```bash
claude
```

Nếu công cụ khởi động và trả lời bằng mô hình đã chọn, thiết lập nhà cung cấp đã sẵn sàng.

## Khắc phục sự cố

| Sự cố | Cần kiểm tra |
|-------|---------------|
| Xác thực thất bại | Xác nhận khóa được sao chép đúng và được xuất khẩu thành `FELO_API_KEY` |
| Công cụ gọi sai nhà cung cấp | Kiểm tra rằng nhà cung cấp Felo được chọn cho workspace hoặc phiên hiện tại |
| Lỗi base URL | Dùng `https://openapi.felo.ai/api/v1` cho máy khách tương thích OpenAI và `https://openapi.felo.ai/api` cho máy khách tương thích Anthropic |
| Không tìm thấy mô hình | Chọn một mô hình xuất hiện trong danh sách mô hình Felo của bạn |
| Công cụ bỏ qua cấu hình cục bộ | Chuyển cài đặt nhà cung cấp sang cấu hình cấp người dùng nếu máy khách yêu cầu |

## Các bước tiếp theo

- [Bắt đầu](https://openapi.felo.ai/vi/docs/getting-started.md)
- [Tham chiếu LLM API](https://openapi.felo.ai/vi/docs/guides/protocols.md)
- [Tham chiếu Chat API](https://openapi.felo.ai/vi/docs/api-reference/chat.md)
- [Tham chiếu SuperAgent API](https://openapi.felo.ai/vi/docs/api-reference/superagent.md)
