快速开始

四步即可开始使用 MoaCode：

1. 注册账号 — 前往 moacode.org/register 邮箱注册并完成验证
2. 获取 API Key — 登录后在 Dashboard 的 API configuration 区域复制主 Key（cr_ 开头）
3. 选择使用方式 — 智能对话 / CLI 编程智能体 / 直接调用 API
4. 发起第一个请求 — 按下文示例开始使用

充值

新账号需要先有余额才能发起请求：在 Plans 购买按量加油包或订阅套餐，也可以在 Dashboard 的 Redeem code 输入兑换码。详见充值与计费。

选择使用方式

方式	适合场景	入口
智能对话（AI Chat）	浏览器里直接聊天、生图、联网问答，零配置	moacode.org/chat
CLI 编程智能体	在终端 / IDE 用 Claude Code、Codex 写代码	Claude Code 接入 · Codex 接入
直接调 API	自己的程序、脚本或第三方客户端	本页下方示例与 API 协议总览

方式一：智能对话

登录后打开 AI Chat，选择渠道和模型即可开聊，无需任何配置。支持图像生成、联网搜索、附件上传。详见智能对话。

方式二：CLI 一键接入

在 Dashboard 的 Quick setup 区域可以直接复制适配你系统的一键命令。以 Claude Code 为例（Linux / macOS）：

curl -s https://moacode.org/setup-claude-code.sh | bash -s -- --url https://moacode.org --key 你的APIKey
# 完成后直接启动
claude

脚本会自动写入 ~/.claude/settings.json 并备份原有配置。Windows、手动配置及 IDE 集成见 Claude Code 接入指南；Codex CLI 见 Codex 接入指南。

方式三：直接调用 API

MoaCode 的 Base URL 统一为 https://moacode.org，支持三种协议：

协议	端点	兼容 SDK / 客户端
Anthropic Messages	https://moacode.org/v1/messages	Anthropic SDK、Claude Code
OpenAI Responses	https://moacode.org/v1/responses	OpenAI SDK（Responses）、Codex
OpenAI Chat Completions	https://moacode.org/v1/chat/completions	OpenAI SDK、WorkBuddy、Trae 等

Anthropic Messages 协议

Python

import anthropic

client = anthropic.Anthropic(
    base_url="https://moacode.org",
    api_key="你的APIKey",  # cr_ 开头
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(message.content[0].text)

TypeScript

import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  baseURL: 'https://moacode.org',
  apiKey: '你的APIKey', // cr_ 开头
})

const message = await client.messages.create({
  model: 'claude-sonnet-5',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '你好，介绍一下你自己' }],
})
console.log(message.content)

cURL

curl https://moacode.org/v1/messages \
  -H "x-api-key: 你的APIKey" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

OpenAI Chat Completions 协议

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://moacode.org/v1",
    api_key="你的APIKey",
)

completion = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
)
print(completion.choices[0].message.content)

TypeScript

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://moacode.org/v1',
  apiKey: '你的APIKey',
})

const completion = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: '你好，介绍一下你自己' }],
})
console.log(completion.choices[0].message.content)

cURL

curl https://moacode.org/v1/chat/completions \
  -H "Authorization: Bearer 你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}]
  }'

渠道与协议要对应

不同渠道服务不同协议（如 Openai Legacy 渠道对应 /v1/chat/completions，Codex 渠道对应 /v1/responses）。如果你创建了限定渠道的 Key，请确认调用的端点与渠道匹配，详见 API Key 管理。

验证 Key 与余额

用平台 API 快速确认 Key 可用：

curl https://moacode.org/api/v1/user/balance \
  -H "X-API-Key: 你的APIKey"
# => {"balance":10.35,...}

下一步

• 账户与余额 — 余额偏好、兑换码、推荐返利
• API Key 管理 — 按渠道 / 模型 / 余额类型创建专用 Key
• 团队协作 — 共享配额与成员管理
• 模型目录与价格 — 各渠道倍率与模型单价