luna API - 客户端与 Agent 接入配置中心

Codex / Codex CLI 配置说明

config.toml

Codex 是基于 TOML 配置系统的智能编程 Agent。推荐使用自定义 Provider 方式接入，完全支持流式输出和长推理思考链。

方法一：编辑配置文件 ~/.codex/config.toml

model = "gemini-3.8-flash"
model_reasoning_effort = "low"
model_provider = "luna_api"

[model_providers.luna_api]
name = "luna API Gateway"
base_url = "https://api.lunaapi.top/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "sk-你的令牌Key"
supports_websockets = false

[model_providers.luna_api.http_headers]
Authorization = "Bearer sk-你的令牌Key"

方法二：或通过环境变量 / 认证文件 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-你的令牌Key",
  "auth_mode": "apikey"
}

💡 模型切换推荐：日常开发与代码补全推荐 gemini-3.8-flash（响应迅速，耗费极低）；复杂工程架构重构推荐 gemini-3.1-pro。

Claude Code 官方终端 CLI 接入

CLI Env

Anthropic 官方开源的终端命令行工具 claude 支持通过覆盖环境变量直接反代至第三方兼容网关。

Linux / macOS 终端启动：

# 设置反代端点与你的 luna API 令牌
export ANTHROPIC_BASE_URL="https://api.lunaapi.top"
export ANTHROPIC_API_KEY="sk-你的令牌Key"

# 启动 Claude Code
claude

Windows (PowerShell) 启动：

$env:ANTHROPIC_BASE_URL="https://api.lunaapi.top"
$env:ANTHROPIC_API_KEY="sk-你的令牌Key"
claude

📌 持久化环境变量：可将上述两行 export 语句追加到你的 ~/.bashrc 或 ~/.zshrc 中，后续每次打开终端即可直接输入 claude 运行。

代码 SDK (Python / Node.js) 接入

通过官方标准 OpenAI SDK 无缝调用：

Python 代码示例：

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lunaapi.top/v1",
    api_key="sk-你的令牌Key"
)

# 流式响应请求
response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[
        {"role": "system", "content": "你是一位优秀的编程助手。"},
        {"role": "user", "content": "请写一个快速排序算法。"}
    ],
    stream=True
)

for chunk in response:
    content = chunk.choices[0].delta.content or ""
    print(content, end="", flush=True)

📋 现行支持模型列表与定位

模型名称 (Model ID)	厂商定位 / 特色场景	流式状态
gemini-3.8-flash	极致响应速度、超强推理，编程辅助与日常 Agent 首选	✔ SSE 原生流式
gemini-3.7-flash	平衡响应速度与深度推理能力	✔ SSE 原生流式
gemini-3.1-pro	深度逻辑思考、超长上下文分析与复杂重构	✔ SSE 原生流式
gpt-5.6-luna	低价高并发高可用，完美适配代码补全与文本生成	✔ SSE 原生流式
gpt-5.6-terra	长上下文稳定版通用模型	✔ SSE 原生流式
gpt-6-luna	下一代通用体验版模型	✔ SSE 原生流式

API 快速接入与 Agent 框架配置指南

Codex / Codex CLI 配置说明

Claude Code 官方终端 CLI 接入

Cline / Roo Code (VS Code 热门插件) 配置

Cursor IDE 自定义模型配置

常用桌面 / 网页聊天客户端

代码 SDK (Python / Node.js) 接入

📋 现行支持模型列表与定位