String AI · 5 分钟上手指南

欢迎来到 String AI！这篇指南帮你用最短时间完成第一次对话，理解模型选择、余额查看和常见疑问。不写代码，不配工具，只看网页。

第一步：登录账号

1. 在浏览器中打开 String AI 网页入口。
2. 使用你的注册邮箱登录。如果还没注册，请联系管理员获取邀请链接或开通权限。
3. 登录成功后，页面右上角或侧边栏会显示你的账号信息（头像或邮箱）。看到它就说明登录成功了。

如果登录失败，请依次检查：

• 邮箱地址是否与注册时一致（注意大小写和空格）
• 垃圾邮件箱里是否有验证码或邀请邮件
• 浏览器是否开启了弹窗拦截（部分第三方登录会弹出新窗口）
• 公司网络或代理是否限制了登录页面
• 尝试用浏览器的无痕模式重新打开

第二步：完成第一次提问

登录后你会进入 Webchat 页面。在输入框里直接输入下面的文字，按下回车：

你是谁？用三句话介绍你可以帮我做什么。

然后你会看到 AI 开始逐字输出回复。

如果页面正常回复了，恭喜，你已经会用了。

这就跟你平时发微信一样 —— 打字、发送、看回复。接下来可以试试这些问题，感受一下 AI 能干什么：

一个小建议： 每次开始一个新任务时，点击「新建对话」按钮开一个新对话。如果把写邮件、翻译、总结全部塞在同一个对话里，AI 可能会把前面的内容混在一起，回答反而变乱。

第三步：选择模型

模型就像 AI 的「大脑」，不同模型有不同的特点和价格。你会在输入框上方或旁边看到一个模型选择器。

不知道怎么选？记住这条原则就行：先选默认模型，遇到问题再换。

一个简单的判断方法：

• 你想要质量高 → 选更强的模型
• 你想要速度快、省钱 → 选轻量模型
• 你不确定 → 选默认模型，永远不会错

随着使用次数多了，你会慢慢形成自己的偏好，不需要一开始就纠结。

第四步：查看余额和用量

在你开始大量使用之前，建议花一分钟搞清楚三件事：

1. 当前余额或剩余额度是多少 —— 这决定你还能用多久。一般在页面右上角头像附近，或「设置 / 账户」页面里。
2. 每次对话大概消耗多少 —— 可以在「消耗记录」页面看到每次调用的详细用量。短问答消耗较少，长文档、多轮深度对话消耗较多。
3. 是否按模型区分价格 —— 不同模型的单价不同，强模型通常更贵，轻量模型更便宜。

影响消耗的主要因素：

省钱小技巧：

• 新任务新对话：不要在一个对话里塞太多话题
• 长文档先让 AI 列出提纲，再分段深入
• 简单任务用轻量模型
• 隔几天看一眼消耗记录，心里有数

第五步：最常见的三个新手问题

Q1：模型太多了，我不知道选哪个

先用默认模型。 它适合 80% 的日常任务。只有当你发现「回复质量不够好」「要处理的东西太长」「成本太高了」的时候，再切到其他模型。不要在一开始就把所有模型都试一遍 —— 会累死。

Q2：余额和消耗到底怎么算的，为什么每次不一样

消耗跟你选的模型、输入内容长短、AI 回复长短、是否上传了文件、历史对话轮数都有关系。简单说：给 AI 喂的东西越多、让 AI 产出的越多、用的模型越强，消耗就越大。不需要盯着每次的数字看 —— 关注总余额和消耗趋势就够了。

Q3：我需要在电脑上装什么软件吗

完全不需要。 只要你能打开浏览器，就能用 Webchat。那些 VS Code、Codex、Cursor 之类的工具配置，是给开发者用的。如果你只是想在网页上提问、写作、翻译、总结，什么都不用装。

前置：安装 Node.js 运行环境

本页只给通过 npm 安装的工具使用，例如 OpenClaw。Claude Code 官方安装器不需要 Node.js。本站没有 Gemini CLI 接入页。Codex 是否需要 Node.js，以 Codex 安装脚本的检查为准。

Windows

方法一（推荐）：前往 Node.js 官网 下载 LTS 版本，双击安装。

方法二 / 三（包管理器）：

choco install nodejs-lts
# 或
scoop install nodejs-lts

macOS

brew install node
# 或前往官网下载 macOS 安装包

Linux

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# CentOS / RHEL
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs

验证安装

node --version
npm --version

输出版本号即表示安装成功。

开始前先确认：是否已经安装 Node.js？请执行 node --version 和 npm --version。若没有版本号，请先完成 安装 Node.js 运行环境。

Codex（CLI 与 VS Code 插件）

Codex CLI 和 VS Code Codex 插件共用配置文件 ~/.codex/config.toml。

可用模型：gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna。

方式一：一键脚本（推荐）

脚本会检查 Node.js 与 Codex CLI、提示输入 API Key，并把配置写入 ~/.codex。如已设置 STRING_AI_API_KEY 环境变量则优先使用，且不会读取本机已有的 OPENAI_API_KEY。

# Windows PowerShell
irm https://www.string.ink/install/codex.ps1 | iex

配置写入后 Codex CLI 与 App 客户端会同时生效；已打开的 CLI 需重启后才读取新配置。

方式二：手动创建配置

一键脚本不可用时，手动创建 config.toml 与 auth.json。

最简配置：

model_provider = "OpenAI"
model = "gpt-6-astra"

[model_providers.OpenAI]
base_url = "https://www.string.ink/v1"

完整手动安装（Windows PowerShell，含备份与 auth.json）：

$codexDir = "$env:USERPROFILE\.codex"
if (-not (Test-Path $codexDir)) { mkdir $codexDir | Out-Null }
if (Test-Path "$codexDir\config.toml") {
  Copy-Item "$codexDir\config.toml" "$codexDir\config.toml.bak.$(Get-Date -Format yyyyMMddHHmmss)"
}
if (Test-Path "$codexDir\auth.json") {
  Copy-Item "$codexDir\auth.json" "$codexDir\auth.json.bak.$(Get-Date -Format yyyyMMddHHmmss)"
}
@"
model_provider = "OpenAI"
model = "gpt-6-astra"
review_model = "gpt-6-astra"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://www.string.ink/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true
"@ | Out-File -FilePath "$codexDir\config.toml" -Encoding utf8

@"
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
"@ | Out-File -FilePath "$codexDir\auth.json" -Encoding utf8

配置完成后重启 Codex CLI 或 Codex App 客户端。

迁移 OAuth 旧会话（可选）

若之前用 Codex OAuth 登录，config.toml 改为 model_provider = "OpenAI" 后，旧会话可能暂时不显示，但不会被删除。公开安装没有迁移命令。需要找回旧会话时联系支持，不要自行改会话数据库。

验证配置

在 Codex / VS Code 中发起一个简单任务：

请阅读当前项目结构，并用中文总结这个项目可能是做什么的。不要修改文件。

若 Codex 正常回复且 String AI 后台出现对应消耗记录，说明配置成功。

生图 MCP（可选）

先设置环境变量 STRING_AI_API_KEY 为普通 sk- 密钥（不要使用 WebChat 或 Launcher 托管密钥），再在 ~/.codex/config.toml 中增加：

[mcp_servers.stringai_image]
url = "https://mcp.string.ink/mcp"
bearer_token_env_var = "STRING_AI_API_KEY"

不要把真实密钥写进 config.toml。保存后重启 Codex。可用工具：generate_image、get_image_task、list_image_models。计费复用现有套餐额度与 usage，不会另开计费路径。

开始前请确认你已经有可用的 String AI sk- 密钥。下面示例中的 YOUR_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

OpenCode 的安装

OpenCode 是开源编码 Agent，提供终端 CLI 和 Desktop 应用。请从官网下载页安装：https://opencode.ai/download。

当前下载页为 OpenCode v2。旧文档可能仍写 https://opencode.ai/install 和 npm 包名 opencode-ai，请改用下面的 v2 命令。

CLI

curl -fsSL https://opencode.ai/v2/install | bash

brew install anomalyco/tap/opencode-v2

npm install -g @opencode/cli

bun install -g --trust @opencode/cli

安装后打开新终端，运行 opencode。

Desktop

从 https://opencode.ai/download 下载：

• macOS（Apple Silicon / Intel）：.dmg
• Windows（x64）：NSIS 安装包
• Linux：.deb / .rpm

macOS 也可以执行：

brew install --cask opencode-desktop

OpenCode 的接入

CLI 与 Desktop 共用同一 String AI 接入地址。可用模型：gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna。

可以在 Desktop 设置里添加供应商，也可以直接写入 opencode.json，两种方式都可以。

Desktop 设置

1. 打开 OpenCode Desktop，进入 设置。
2. 打开 供应商 / Providers，点击 添加供应商。
3. 选择 OpenAI 或 OpenAI 兼容 / 自定义。
4. 填写：

1. 保存后，在模型列表中选择 gpt-6-astra（或其它 String AI 模型）。

如果界面只要求填写 API Key，请先按下方把 Base URL 写入 opencode.json，再回到设置里连接密钥。

CLI 在写好 Base URL 后，也可以用 /connect 填写密钥。

配置文件

CLI 与 Desktop 都读取 ~/.config/opencode/opencode.json（也可使用 opencode.jsonc）。

若文件不存在，请自行创建：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://www.string.ink/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "gpt-6-astra": { "name": "GPT-6 Astra" },
        "gpt-5.6-sol": { "name": "GPT-5.6 Sol" },
        "gpt-5.6-luna": { "name": "GPT-5.6 Luna" }
      }
    }
  },
  "model": "openai/gpt-6-astra"
}

这里可以不写 apiKey，改到 Desktop 设置或 /connect 里填写。

保存后重启已打开的 CLI 或 Desktop。若 String AI 后台出现对应消耗记录，说明接入成功。

开始前请确认你已经有可用的 String AI sk- 密钥。下面示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

ClaudeCode的安装

Claude Code 可以通过官方原生安装器、Homebrew、WinGet 或 npm 安装。安装完成后，在终端运行 claude --version 或 claude doctor 检查 CLI 是否可用。

Windows CLI

推荐使用官方原生安装器。PowerShell 与 CMD 的命令不同，请按当前终端选择一种。

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode

安装后打开新的终端执行：

claude --version
claude doctor

如果在 Windows 原生环境中使用 Claude Code，建议安装 Git for Windows；未安装时 Claude Code 会退回使用 PowerShell 执行 shell 工具。

MacOS CLI

macOS 可以使用官方原生安装器、Homebrew cask 或 npm 安装。

curl -fsSL https://claude.ai/install.sh | bash

brew install --cask claude-code
brew upgrade claude-code

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

npm install -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code@latest

安装后执行：

claude --version
claude doctor

ClaudeCode的接入

String AI 作为 Claude Code 的网关接入时，核心是设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。ANTHROPIC_BASE_URL 使用站点根地址，不需要追加 /v1。

CC Switch接入

如果你用 CC Switch 管理 Claude Code 环境变量，可以新建或切换到 Claude Code 配置，并填入以下变量：

注意： YOUR_STRING_AI_API_KEY 指你在 String AI 后台自己创建的 API Key。创建 API Key 时，分组一定要选择 claude api 组，否则 Claude Code 无法按 Claude API 通道接入。

保存后从 CC Switch 启动 Claude Code，或重启终端后运行：

claude

进入 Claude Code 后运行 /status，确认能看到 Anthropic base URL 指向 https://www.string.ink，并且凭据来源显示为 ANTHROPIC_AUTH_TOKEN。

如果只是临时测试，也可以直接在当前终端设置环境变量。

export ANTHROPIC_BASE_URL="https://www.string.ink"
export ANTHROPIC_AUTH_TOKEN="YOUR_STRING_AI_API_KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

set ANTHROPIC_BASE_URL=https://www.string.ink
set ANTHROPIC_AUTH_TOKEN=YOUR_STRING_AI_API_KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
set CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

$env:ANTHROPIC_BASE_URL = "https://www.string.ink"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_STRING_AI_API_KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER = "0"
claude

修改配置文件的方式

如果希望配置长期生效，建议写入用户级 Claude Code 设置文件：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.string.ink",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_STRING_AI_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

mkdir -p ~/.claude
cat > ~/.claude/settings.json <<'JSON'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.string.ink",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_STRING_AI_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
JSON

$claudeDir = Join-Path $env:USERPROFILE ".claude"
New-Item -ItemType Directory -Force -Path $claudeDir | Out-Null
@'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.string.ink",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_STRING_AI_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}
'@ | Set-Content -Path (Join-Path $claudeDir "settings.json") -Encoding UTF8

不要把真实密钥写入项目级 .claude/settings.json，因为它通常会被提交并分享给团队。若只想对当前项目本机生效，可以使用 .claude/settings.local.json，并确认它已被 .gitignore 忽略。

完成后重新打开终端，运行：

claude

在 Claude Code 里执行 /status，确认 Anthropic base URL 和 Auth token 来源正确。如果仍然走旧登录态，可以执行 /logout 后重新启动 Claude Code。

生图 MCP（可选）

String AI 提供远程生图 MCP，可在 Claude Code 里直接生成图片。它与上面的 Claude API 网关接入独立；使用后台创建的普通 sk- 密钥，不要使用 WebChat 或 Launcher 托管密钥。

claude mcp add --transport http stringai-image https://mcp.string.ink/mcp --header "Authorization: Bearer YOUR_STRING_AI_API_KEY"

添加后重启 Claude Code，执行 /mcp 确认 stringai-image 已连接。可用工具：generate_image、get_image_task、list_image_models。计费复用现有套餐额度与 usage，不会另开计费路径。

CC Switch

CC Switch 是跨平台桌面应用，可在一个界面里管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 等工具的供应商、路由、用量、会话与技能。

安装

brew install --cask cc-switch
brew upgrade --cask cc-switch

添加提供商

1. 打开 CC Switch，进入「通用提供商 / Universal Provider」标签页。
2. 点击「添加提供商」，填写：

• 名称：String AI
• Base URL：https://www.string.ink/v1
• API Key：你的 sk- 密钥
• 默认模型：gpt-6-astra

1. 点击「测试连接 / Health Check」，返回成功即配置完成。
2. 保存后，在 Codex 等 OpenAI 兼容工具中切换到该提供商。

不要把这个带 /v1 的通用供应商切给 Claude Code。Claude Code 的 ANTHROPIC_BASE_URL 是 https://www.string.ink，不要追加 /v1。请按 Claude Code 单独配置。

多数工具在切换供应商后需重启终端或对应 CLI 才会生效。切换后若 Codex 仍用旧配置，请关闭并重新打开终端、VS Code 或 Codex。

数据存储位置

开始前先确认：是否已经安装 Node.js？请执行 node --version 和 npm --version。若没有版本号，请先完成 安装 Node.js 运行环境。

OpenClaw

需要 Node.js 22.19+ 或 Node.js 24（推荐）。

安装

npm install -g openclaw@latest
npx openclaw --version

方式一：配置补丁（推荐）

创建配置文件 openclaw-stringai.json：

{
  "agents": {
    "defaults": {
      "model": { "primary": "stringai/gpt-6-astra" },
      "models": {
        "stringai/gpt-6-astra": { "alias": "String AI GPT-6 Astra" },
        "stringai/gpt-5.6-sol": { "alias": "String AI GPT-5.6 Sol" },
        "stringai/gpt-5.6-luna": { "alias": "String AI GPT-5.6 Luna" }
      }
    }
  },
  "models": {
    "providers": {
      "stringai": {
        "baseUrl": "https://www.string.ink/v1",
        "apiKey": "${STRING_AI_API_KEY}",
        "api": "openai-completions",
        "timeoutSeconds": 120,
        "models": [
          { "id": "gpt-6-astra", "name": "GPT-6 Astra", "contextWindow": 128000, "maxTokens": 16384 },
          { "id": "gpt-5.6-sol", "name": "GPT-5.6 Sol", "contextWindow": 128000, "maxTokens": 16384 },
          { "id": "gpt-5.6-luna", "name": "GPT-5.6 Luna", "contextWindow": 128000, "maxTokens": 16384 }
        ]
      }
    }
  }
}

设置环境变量并应用配置：

# Windows PowerShell
$env:STRING_AI_API_KEY = "YOUR_API_KEY"
npx openclaw config patch --file openclaw-stringai.json --replace-path "models.providers.stringai.models"

# macOS / Linux / WSL
export STRING_AI_API_KEY="YOUR_API_KEY"
npx openclaw config patch --file openclaw-stringai.json --replace-path "models.providers.stringai.models"

如已有旧模型配置，需用 --replace-path 替换；遇到 "Refusing to replace" 错误说明需添加此参数。成功时命令会提示重启 gateway。更新条数随现有配置变化，不要对照固定数字。

验证与使用

npx openclaw config validate      # Config valid: ~/.openclaw/openclaw.json
npx openclaw models status        # 显示 String AI 模型列表与部分隐藏的 API Key

# 本地模式运行
npx openclaw agent --local --session-id my-session --message "你好" --model stringai/gpt-6-astra
# 或启动 Gateway 后使用
npx openclaw onboard --install-daemon
npx openclaw agent --message "你好" --model stringai/gpt-6-astra

环境变量持久化

# Windows PowerShell（管理员）
[Environment]::SetEnvironmentVariable("STRING_AI_API_KEY", "YOUR_API_KEY", "User")

# macOS / Linux
echo 'export STRING_AI_API_KEY="YOUR_API_KEY"' >> ~/.bashrc
source ~/.bashrc

开始前请确认你已经有可用的 String AI sk- 密钥。示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

Hermes Agent 的安装

Hermes Agent 是终端编码 Agent。请使用官方安装脚本，不要使用第三方安装包。安装器会自行准备运行环境，不需要先安装 Node.js。

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

官网也提供桌面安装包。模型配置仍使用下面的 hermes model，不要在安装菜单里按固定序号选择。

Hermes Agent 的接入

Hermes 通过 OpenAI 兼容接口接入 String AI。可用模型：gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna。

接入信息

Base URL 填到 /v1，不要再追加 /chat/completions。模型名必须手填，并与平台一致。不要按菜单序号选择，序号会随版本变化。

配置步骤

1. 在新终端运行 hermes model。
2. 选择 Custom endpoint。菜单里可能写成 Custom endpoint (self-hosted / VLLM / etc.)，按名称选择，不要按固定序号查找。
3. 按上表填写 Base URL、API Key，并手填模型名 gpt-6-astra。若向导询问 API mode，选择 Chat Completions。
4. 保存后运行 hermes。

也可以直接写入配置文件，效果与 hermes model 相同：

model:
  provider: custom
  default: gpt-6-astra
  base_url: https://www.string.ink/v1
  api_key: YOUR_STRING_AI_API_KEY
  api_mode: chat_completions

不同账号可用模型可能不同，可用下面的接口核对：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_STRING_AI_API_KEY"

验证配置

在 Hermes 中发一条简单消息，例如「用一句话介绍你自己」。若正常回复，且 String AI 后台出现对应消耗记录，说明配置成功。

常见问题

更多排查见 故障排查速查。

开始前请确认你已经有可用的 String AI sk- 密钥。示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

Cursor 的安装

本页接入的是 Cursor 桌面版。请从官方下载页安装，不要使用第三方安装包。

打开 Cursor 官方下载页，按当前系统选择安装包：

安装完成后打开 Cursor，确认能进入编辑器主界面。官方下载页会随版本更新安装包，请始终从该页面获取最新版。

Cursor 另有终端 CLI（curl https://cursor.com/install -fsS | bash）。本指南覆盖桌面版的 Models / API Keys 接入；CLI 不在本页范围内。

Cursor 的接入

Cursor 通过 OpenAI 兼容接口接入 String AI。推荐模型为 gpt-6-astra。

接入信息

Base URL 填到 /v1，不要再追加 /chat/completions。

配置步骤

1. 打开 Cursor，点击左下角设置图标（齿轮），在左侧菜单打开 Models。
2. 展开 API Keys，在 OpenAI API Key 处填入你的 String AI API Key。
3. 打开 Override OpenAI Base URL，在下方输入框填入 https://www.string.ink/v1。
4. 在模型列表中选择或手动添加 gpt-6-astra。模型名必须与平台一致；不同账号可用模型可能不同，可用下面的接口核对：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_STRING_AI_API_KEY"

界面文案可能随 Cursor 版本变化，以 Models / API Keys 为准。

验证配置

在 Cursor 中发起一个简单任务：

请阅读当前项目结构，并用中文总结这个项目可能是做什么的。不要修改文件。

若 Cursor 正常回复，且 String AI 后台出现对应消耗记录，说明配置成功。

常见问题

更多排查见 故障排查速查。

开始前请确认你已经有可用的 String AI sk- 密钥。示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

WorkBuddy 的安装

本页接入的是 WorkBuddy 桌面客户端（也称 WorkBuddyCN）。请从官网安装，不要使用第三方安装包。

1. 打开 WorkBuddy 官网。
2. 按当前系统下载官方安装包并完成安装。
3. 安装后打开 WorkBuddy，确认能进入主界面。

Windows 安装后一般可通过开始菜单中的 WorkBuddy 打开；macOS 安装后一般在「应用程序」中打开 WorkBuddy。

若使用 String AI Launcher，也可在 Launcher 中安装并配置 WorkBuddyCN。Launcher 一键安装目前以 macOS 官方包为主；Windows 请仍从官网下载。配置前请完全退出 WorkBuddy，否则无法写入模型。

WorkBuddy 的接入

WorkBuddy 通过 OpenAI 兼容协议接入 String AI。

接入信息

接口地址填到 /v1，不要再追加 /chat/completions。模型名必须与平台一致。

配置步骤

1. 打开 WorkBuddy，在主页点击对话框的 [Auto] 按钮，进入「选择模型」页面，点击「自定义模型」。
2. 在「添加模型」窗口中（仅支持 OpenAI 兼容协议 API），点击「提供商」下拉框，在最底部「其他」分组下选择「自定义 / Custom」。
3. 按上表填写接入信息。

高级配置（可选）：按所选模型能力勾选「工具调用」（function calling）、「图片输入」（多模态视觉）、「思考模式」（推理/thinking）；「自定义协议」一般不勾选。输入/输出上下文长度可保持「使用提供商默认值」或按需选择。点击「保存」完成添加，返回主界面在模型选择器中即可选用。

不同账号可用模型可能不同，可用下面的接口核对：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_STRING_AI_API_KEY"

验证配置

在 WorkBuddy 中发一条简单消息，例如「用一句话介绍你自己」。若正常回复，且 String AI 后台出现对应消耗记录，说明配置成功。

常见问题

更多排查见 故障排查速查。

开始前请确认你已经有可用的 String AI sk- 密钥。示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

DeepSeek Harness 的安装

请从官网安装，不要使用第三方安装包。

1. 打开 DeepSeek Harness 官网。
2. 按当前系统下载官方桌面端并完成安装。官网当前提供 macOS（Apple 芯片）和 Windows（64 位）。
3. 安装后打开 DeepSeek Harness，确认能进入主界面。

也可以用官方命令启动 Web UI。需要已安装 Node.js。

若还没有 Node.js，请先完成 安装 Node.js 运行环境。

npx @deepseek-ai/dsh web

命令会打印访问地址，用浏览器打开即可。

DeepSeek Harness 的接入

DeepSeek Harness 通过自定义模型 API 接入 String AI。协议选官方列表中的 OpenAI Chat Completions。推荐模型：deepseek-v4.1-flash、gpt-6-astra。

不要选择 OpenAI Responses 或 Anthropic Messages。不要改内置 OpenAI 提供商的地址：内置提供商的模型列表来自已安装目录，看不到 String AI 实际提供的模型。

接入信息

Provider ID 必须小写，保存后不能改。要换 ID，请新建提供商并删除旧的。接口地址填到 /v1，不要再追加 /chat/completions。模型名必须与平台一致。

配置步骤

1. 打开 设置 → 模型。
2. 选择 添加模型提供商，把卡片切换到 自定义模型 API。
3. 按上表填写，至少添加一个模型。可以点 获取可用模型；失败或列表为空时，改为手动填写模型 ID，效果相同。
4. 保存。模型变更在下一次请求生效，不必重启。
5. 点击 Choose workspace / 选择工作区，选中要操作的项目目录。未选择工作区时不能发送。
6. 在模型选择器中选择刚添加的模型。

不同账号可用模型可能不同，可用下面的接口核对：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_STRING_AI_API_KEY"

验证配置

发一条简单消息，例如「用一句话介绍你自己」。若正常回复，且 String AI 后台出现对应消耗记录，说明配置成功。

常见问题

官方说明：使用 Web UI，配置模型。

更多排查见 故障排查速查。

开始前请确认你已经有可用的 String AI sk- 密钥。示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

ZCode 的安装

本页接入的是智谱 ZCode 桌面应用。请从官方安装页下载，不要使用第三方安装包。

1. 打开 ZCode 安装页。
2. 按当前系统下载官方安装包并完成安装。安装页提供 macOS（Apple Silicon / Intel）、Windows（x64 / ARM64）和 Linux（AppImage、DEB、RPM）。
3. 安装后打开 ZCode。首次启动点 开始使用 ZCode，再选择一个项目目录作为工作区。

Windows 从开始菜单或桌面快捷方式打开。macOS 将 ZCode.app 拖到「应用程序」后，从启动台打开。

ZCode 的接入

ZCode 通过自定义供应商接入兼容 OpenAI 协议的模型服务。这里填写 String AI，不要改走 BigModel 或 Z.ai 登录。

接入信息

接口地址填到 /v1，不要再追加 /chat/completions。不要填 https://www.string.ink（那是 Claude Code 的地址）。Anthropic 接口地址留空。模型名必须与平台一致。

配置步骤

1. 欢迎页选择 使用 API Key。已经进入主界面时，点击对话框里的模型名称，在列表底部点 管理模型，进入 设置 → 模型设置。
2. 在左侧供应商列表底部点击 添加供应商。
3. 名称填写 String AI。有单独的 OpenAI 接口地址时，只填 https://www.string.ink/v1。只有一个 API 基础 URL 时，同样手动填写这个地址。不要选用会指向 https://api.openai.com 的 OpenAI 官方预设。
4. 填入 API Key，保存。
5. 点击 添加模型，手动填写模型 ID，并打开启用开关。
6. 在模型选择器中选择刚添加的模型。

终端里已有的环境变量不会同步到 ZCode，需要在上面的界面单独填写。

不同账号可用模型可能不同，可用下面的接口核对：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_STRING_AI_API_KEY"

验证配置

发一条简单消息，例如「用一句话介绍你自己」。若正常回复，且 String AI 后台出现对应消耗记录，说明配置成功。

常见问题

官方说明：安装，连接模型。

更多排查见 故障排查速查。

开始前请确认你已经有可用的 String AI sk- 密钥。示例中的 YOUR_STRING_AI_API_KEY 请替换为你的个人密钥，不要把真实密钥提交到项目仓库或公开文档。

Dify 的安装

Dify 可以用官方云版，也可以自托管。本页只覆盖接入 String AI，不替代 Dify 官方部署文档。

方式一：Dify Cloud（推荐先验证接入）

1. 打开 Dify Cloud 并登录。
2. 进入工作区后，即可按下方步骤添加模型供应商。

方式二：自托管

需要本机或服务器已安装 Docker 与 Docker Compose。完整要求见 Dify 自托管文档。

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d

本地访问 http://localhost/install 完成管理员初始化，再打开 http://localhost 进入 Dify。

Dify 的接入

认准入口：「模型供应商」用来接入模型（本教程使用）；「API 扩展」用于挂载外部 HTTP 服务做内容审查等中间件回调，不是用来接模型的，请勿在此填写 String AI 地址。

接入信息

配置步骤

进入 Dify → 右上角头像 → 设置 → 模型供应商，搜索 OpenAI-API-compatible，点击「添加模型」，按上表填写。

Vision / Function calling / Stream 按模型实际能力开关，不确定先保持默认，最后点击「添加」。

不同账号可用模型可能不同，可用下面的接口核对：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_STRING_AI_API_KEY"

验证配置

1. 在模型供应商页面对刚添加的模型执行测试，或新建一个空白应用并选中该模型。
2. 发送一条简单消息，例如「用一句话介绍你自己」。
3. 若 Dify 正常回复，且 String AI 后台出现对应消耗记录，说明配置成功。

常见问题

更多排查见 故障排查速查。

One API

本页用 Go 编译并启动，不需要 Node.js。

启动 One API

git clone https://github.com/songquanpeng/one-api.git
cd one-api
go build -o one-api
./one-api

访问 http://localhost:3000，默认用户名/密码 admin / 123456。

添加渠道

进入「渠道」→「添加渠道」，选择 Proxy 类型：

然后在「模型」管理中为 gpt-6-astra、gpt-5.6-sol、gpt-5.6-luna 创建映射。

测试

API_KEY="sk-one-api-key"
curl http://localhost:3000/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-astra", "messages": [{"role": "user", "content": "Hello"}]}'

故障排查速查

本指南适用于 String AI API 付费用户。如仅使用网页聊天，无需 API Key，直接通过 Webchat 使用即可。

模型说明

String AI 提供对话、图像、转写和代码审查等不同能力模型。接入前建议先确认你的账号可用模型，再把模型 ID 填到脚本或第三方工具中。

对话模型

• gpt-6-astra：最新旗舰模型，推荐作为默认对话模型。
• gpt-5.6-sol：主力旗舰模型，适合稳定文本生成、问答和工具调用场景。
• gpt-5.6-luna：轻量快速版本，适合验证链路、低延迟脚本和成本敏感任务。

代码与自动化

• codex-auto-review：代码自动审查模型，适合接入代码审查流程。

图像能力

• gpt-image-1s：图像生成模型。
• gpt-image-1.5：图像生成模型。
• gpt-image-2：推荐图片生成与图片编辑模型。

语音转写

• gpt-4o-transcribe：语音转文本模型，适合音频转写场景。

查询可用模型

不同账号可能拥有不同模型权限。你可以通过模型列表接口确认当前 API Key 可访问的模型：

curl https://www.string.ink/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果接口返回 object: "list" 和 data 数组，说明 API Key、Base URL 与网络连通性基本正常。