快速开始

OKcode API 提供与 OpenAI / Claude 兼容的 API 接口，支持 Claude、GPT 和 Gemini 全系列模型，比官方 API 便宜 70%。

三步上手#

CLI 安装指南

每个安装项（如 Claude Code / Codex CLI）下面都可独立切换操作系统并查看对应命令。

模型安装目录#

Claude 模型安装#

适用模型：claude-opus-5、claude-sonnet-5 等。

复制npm install -g @anthropic-ai/claude-code
claude --version

复制npm install -g @anthropic-ai/claude-code
claude --version

复制npm install -g @anthropic-ai/claude-code
claude --version

复制$env:ANTHROPIC_BASE_URL="https://api.okcode.ai"
$env:ANTHROPIC_API_KEY="sk-你的密钥"
claude --model claude-opus-5

复制export ANTHROPIC_BASE_URL=https://api.okcode.ai
export ANTHROPIC_API_KEY=sk-你的密钥
claude --model claude-opus-5

复制export ANTHROPIC_BASE_URL=https://api.okcode.ai
export ANTHROPIC_API_KEY=sk-你的密钥
claude --model claude-opus-5

复制[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.okcode.ai","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-你的密钥","User")

复制echo 'export ANTHROPIC_BASE_URL=https://api.okcode.ai' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

复制echo 'export ANTHROPIC_BASE_URL=https://api.okcode.ai' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

复制winget install Microsoft.VisualStudioCode
code --install-extension saoudrizwan.claude-dev

复制brew install --cask visual-studio-code
code --install-extension saoudrizwan.claude-dev

复制sudo snap install code --classic
code --install-extension saoudrizwan.claude-dev

复制# 如果你的系统没有 snap（推荐 Ubuntu/Debian）
# 先从 VS Code 官网下载 .deb 安装包后执行：
sudo apt install ./code_*.deb
code --install-extension saoudrizwan.claude-dev

GPT 模型安装#

适用模型：gpt-5.6-sol、gpt-5.6-terra 等。

复制npm install -g @openai/codex
codex --version

复制# 推荐：在 WSL2 (Ubuntu) 中执行，Windows 原生支持仍属实验阶段
mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

export OPENAI_API_KEY=sk-你的密钥
codex --model gpt-5.6-sol

复制# 原生 PowerShell（实验支持，可能不稳定）
New-Item -ItemType Directory -Force -Path $HOME/.codex | Out-Null
@'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
'@ | Set-Content -Path $HOME/.codex/config.toml

$env:OPENAI_API_KEY="sk-你的密钥"
codex --model gpt-5.6-sol

复制mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

export OPENAI_API_KEY=sk-你的密钥
codex --model gpt-5.6-sol

复制mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

export OPENAI_API_KEY=sk-你的密钥
codex --model gpt-5.6-sol

复制setx OPENAI_BASE_URL "https://api.okcode.ai/v1"
setx OPENAI_API_KEY "sk-你的密钥"

复制echo 'export OPENAI_BASE_URL=https://api.okcode.ai/v1' >> ~/.zshrc
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

复制echo 'export OPENAI_BASE_URL=https://api.okcode.ai/v1' >> ~/.bashrc
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

Grok 模型安装#

适用模型：grok-4.5。

复制npm install -g @xai-official/grok
grok --version

复制# 二选一：官方安装脚本
curl -fsSL https://x.ai/cli/install.sh | bash

# 或者用 npm
npm install -g @xai-official/grok

grok --version

复制# 二选一：官方安装脚本
curl -fsSL https://x.ai/cli/install.sh | bash

# 或者用 npm
npm install -g @xai-official/grok

grok --version

复制New-Item -ItemType Directory -Force "$env:USERPROFILE\.grok" | Out-Null
@'
[model.grok-okcode]
model = "grok-4.5"
base_url = "https://api.okcode.ai/v1"
name = "Grok 4.5 (OKcode)"
env_key = "OKCODE_API_KEY"
api_backend = "chat_completions"

[models]
default = "grok-okcode"
'@ | Set-Content -Encoding utf8 "$env:USERPROFILE\.grok\config.toml"

$env:OKCODE_API_KEY="sk-你的密钥"
grok -m grok-okcode

复制mkdir -p ~/.grok
cat > ~/.grok/config.toml <<'EOF'
[model.grok-okcode]
model = "grok-4.5"
base_url = "https://api.okcode.ai/v1"
name = "Grok 4.5 (OKcode)"
env_key = "OKCODE_API_KEY"
api_backend = "chat_completions"

[models]
default = "grok-okcode"
EOF

export OKCODE_API_KEY=sk-你的密钥
grok -m grok-okcode

复制mkdir -p ~/.grok
cat > ~/.grok/config.toml <<'EOF'
[model.grok-okcode]
model = "grok-4.5"
base_url = "https://api.okcode.ai/v1"
name = "Grok 4.5 (OKcode)"
env_key = "OKCODE_API_KEY"
api_backend = "chat_completions"

[models]
default = "grok-okcode"
EOF

export OKCODE_API_KEY=sk-你的密钥
grok -m grok-okcode

复制npm install -g @anthropic-ai/claude-code
claude --version

复制npm install -g @anthropic-ai/claude-code
claude --version

复制npm install -g @anthropic-ai/claude-code
claude --version

复制$env:ANTHROPIC_BASE_URL="https://api.okcode.ai"
$env:ANTHROPIC_API_KEY="sk-你的密钥"
claude --model grok-4.5

复制export ANTHROPIC_BASE_URL=https://api.okcode.ai
export ANTHROPIC_API_KEY=sk-你的密钥
claude --model grok-4.5

复制export ANTHROPIC_BASE_URL=https://api.okcode.ai
export ANTHROPIC_API_KEY=sk-你的密钥
claude --model grok-4.5

复制npm install -g @openai/codex
codex --version

复制# 推荐：在 WSL2 (Ubuntu) 中执行，Windows 原生支持仍属实验阶段
mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

export OPENAI_API_KEY=sk-你的密钥
codex --model grok-4.5

复制mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

export OPENAI_API_KEY=sk-你的密钥
codex --model grok-4.5

复制mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "okcode"
network_access = "enabled"

[model_providers.okcode]
name = "okcode"
base_url = "https://api.okcode.ai/v1"
wire_api = "responses"
requires_openai_auth = true
EOF

export OPENAI_API_KEY=sk-你的密钥
codex --model grok-4.5

复制setx OPENAI_BASE_URL "https://api.okcode.ai/v1"
setx OPENAI_API_KEY "sk-你的密钥"

复制echo 'export OPENAI_BASE_URL=https://api.okcode.ai/v1' >> ~/.zshrc
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

复制echo 'export OPENAI_BASE_URL=https://api.okcode.ai/v1' >> ~/.bashrc
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

Gemini 模型安装#

适用模型：gemini-2.5-pro、gemini-2.5-flash 等。

复制npm install -g @google/gemini-cli
gemini --version

复制$env:GEMINI_API_KEY="sk-你的密钥"
$env:GEMINI_API_BASE_URL="https://api.okcode.ai/v1"
gemini --model gemini-2.5-pro

复制export GEMINI_API_KEY=sk-你的密钥
export GEMINI_API_BASE_URL=https://api.okcode.ai/v1
gemini --model gemini-2.5-pro

复制export GEMINI_API_KEY=sk-你的密钥
export GEMINI_API_BASE_URL=https://api.okcode.ai/v1
gemini --model gemini-2.5-pro

复制setx OPENAI_BASE_URL "https://api.okcode.ai/v1"
setx OPENAI_API_KEY "sk-你的密钥"

复制echo 'export OPENAI_BASE_URL=https://api.okcode.ai/v1' >> ~/.zshrc
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.zshrc
source ~/.zshrc

复制echo 'export OPENAI_BASE_URL=https://api.okcode.ai/v1' >> ~/.bashrc
echo 'export OPENAI_API_KEY=sk-你的密钥' >> ~/.bashrc
source ~/.bashrc

验证安装#

复制claude --version
codex --version
gemini --version

可用模型

支持 Claude、GPT、Grok 三大系列共 24 个模型，所有价格比官方 API 便宜 70%。

Claude 系列 (Anthropic)#

GPT 系列 (OpenAI)#

Grok 系列 (xAI)#

Gemini 系列 (Google)#

API 对接

接口信息#

Chat Completions (OpenAI 格式)#

复制curl https://api.okcode.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

Claude Messages 格式#

复制curl https://api.okcode.ai/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "你好"}]
  }'

支持的接口端点#

多模态输入（图片）#

复制curl https://api.okcode.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role":"user","content":[
      {"type":"text","text":"这张图片里有什么？"},
      {"type":"image_url","image_url":{"url":"https://example.com/image.jpg"}}
    ]}]
  }'

思考模式 (Thinking/Reasoning)#

复制curl https://api.okcode.ai/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 16000,
    "thinking": {"type": "enabled", "budget_tokens": 10000},
    "messages": [{"role": "user", "content": "证明根号2是无理数"}]
  }'

软件对接指南

以下是各类主流 AI 工具连接 OKcode API 的详细配置方法。所有工具只需两个信息：

AI 代码编辑器 / IDE#

Cursor

复制https://api.okcode.ai/v1

VS Code + Continue / Cline / Roo Code

复制Base URL: https://api.okcode.ai/v1
API Key: sk-你的密钥

桌面 / 移动客户端#

Cherry Studio

ChatBox / NextChat / BoltAI / OpenCat

配置 API Provider 选择 OpenAI API，填写：

网页端聊天工具#

均支持 OpenAI 兼容 API。填写 Base URL https://api.okcode.ai/v1 和你的 API Key 即可。

API 地址汇总#

代码示例

Python (OpenAI SDK)#

复制# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://api.okcode.ai/v1"
)
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
    stream=True
)
for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Python (Anthropic SDK)#

复制# pip install anthropic
import anthropic

client = anthropic.Anthropic(
    api_key="sk-你的密钥",
    base_url="https://api.okcode.ai"
)
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)
print(message.content[0].text)

Node.js (OpenAI SDK)#

复制// npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: 'sk-你的密钥',
    baseURL: 'https://api.okcode.ai/v1'
});
const response = await client.chat.completions.create({
    model: 'claude-sonnet-4-6',
    messages: [{ role: 'user', content: '你好' }],
    stream: true
});
for await (const chunk of response) {
    process.stdout.write(chunk.choices[0]?.delta?.content || '');
}

cURL#

复制curl https://api.okcode.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"你好"}]}'

Claude Code (命令行)#

复制export ANTHROPIC_BASE_URL=https://api.okcode.ai
export ANTHROPIC_API_KEY=sk-你的密钥
claude --model claude-opus-5

后台功能

登录 www.okcode.ai 后，您可以使用以下功能：

Playground (在线测试)#

• 选择模型、调整参数（temperature、max_tokens 等）
• 发送消息并查看实时流式回复
• 查看完整的请求/响应数据（Debug 面板）
• 支持图片附件（多模态测试）

API密钥管理 (API Key)#

• 创建令牌 — 生成新的 sk-xxxx 格式 API Key
• 额度控制 — 为每个令牌设置独立的使用额度上限
• 模型限制 — 限制令牌可以访问哪些模型
• 过期时间 — 设置令牌有效期，过期自动失效

数据看板#

• 请求次数统计
• Token 消耗趋势
• 各模型使用分布
• 额度余额概览

钱包管理#

• 充值 — 支持多种支付方式
• 兑换码 — 输入兑换码获取额度
• 邀请返利 — 分享邀请链接，好友注册后获得奖励额度

计费说明

Token 计费#

模型费率#

所有模型比官方 API 便宜 70%。以下为每百万 Token (1M) 的价格：

获取额度#

错误码说明

错误响应格式#

复制{ "error": { "message": "具体错误信息", "type": "error_type", "code": "error_code" } }

限流规则#

• 触发限流后返回 429 Too Many Requests
• 建议在代码中实现指数退避（exponential backoff）重试机制
• 具体限流阈值取决于您的账户等级和令牌配置

常见问题

Q: API 地址应该填什么？#

大多数客户端填 https://api.okcode.ai 即可。如果客户端要求带 /v1 后缀，则填 https://api.okcode.ai/v1。

Q: 支持流式输出吗？#

支持。请求时设置 "stream": true 即可。流式请求超时时间为 600 秒。

Q: 支持哪些 API 格式？#

同时支持 OpenAI Chat Completions 格式和 Claude Messages 格式，您可以用 OpenAI SDK 或 Anthropic SDK 对接。

Q: 请求报 401 错误？#

请检查 API Key 是否正确，格式为 sk-xxxx。OpenAI 格式用 Authorization: Bearer sk-xxxx，Claude 格式用 x-api-key: sk-xxxx。

Q: 请求报 429 限流？#

说明请求过于频繁。请降低请求频率，建议在代码中加入重试间隔。

Q: 请求超时怎么办？#

请将客户端超时设置为 300 秒以上。流式模式下建议设置 600 秒。

Q: 模型名称怎么填？#

直接填模型 ID，如 claude-sonnet-4-6。也可以通过 GET /v1/models 接口获取当前可用模型列表。

Q: 如何查看额度和用量？#

登录 www.okcode.ai 后台查看「数据看板」，或使用后台提供的用量 API 查询（以后台文档为准）。

Q: 支持发送图片吗？#

支持。Claude 模型支持多模态输入，可在 messages 中通过 image_url 类型发送图片（URL 或 Base64）。详见「API 对接」页面。