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 與網絡連通性基本正常。