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 之类的工具配置，是给开发者用的。如果你只是想在网页上提问、写作、翻译、总结，什么都不用装。

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 之類的工具設定，是給開發者用的。如果你只是想在網頁上提問、寫作、翻譯、總結，什么都不用裝。

String AI - 5 मिनट में शुरुआत मार्गदर्शिका

String AI में आपका स्वागत है। यह मार्गदर्शिका आपको पहली बातचीत पूरी करने, मॉडल चयन समझने, शेष राशि और उपयोग देखने, और नए उपयोगकर्ताओं के सबसे आम सवालों के जवाब पाने में मदद करती है। इसके लिए कोड लिखने या कोई टूल कॉन्फ़िगर करने की जरूरत नहीं है; बस वेब ऐप इस्तेमाल करें।

चरण 1: अपने खाते में लॉग इन करें

1. ब्राउज़र में String AI का वेब प्रवेश खोलें।
2. अपने पंजीकृत ईमेल पते से लॉग इन करें। अगर आपने अभी पंजीकरण नहीं किया है, तो आमंत्रण लिंक या प्रवेश अधिकार के लिए अपने व्यवस्थापक से संपर्क करें।
3. लॉगिन के बाद ऊपर दाएँ कोने या साइडबार में आपके खाते की जानकारी, अवतार या ईमेल दिखना चाहिए। अगर यह दिख रहा है, तो लॉगिन सफल है।

अगर लॉगिन असफल हो, तो ये बातें जांचें:

• ईमेल पता पंजीकरण में इस्तेमाल हुए ईमेल से मेल खाता है या नहीं, खाली जगहों और अक्षरों के आकार सहित
• सत्यापन कोड या आमंत्रण ईमेल स्पैम फ़ोल्डर में तो नहीं गया
• ब्राउज़र पॉप-अप रोक तो नहीं रहा, क्योंकि कुछ तृतीय-पक्ष लॉगिन प्रक्रियाएँ नई विंडो खोलती हैं
• कंपनी का नेटवर्क या प्रॉक्सी लॉगिन पेज को रोक तो नहीं रहा
• गुप्त ब्राउज़र विंडो में लॉगिन काम करता है या नहीं

चरण 2: अपना पहला प्रश्न पूछें

लॉगिन के बाद आप Webchat पेज पर पहुँचेंगे। इनपुट बॉक्स में यह संदेश लिखें और Enter दबाएँ:

आप कौन हैं? तीन वाक्यों में बताइए कि आप मेरी किस तरह मदद कर सकते हैं।

आपको AI का उत्तर धीरे-धीरे दिखाई देना शुरू होना चाहिए।

अगर पेज सामान्य रूप से उत्तर देता है, तो बधाई हो। अब आप String AI इस्तेमाल करने के लिए तैयार हैं।

यह सामान्य चैट ऐप की तरह काम करता है: लिखें, भेजें, और उत्तर पढ़ें। AI क्या कर सकता है, यह समझने के लिए ये उदाहरण आजमाएँ:

छोटी सलाह: हर नए काम के लिए नई बातचीत शुरू करें। अगर ईमेल लिखना, अनुवाद और सारांश एक ही लंबी बातचीत में मिला दिए जाएँ, तो AI पुराने संदर्भ को बाद के उत्तरों में मिला सकता है।

चरण 3: मॉडल चुनें

मॉडल AI का "मस्तिष्क" है। अलग-अलग मॉडल की क्षमताएँ और कीमतें अलग होती हैं। इनपुट बॉक्स के पास आपको मॉडल चयनकर्ता दिखेगा।

समझ न आए कि कौन सा मॉडल चुनें? डिफ़ॉल्ट मॉडल से शुरू करें और जरूरत पड़ने पर ही बदलें।

एक सरल नियम:

• अधिक गुणवत्ता चाहिए -> अधिक शक्तिशाली मॉडल चुनें
• तेज़ और सस्ता उत्तर चाहिए -> हल्का मॉडल चुनें
• निश्चित नहीं हैं -> डिफ़ॉल्ट मॉडल इस्तेमाल करें

String AI कुछ समय इस्तेमाल करने के बाद आपको स्वाभाविक रूप से समझ आने लगेगा कि कौन से मॉडल आपके काम के लिए उपयुक्त हैं।

चरण 4: शेष राशि और उपयोग देखें

अधिक उपयोग शुरू करने से पहले एक मिनट निकालकर ये तीन बातें समझ लें:

1. आपकी मौजूदा शेष राशि या बची हुई सीमा - इससे तय होता है कि आप सेवा कितनी देर तक इस्तेमाल कर सकते हैं। यह आम तौर पर अवतार के पास या Settings / Account में मिलती है।
2. हर बातचीत की लागत - उपयोग इतिहास पेज हर अनुरोध की विस्तृत खपत दिखाता है। छोटे प्रश्नोत्तर की लागत कम होती है; लंबे दस्तावेज़ और बहु-चरणीय तर्क अधिक खर्च करते हैं।
3. क्या कीमत मॉडल के अनुसार बदलती है - अधिक शक्तिशाली मॉडल आम तौर पर महंगे होते हैं, जबकि हल्के मॉडल सस्ते होते हैं।

उपयोग को प्रभावित करने वाले मुख्य कारण:

लागत बचाने के उपाय:

• नए काम के लिए नई बातचीत शुरू करें
• पहले रूपरेखा माँगें, फिर हर भाग पर अलग-अलग विस्तार करें
• सरल कामों के लिए हल्के मॉडल इस्तेमाल करें
• हर कुछ दिनों में उपयोग रिकॉर्ड देखें ताकि खर्च का रुझान समझ में रहे

चरण 5: नए उपयोगकर्ताओं के तीन आम सवाल

Q1: मॉडल बहुत अधिक हैं। मुझे कौन सा चुनना चाहिए?

पहले डिफ़ॉल्ट मॉडल इस्तेमाल करें। यह ज्यादातर रोज़मर्रा के कामों के लिए पर्याप्त है। उत्तर की गुणवत्ता कम लगे, सामग्री बहुत लंबी हो, या लागत बहुत अधिक हो तभी मॉडल बदलें। शुरुआत में हर मॉडल आजमाने की जरूरत नहीं है।

Q2: शेष राशि और उपयोग की गणना कैसे होती है? हर अनुरोध अलग क्यों होता है?

उपयोग मॉडल, इनपुट की लंबाई, आउटपुट की लंबाई, फ़ाइल अपलोड और बातचीत के इतिहास पर निर्भर करता है। संक्षेप में: आप AI को जितनी अधिक सामग्री देंगे, उससे जितना अधिक उत्तर बनवाएँगे, और मॉडल जितना अधिक शक्तिशाली होगा, लागत उतनी अधिक होगी। हर संख्या पर नज़र रखने की जरूरत नहीं है। कुल शेष राशि और उपयोग के रुझान पर ध्यान दें।

Q3: क्या मुझे अपने कंप्यूटर पर कुछ install करना होगा?

नहीं। अगर आप ब्राउज़र खोल सकते हैं, तो Webchat इस्तेमाल कर सकते हैं। VS Code, Codex और Cursor जैसे टूल डेवलपरों के लिए हैं। अगर आप वेब पर सिर्फ प्रश्न पूछना, लिखना, अनुवाद करना या सारांश बनाना चाहते हैं, तो कुछ install करने की जरूरत नहीं है।

String AI - 5-Minute Getting Started Guide

Welcome to String AI. This guide helps you complete your first conversation, understand model selection, check balance and usage, and answer the most common beginner questions. No code, no tool configuration, just the web app.

Step 1: Log in to your account

1. Open the String AI web entry in your browser.
2. Log in with your registered email address. If you have not registered yet, contact your administrator for an invitation link or access.
3. After login, your account information, avatar, or email should appear in the top-right corner or sidebar. If you can see it, login succeeded.

If login fails, check the following:

• Whether the email address matches the one used during registration, including spaces and casing
• Whether the verification code or invitation email is in spam
• Whether your browser blocks pop-ups, because some third-party login flows open a new window
• Whether your company network or proxy restricts the login page
• Whether an incognito browser window works

Step 2: Ask your first question

After login, you will enter the Webchat page. Type the following message into the input box and press Enter:

Who are you? In three sentences, explain what you can help me do.

You should see the AI start streaming a response.

If the page replies normally, congratulations. You are ready to use String AI.

It works like a normal chat app: type, send, and read the reply. Try these examples to get a feel for what AI can do:

Small tip: Start a new conversation for each new task. If you mix email writing, translation, and summarization in one long conversation, the AI may blend earlier context into later answers.

Step 3: Choose a model

A model is the AI "brain". Different models have different capabilities and prices. You will see a model selector near the input box.

Not sure which one to choose? Start with the default model and switch only when needed.

A simple rule:

• Want higher quality -> choose a stronger model
• Want faster and cheaper output -> choose a lightweight model
• Not sure -> use the default model

After using String AI for a while, you will naturally learn which models fit your own workflow.

Step 4: Check balance and usage

Before heavy usage, spend one minute understanding three things:

1. Your current balance or remaining quota - this determines how long you can continue using the service. It is usually near your avatar or under Settings / Account.
2. How much each conversation costs - the usage history page shows detailed consumption for each request. Short Q&A costs less; long documents and multi-turn reasoning cost more.
3. Whether pricing differs by model - stronger models are usually more expensive, while lightweight models are cheaper.

Main factors that affect usage:

Cost-saving tips:

• Start a new conversation for a new task
• Ask for an outline first, then go deeper section by section
• Use lightweight models for simple tasks
• Check usage records every few days so you know the trend

Step 5: Three common beginner questions

Q1: There are too many models. Which one should I choose?

Use the default model first. It works for most daily tasks. Switch only when response quality is not enough, the material is too long, or cost becomes too high. Do not try every model at the beginning.

Q2: How are balance and usage calculated? Why is every request different?

Usage depends on the model, input length, output length, file uploads, and conversation history. In short: the more you give the AI, the more you ask it to generate, and the stronger the model, the more it costs. You do not need to watch every single number. Focus on total balance and usage trend.

Q3: Do I need to install anything on my computer?

No. If you can open a browser, you can use Webchat. Tools such as VS Code, Codex, and Cursor are for developers. If you only want to ask questions, write, translate, or summarize on the web, you do not need to install anything.

前置：安装 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 運行環境

本頁只給通過 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 रनटाइम इंस्टाल करें

यह पेज सिर्फ npm से इंस्टाल होने वाले टूल के लिए है, जैसे OpenClaw। Claude Code का आधिकारिक इंस्टॉलर Node.js नहीं माँगता। इस साइट पर Gemini CLI गाइड नहीं है। Codex के लिए Codex इंस्टॉल स्क्रिप्ट की जाँच मानें।

Windows

पहला विकल्प, अनुशंसित: Node.js वेबसाइट पर जाएँ और LTS संस्करण इंस्टाल करें।

दूसरा और तीसरा विकल्प, पैकेज मैनेजर के साथ:

choco install nodejs-lts
# or
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 और npm तैयार हैं।

Prerequisite: Install the Node.js Runtime

Use this page only for tools installed through npm, such as OpenClaw. The official Claude Code installer does not need Node.js. This site has no Gemini CLI guide. For Codex, follow the check in the Codex install script.

Windows

Option one, recommended: go to the Node.js website and install the LTS version.

Options two and three, using package managers:

choco install nodejs-lts
# or
scoop install nodejs-lts

macOS

brew install node
# or download the macOS installer from the official website

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

Verify Installation

node --version
npm --version

If both commands print version numbers, Node.js and npm are ready.

开始前先确认：是否已经安装 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，不会另开计费路径。

開始前先確認：是否已經安裝 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，不會另開計費路徑。

शुरू करने से पहले: क्या आपने Node.js स्थापित कर लिया है? node --version और npm --version चलाएँ। अगर version numbers नहीं दिखते, तो पहले Node.js runtime स्थापित करें पूरा करें।

Codex (CLI और VS Code एक्सटेंशन)

Codex CLI और VS Code Codex एक्सटेंशन एक ही कॉन्फ़िगरेशन फ़ाइल इस्तेमाल करते हैं: ~/.codex/config.toml।

उपलब्ध मॉडल: gpt-6-astra, gpt-5.6-sol, gpt-5.6-luna।

विकल्प 1: एक-पंक्ति स्क्रिप्ट (अनुशंसित)

यह स्क्रिप्ट 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 और ऐप क्लाइंट दोनों इसका उपयोग करेंगे। नई कॉन्फ़िगरेशन लोड कराने के लिए खुले हुए CLI, VS Code या Codex क्लाइंट को दोबारा शुरू करें।

विकल्प 2: मैनुअल कॉन्फ़िगरेशन

अगर एक-पंक्ति स्क्रिप्ट उपलब्ध नहीं है, तो 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 ऐप क्लाइंट को दोबारा शुरू करें।

पुराने OAuth सत्र को माइग्रेट करें (वैकल्पिक)

अगर आपने पहले Codex में OAuth से login किया था, तो config.toml में model_provider = "OpenAI" सेट करने के बाद पुराने सत्र कुछ समय के लिए गायब लग सकते हैं। वे हटते नहीं। सार्वजनिक इंस्टॉल में माइग्रेशन कमांड नहीं है। पुराने सत्र वापस चाहिए तो सहायता से संपर्क करें, और सत्र डेटाबेस खुद न बदलें।

कॉन्फ़िगरेशन सत्यापित करें

Codex या VS Code में यह सरल कार्य चलाएँ:

Read the current project structure and summarize what this project may do. Do not modify files.

अगर Codex सामान्य रूप से उत्तर देता है और String AI कंसोल में संबंधित उपयोग रिकॉर्ड दिखता है, तो कॉन्फ़िगरेशन काम कर रही है।

इमेज MCP (वैकल्पिक)

पहले STRING_AI_API_KEY को सामान्य sk- key पर सेट करें (WebChat या Launcher managed keys स्वीकार नहीं किए जाते), फिर ~/.codex/config.toml में यह जोड़ें:

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

असली key को config.toml में न लिखें। सेव करने के बाद Codex रीस्टार्ट करें। उपलब्ध टूल: generate_image, get_image_task, list_image_models। बिलिंग मौजूदा प्लान कोटा और usage से होती है; कोई अलग बिलिंग पथ नहीं है।

Before you start: have you installed Node.js? Run node --version and npm --version. If they do not print version numbers, finish Install the Node.js Runtime first.

Codex (CLI and VS Code Extension)

Codex CLI and the VS Code Codex extension share the same configuration file: ~/.codex/config.toml.

Available models: gpt-6-astra, gpt-5.6-sol, gpt-5.6-luna.

Option 1: One-Line Script (Recommended)

The script checks Node.js and Codex CLI, asks for your API Key, and writes the configuration to ~/.codex. If STRING_AI_API_KEY is already set, it uses that value first and does not read an existing OPENAI_API_KEY.

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

After writing the configuration, Codex CLI and the app client will both use it. Restart any open CLI, VS Code, or Codex client so the new configuration is loaded.

Option 2: Manual Configuration

If the one-line script is unavailable, create config.toml and auth.json manually.

Minimal configuration:

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

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

Full manual setup for Windows PowerShell, including backups and 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

After configuration, restart Codex CLI or the Codex app client.

Migrate an Old OAuth Session (Optional)

If you previously logged in to Codex with OAuth, old sessions may temporarily disappear after config.toml is set to model_provider = "OpenAI". They are not deleted. The public install has no migration command. Contact support if you need the old sessions back, and do not edit the session database yourself.

Verify Configuration

Start a simple task in Codex or VS Code:

Read the current project structure and summarize what this project may do. Do not modify files.

If Codex replies normally and the String AI console shows the corresponding usage record, the configuration is working.

Image MCP (optional)

Set STRING_AI_API_KEY to an ordinary sk- key (WebChat and Launcher-managed keys are rejected), then add this to ~/.codex/config.toml:

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

Do not put a real key in config.toml. Restart Codex after saving. Tools: generate_image, get_image_task, list_image_models. Billing reuses the existing plan quota and usage path.

开始前请确认你已经有可用的 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_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- key है। नीचे दिए examples में YOUR_API_KEY को अपनी key से बदलें, और real key को repository या public document में कभी commit न करें।

OpenCode स्थापना

OpenCode एक open-source coding agent है, जिसमें terminal 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

स्थापना के बाद नया terminal खोलें और 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 endpoint इस्तेमाल करते हैं। उपलब्ध मॉडल: gpt-6-astra, gpt-5.6-sol, gpt-5.6-luna।

आप Desktop Settings में provider जोड़ सकते हैं, या opencode.json लिख सकते हैं। दोनों तरीके काम करते हैं।

Desktop Settings

1. OpenCode Desktop खोलें और Settings पर जाएँ।
2. Providers खोलें और Add Provider पर क्लिक करें।
3. OpenAI या OpenAI-compatible / Custom चुनें।
4. ये भरें:

1. सेव करें, फिर मॉडल सूची में gpt-6-astra (या कोई अन्य String AI मॉडल) चुनें।

अगर फ़ॉर्म केवल API Key माँगता है, तो पहले नीचे दिखाए अनुसार Base URL को opencode.json में लिखें, फिर Settings में key कनेक्ट करें।

Base URL सेट होने के बाद CLI /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 Settings या /connect में भरें।

सेव करने के बाद खुली हुई CLI या Desktop विंडो को दोबारा शुरू करें। अगर String AI कंसोल में संबंधित उपयोग रिकॉर्ड दिखता है, तो कनेक्शन काम कर रहा है।

Before you start, make sure you have a usable String AI sk- key. Replace YOUR_API_KEY with your own key in the examples below, and never commit a real key to a repository or public document.

OpenCode Installation

OpenCode is an open-source coding agent with a terminal CLI and a Desktop app. Install it from the official download page: https://opencode.ai/download.

The current page is OpenCode v2. Older docs may still show https://opencode.ai/install and the npm package opencode-ai; use the v2 commands below.

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

After installing, open a new terminal and run opencode.

Desktop

Download from https://opencode.ai/download:

• macOS (Apple Silicon / Intel): .dmg
• Windows (x64): NSIS installer
• Linux: .deb / .rpm

On macOS you can also run:

brew install --cask opencode-desktop

OpenCode Connection

CLI and Desktop share the same String AI endpoint. Available models: gpt-6-astra, gpt-5.6-sol, gpt-5.6-luna.

You can add the provider in Desktop Settings, or write opencode.json. Either way works.

Desktop Settings

1. Open OpenCode Desktop and go to Settings.
2. Open Providers and click Add Provider.
3. Choose OpenAI or OpenAI-compatible / Custom.
4. Fill in:

1. Save, then pick gpt-6-astra (or another String AI model) in the model list.

If the form only asks for an API Key, add the Base URL in opencode.json as shown below, then come back and connect the key in Settings.

CLI can use /connect after the Base URL is set.

Config file

CLI and Desktop both read ~/.config/opencode/opencode.json (or opencode.jsonc).

Create the file if it does not exist:

{
  "$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"
}

You can omit apiKey here and enter it later in Desktop Settings or with /connect.

Restart any open CLI or Desktop window after saving. If String AI console shows the matching usage, the connection is working.

开始前请确认你已经有可用的 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，不会另开计费路径。

開始前請確認你已經有可用的 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，不會另開計費路徑。

शुरू करने से पहले, सुनिश्चित करें कि आपके पास उपयोग योग्य String AI sk- key है। नीचे दिए examples में YOUR_STRING_AI_API_KEY को अपनी key से बदलें, और real key को repository या public document में कभी commit न करें।

ClaudeCode स्थापना

Claude Code को आधिकारिक मूल इंस्टालर, Homebrew, WinGet या npm से स्थापित किया जा सकता है। स्थापना के बाद CLI की जाँच करने के लिए claude --version या claude doctor चलाएँ।

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

फिर नया terminal खोलें और चलाएँ:

claude --version
claude doctor

Native Windows उपयोग के लिए Git for Windows अनुशंसित है। इसके बिना Claude Code शेल टूल के लिए PowerShell पर वापस आ जाता है।

macOS CLI

macOS पर native installer, 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 कनेक्शन

अगर आप Claude Code को CC Switch से प्रबंधित करते हैं, तो 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

वास्तविक प्रमाण-पत्र को project-level .claude/settings.json में न डालें, क्योंकि यह file आम तौर पर कमिट होकर टीम के साथ साझा होती है। अगर configuration केवल एक local project पर लागू करनी है, तो .claude/settings.local.json इस्तेमाल करें और सुनिश्चित करें कि वह git अनदेखा है।

टर्मिनल को दोबारा शुरू करें और चलाएँ:

claude

Claude Code के अंदर /status चलाकर base URL और प्रमाण-पत्र स्रोत की पुष्टि करें। अगर Claude Code अभी भी पुराना login इस्तेमाल करता है, तो /logout चलाएँ और फिर दोबारा शुरू करें।

इमेज MCP (वैकल्पिक)

String AI एक remote image MCP देता है, जिससे Claude Code में सीधे इमेज जनरेट की जा सकती है। यह ऊपर दिए Claude API गेटवे से स्वतंत्र है। कंसोल में बनाया गया सामान्य sk- key इस्तेमाल करें; WebChat या Launcher managed keys स्वीकार नहीं किए जाते।

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 से होती है; कोई अलग बिलिंग पथ नहीं है।

Before you start, make sure you have a usable String AI sk- key. Replace YOUR_STRING_AI_API_KEY with your own key in the examples below, and never commit a real key to a repository or public document.

ClaudeCode Installation

Claude Code can be installed with the official native installer, Homebrew, WinGet, or npm. After installation, run claude --version or claude doctor to verify the CLI.

Windows CLI

Use the official native installer. PowerShell and CMD use different commands.

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

Then open a new terminal and run:

claude --version
claude doctor

Git for Windows is recommended for native Windows use. Without it, Claude Code falls back to PowerShell for shell tools.

MacOS CLI

On macOS, install with the native installer, Homebrew cask, or 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

Verify the install:

claude --version
claude doctor

ClaudeCode Connection

When using String AI as the Claude Code gateway, configure ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN. Use the site root for ANTHROPIC_BASE_URL; do not append /v1.

CC Switch Connection

If you manage Claude Code through CC Switch, create or switch to a Claude Code profile and set these environment variables:

Note: YOUR_STRING_AI_API_KEY means the API Key you create yourself in the String AI console. When creating the API Key, make sure to select the claude api group, otherwise Claude Code cannot connect through the Claude API channel.

Save the profile, then start Claude Code from CC Switch or restart your terminal and run:

claude

Inside Claude Code, run /status and confirm Anthropic base URL points to https://www.string.ink and the credential source is ANTHROPIC_AUTH_TOKEN.

For a quick temporary test, set the variables in the current terminal session:

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

Configuration File Method

For a persistent setup, write the variables to the user-level Claude Code settings file:

{
  "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

Do not put real credentials in project-level .claude/settings.json, because that file is usually committed and shared with the team. If the configuration should apply only to one local project, use .claude/settings.local.json and make sure it is ignored by git.

Restart your terminal and run:

claude

Inside Claude Code, run /status to confirm the base URL and credential source. If Claude Code still uses an old login, run /logout and start it again.

Image MCP (optional)

String AI exposes a remote image MCP so Claude Code can generate images directly. This is independent of the Claude API gateway setup above. Use an ordinary sk- key from the console; WebChat and Launcher-managed keys are rejected.

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

Restart Claude Code, then run /mcp and confirm stringai-image is connected. Tools: generate_image, get_image_task, list_image_models. Billing reuses the existing plan quota and usage path.

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。

数据存储位置

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。

資料存儲位置

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. Add Provider पर क्लिक करें और ये मान भरें:

• Name: String AI
• Base URL: https://www.string.ink/v1
• API Key: आपकी sk- कुंजी
• Default model: gpt-6-astra

1. Health Check पर क्लिक करें। अगर जाँच सफल है, तो प्रदाता तैयार है।
2. सहेजें, फिर Codex जैसे OpenAI-संगत टूल को इस प्रदाता पर स्विच करें।

इस /v1 वाले universal provider को Claude Code पर स्विच न करें। Claude Code का ANTHROPIC_BASE_URL https://www.string.ink है। /v1 न जोड़ें। इसे Claude Code में अलग से कॉन्फ़िगर करें।

प्रदाता बदलने के बाद ज्यादातर टूल को टर्मिनल या CLI दोबारा शुरू करना पड़ता है। अगर Codex अभी भी पुरानी कॉन्फ़िगरेशन इस्तेमाल करता है, तो टर्मिनल, VS Code या Codex बंद करके दोबारा खोलें।

डेटा भंडारण स्थान

CC Switch

CC Switch is a cross-platform desktop app for managing providers, routing, usage, sessions, and skills for tools such as Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes.

Installation

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

Add a Provider

1. Open CC Switch and go to the Universal Provider tab.
2. Click Add Provider and enter:

• Name: String AI
• Base URL: https://www.string.ink/v1
• API Key: your sk- key
• Default model: gpt-6-astra

1. Click Health Check. If it succeeds, the provider is ready.
2. Save, then switch an OpenAI-compatible tool such as Codex to this provider.

Do not switch this /v1 universal provider to Claude Code. Claude Code's ANTHROPIC_BASE_URL is https://www.string.ink. Do not append /v1. Configure it separately in Claude Code.

Most tools need a terminal or CLI restart after switching providers. If Codex still uses the old configuration, close and reopen the terminal, VS Code, or Codex.

Data Storage Locations

开始前先确认：是否已经安装 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

開始前先確認：是否已經安裝 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

शुरू करने से पहले: क्या आपने Node.js स्थापित कर लिया है? node --version और npm --version चलाएँ। अगर version numbers नहीं दिखते, तो पहले Node.js runtime स्थापित करें पूरा करें।

OpenClaw

Node.js 22.19+ या Node.js 24 (अनुशंसित) आवश्यक है।

स्थापना

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

विकल्प 1: कॉन्फ़िगरेशन पैच (अनुशंसित)

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      # कॉन्फ़िग मान्य: ~/.openclaw/openclaw.json
npx openclaw models status        # String AI मॉडल और आंशिक रूप से छिपी API Key दिखाता है

# स्थानीय मोड
npx openclaw agent --local --session-id my-session --message "Hello" --model stringai/gpt-6-astra
# या पहले प्रवेशद्वार शुरू करें
npx openclaw onboard --install-daemon
npx openclaw agent --message "Hello" --model stringai/gpt-6-astra

एनवायरनमेंट वेरिएबल स्थायी करें

# Windows PowerShell, as administrator
[Environment]::SetEnvironmentVariable("STRING_AI_API_KEY", "YOUR_API_KEY", "User")

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

Before you start: have you installed Node.js? Run node --version and npm --version. If they do not print version numbers, finish Install the Node.js Runtime first.

OpenClaw

Requires Node.js 22.19+ or Node.js 24, recommended.

Installation

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

Option 1: Configuration Patch (Recommended)

Create 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 }
        ]
      }
    }
  }
}

Set the environment variable and apply the configuration:

# 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"

If old model configuration already exists, use --replace-path. A "Refusing to replace" error means this parameter is required. On success the command asks you to restart the gateway. The update count depends on the existing config. Do not match a fixed number.

Verify and Use

npx openclaw config validate      # Config valid: ~/.openclaw/openclaw.json
npx openclaw models status        # Shows String AI models and a partially hidden API Key

# Local mode
npx openclaw agent --local --session-id my-session --message "Hello" --model stringai/gpt-6-astra
# Or start the gateway first
npx openclaw onboard --install-daemon
npx openclaw agent --message "Hello" --model stringai/gpt-6-astra

Persist the Environment Variable

# Windows PowerShell, as administrator
[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 請替換為你的個人金鑰，不要把真實金鑰提交到項目倉庫或公開文檔。

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- key है। उदाहरणों में YOUR_STRING_AI_API_KEY को अपने व्यक्तिगत key से बदलें। असली key को रिपॉजिटरी या सार्वजनिक दस्तावेज़ में सबमिट न करें।

Hermes Agent इंस्टॉल करें

Hermes Agent एक टर्मिनल कोडिंग एजेंट है। आधिकारिक इंस्टॉल स्क्रिप्ट इस्तेमाल करें। थर्ड-पार्टी पैकेज इस्तेमाल न करें। इंस्टॉलर अपना runtime खुद तैयार करता है। पहले 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 String AI से OpenAI-संगत API के माध्यम से जुड़ता है। उपलब्ध मॉडल: 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 में मैचिंग usage रिकॉर्ड दिखे, तो सेटअप काम कर रहा है।

आम समस्याएँ

अधिक जाँच के लिए Troubleshooting Quick Reference देखें।

Before you start, confirm you already have a working String AI sk- key. Replace YOUR_STRING_AI_API_KEY in the examples with your own key. Do not commit real keys to a repository or public docs.

Install Hermes Agent

Hermes Agent is a terminal coding agent. Use the official install script. Do not use third-party packages. The installer prepares its own runtime. You do not need to install Node.js first.

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

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

The official site also offers desktop packages. Model setup still uses hermes model below. Do not pick a fixed menu number during installation.

Connect Hermes Agent

Hermes connects to String AI through the OpenAI-compatible API. Available models: gpt-6-astra, gpt-5.6-sol, gpt-5.6-luna.

Connection details

Stop the base URL at /v1. Do not append /chat/completions. Type the model name yourself, and make sure it matches the platform. Do not select by menu number. Those numbers change between versions.

Setup steps

1. In a new terminal, run hermes model.
2. Choose Custom endpoint. The menu may say Custom endpoint (self-hosted / VLLM / etc.). Choose it by name, not by a fixed number.
3. Fill in the base URL and API key from the table, and type the model name gpt-6-astra. If the wizard asks for API mode, choose Chat Completions.
4. Save, then run hermes.

You can also write the config file directly. This has the same effect as 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

Available models can differ by account. You can confirm with:

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

Verify the setup

In Hermes, send a simple message such as "Introduce yourself in one sentence." If it replies normally and String AI shows a matching usage record, the setup works.

Common issues

See Troubleshooting Quick Reference for more checks.

开始前请确认你已经有可用的 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 請替換為你的個人金鑰，不要把真實金鑰提交到項目倉庫或公開文檔。

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- key है। उदाहरणों में YOUR_STRING_AI_API_KEY को अपने व्यक्तिगत key से बदलें। असली key को रिपॉजिटरी या सार्वजनिक दस्तावेज़ में सबमिट न करें।

Cursor इंस्टॉल करें

यह पेज Cursor डेस्कटॉप ऐप के लिए है। इसे आधिकारिक डाउनलोड पेज से इंस्टॉल करें। थर्ड-पार्टी पैकेज इस्तेमाल न करें।

आधिकारिक Cursor डाउनलोड पेज खोलें और अपने सिस्टम के लिए इंस्टॉलर चुनें:

इंस्टॉल के बाद Cursor खोलें और पुष्टि करें कि आप एडिटर में पहुँच सकते हैं। डाउनलोड पेज हर रिलीज़ के साथ इंस्टॉलर अपडेट करता है, इसलिए हमेशा उसी पेज से नवीनतम वर्शन लें।

Cursor के पास टर्मिनल CLI भी है (curl https://cursor.com/install -fsS | bash)। यह गाइड डेस्कटॉप Models / API Keys सेटअप कवर करती है। CLI यहाँ कवर नहीं है।

Cursor कनेक्ट करें

Cursor String AI से OpenAI-संगत API के माध्यम से जुड़ता है। अनुशंसित मॉडल 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"

UI लेबल Cursor वर्शन के साथ बदल सकते हैं। स्रोत के रूप में Models / API Keys का इस्तेमाल करें।

सेटअप सत्यापित करें

Cursor में एक सरल कार्य भेजें:

Read the current project structure and summarize what this project may do. Do not modify files.

अगर Cursor सामान्य रूप से जवाब देता है और String AI में मैचिंग usage रिकॉर्ड दिखता है, तो सेटअप काम कर रहा है।

आम समस्याएँ

अधिक जाँच के लिए Troubleshooting Quick Reference देखें।

Before you start, confirm you already have a working String AI sk- key. Replace YOUR_STRING_AI_API_KEY in the examples with your own key. Do not commit real keys to a repository or public docs.

Install Cursor

This page covers the Cursor desktop app. Install it from the official download page. Do not use third-party packages.

Open the official Cursor download page and choose the installer for your system:

After installation, open Cursor and confirm you can reach the editor. The download page updates installers with each release, so always get the latest version from that page.

Cursor also has a terminal CLI (curl https://cursor.com/install -fsS | bash). This guide covers desktop Models / API Keys setup. The CLI is out of scope here.

Connect Cursor

Cursor connects to String AI through the OpenAI-compatible API. The recommended model is gpt-6-astra.

Connection details

Stop the Base URL at /v1. Do not append /chat/completions.

Setup steps

1. Open Cursor, click the settings icon in the bottom-left corner, then open Models in the sidebar.
2. Expand API Keys and enter your String AI API Key in the OpenAI API Key field.
3. Turn on Override OpenAI Base URL and enter https://www.string.ink/v1.
4. Select or manually add gpt-6-astra in the model list. The model name must match the platform. Available models can differ by account. You can confirm with:

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

UI labels may change across Cursor versions. Use Models / API Keys as the source of truth.

Verify the setup

In Cursor, send a simple task:

Read the current project structure and summarize what this project may do. Do not modify files.

If Cursor replies normally and String AI shows a matching usage record, the setup works.

Common issues

See Troubleshooting Quick Reference for more checks.

开始前请确认你已经有可用的 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 請替換為你的個人金鑰，不要把真實金鑰提交到項目倉庫或公開文檔。

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- key है। उदाहरणों में YOUR_STRING_AI_API_KEY को अपने व्यक्तिगत key से बदलें। असली key को रिपॉजिटरी या सार्वजनिक दस्तावेज़ में सबमिट न करें।

WorkBuddy इंस्टॉल करें

यह पेज WorkBuddy डेस्कटॉप क्लाइंट (WorkBuddyCN भी कहा जाता है) के लिए है। इसे आधिकारिक साइट से इंस्टॉल करें। थर्ड-पार्टी पैकेज इस्तेमाल न करें।

1. WorkBuddy वेबसाइट खोलें।
2. अपने सिस्टम के लिए आधिकारिक इंस्टॉलर डाउनलोड करें और इंस्टॉल पूरा करें।
3. WorkBuddy खोलें और पुष्टि करें कि आप होम स्क्रीन पर पहुँच सकते हैं।

Windows पर WorkBuddy आमतौर पर Start मेनू से उपलब्ध होता है। macOS पर यह आमतौर पर Applications में होता है।

अगर आप String AI Launcher इस्तेमाल करते हैं, तो वहाँ से भी WorkBuddyCN इंस्टॉल और कॉन्फ़िगर कर सकते हैं। Launcher वन-क्लिक इंस्टॉल फिलहाल आधिकारिक macOS पैकेज पर केंद्रित है। Windows पर अभी भी आधिकारिक साइट से डाउनलोड करें। कॉन्फ़िगरेशन से पहले WorkBuddy को पूरी तरह बंद करें, नहीं तो मॉडल सूची लिखी नहीं जा सकती।

WorkBuddy कनेक्ट करें

WorkBuddy String AI से OpenAI-संगत API के माध्यम से जुड़ता है।

कनेक्शन विवरण

एंडपॉइंट को /v1 पर रोकें। /chat/completions न जोड़ें। मॉडल नाम प्लेटफ़ॉर्म से मेल खाना चाहिए।

सेटअप चरण

1. WorkBuddy खोलें। मुख पृष्ठ पर चैट बॉक्स में [Auto] बटन पर क्लिक करें, मॉडल चयन पृष्ठ खोलें, फिर कस्टम मॉडल पर क्लिक करें।
2. मॉडल जोड़ें में OpenAI-संगत API समर्थित हैं। प्रदाता ड्रॉपडाउन खोलें और अन्य समूह के अंतर्गत कस्टम चुनें।
3. ऊपर दी गई तालिका से कनेक्शन विवरण भरें।

उन्नत सेटिंग, वैकल्पिक: चुने गए मॉडल की क्षमता के अनुसार function calling, image input और thinking / reasoning सक्षम करें। कस्टम प्रोटोकॉल आम तौर पर जरूरी नहीं होता। इनपुट और आउटपुट संदर्भ लंबाई को प्रदाता डिफ़ॉल्ट पर रखें या जरूरत के अनुसार समायोजित करें। सहेजें पर क्लिक करें, फिर मुख्य मॉडल चयनकर्ता में मॉडल चुनें।

उपलब्ध मॉडल अकाउंट के अनुसार अलग हो सकते हैं। आप इससे पुष्टि कर सकते हैं:

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

सेटअप सत्यापित करें

WorkBuddy में एक सरल संदेश भेजें, जैसे "एक वाक्य में अपना परिचय दें।" अगर सामान्य जवाब मिले और String AI में मैचिंग usage रिकॉर्ड दिखे, तो सेटअप काम कर रहा है।

आम समस्याएँ

अधिक जाँच के लिए Troubleshooting Quick Reference देखें।

Before you start, confirm you already have a working String AI sk- key. Replace YOUR_STRING_AI_API_KEY in the examples with your own key. Do not commit real keys to a repository or public docs.

Install WorkBuddy

This page covers the WorkBuddy desktop client, also called WorkBuddyCN. Install it from the official site. Do not use third-party packages.

1. Open the WorkBuddy website.
2. Download the official installer for your system and finish installation.
3. Open WorkBuddy and confirm you can reach the home screen.

On Windows, WorkBuddy is usually available from the Start menu. On macOS, it is usually in Applications.

If you use String AI Launcher, you can also install and configure WorkBuddyCN there. Launcher one-click install currently focuses on the official macOS package. On Windows, still download from the official site. Fully quit WorkBuddy before configuration, or the model list cannot be written.

Connect WorkBuddy

WorkBuddy connects to String AI through the OpenAI-compatible API.

Connection details

Stop the endpoint at /v1. Do not append /chat/completions. The model name must match the platform.

Setup steps

1. Open WorkBuddy. On the home page, click the [Auto] button in the chat box, open the model selection page, and click Custom Model.
2. In Add Model, which supports OpenAI-compatible APIs, open the Provider dropdown and choose Custom under the Other group.
3. Fill in the connection details from the table above.

Advanced settings, optional: enable function calling, image input, and thinking / reasoning according to the selected model's capability. Custom protocol is usually not needed. Keep input and output context length on provider defaults or adjust as needed. Click Save, then choose the model in the main model selector.

Available models can differ by account. You can confirm with:

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

Verify the setup

In WorkBuddy, send a simple message such as "Introduce yourself in one sentence." If it replies normally and String AI shows a matching usage record, the setup works.

Common issues

See Troubleshooting Quick Reference for more checks.

开始前请确认你已经有可用的 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 后台出现对应消耗记录，说明配置成功。

常见问题

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

開始前請確認你已經有可用的 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 後台出現對應消耗記錄，說明設定成功。

常見問題

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

शुरू करने से पहले पुष्टि करें कि आपके पास काम करने वाला String AI sk- key है। उदाहरणों में YOUR_STRING_AI_API_KEY को अपने व्यक्तिगत key से बदलें। असली key को रिपॉजिटरी या सार्वजनिक दस्तावेज़ में सबमिट न करें।

Dify इंस्टॉल करें

आप आधिकारिक Dify Cloud इस्तेमाल कर सकते हैं या Dify को सेल्फ-होस्ट कर सकते हैं। यह पेज केवल String AI कनेक्ट करना कवर करता है। यह आधिकारिक Dify डिप्लॉयमेंट दस्तावेज़ की जगह नहीं लेता।

विकल्प 1: Dify Cloud (पहला कनेक्शन टेस्ट के लिए अनुशंसित)

1. Dify Cloud खोलें और साइन इन करें।
2. वर्कस्पेस में प्रवेश करने के बाद, नीचे दिए चरणों से मॉडल प्रदाता जोड़ें।

विकल्प 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 खोलें, फिर Dify में प्रवेश करने के लिए http://localhost खोलें।

Dify कनेक्ट करें

सही प्रवेश इस्तेमाल करें: मॉडल प्रदाता मॉडल पहुँच के लिए है और इस गाइड में वही इस्तेमाल होता है। API Extension बाहरी HTTP मिडलवेयर कॉलबैक, जैसे सामग्री समीक्षा, के लिए है। यह मॉडल पहुँच के लिए नहीं है। वहाँ String AI पता न डालें।

कनेक्शन विवरण

सेटअप चरण

Dify में जाएँ -> ऊपर दाएँ कोने में अवतार -> सेटिंग -> मॉडल प्रदाता। OpenAI-API-compatible खोजें, मॉडल जोड़ें पर क्लिक करें, और ऊपर दी गई तालिका भरें।

वास्तविक model capability के अनुसार 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 में मैचिंग usage रिकॉर्ड दिखता है, तो सेटअप काम कर रहा है।

आम समस्याएँ

अधिक जाँच के लिए Troubleshooting Quick Reference देखें।

Before you start, confirm you already have a working String AI sk- key. Replace YOUR_STRING_AI_API_KEY in the examples with your own key. Do not commit real keys to a repository or public docs.

Install Dify

You can use official Dify Cloud or self-host Dify. This page only covers connecting String AI. It does not replace the official Dify deployment docs.

Option 1: Dify Cloud (recommended for first connection tests)

1. Open Dify Cloud and sign in.
2. After you enter a workspace, add a model provider with the steps below.

Option 2: Self-host

Your machine or server needs Docker and Docker Compose. See the Dify self-hosting docs for full requirements.

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

Open http://localhost/install to finish admin setup, then open http://localhost to enter Dify.

Connect Dify

Use the correct entry: Model Provider is for model access and is used in this guide. API Extension is for external HTTP middleware callbacks such as content review. It is not for model access. Do not enter the String AI address there.

Connection details

Setup steps

Go to Dify -> avatar in the top-right corner -> Settings -> Model Provider. Search for OpenAI-API-compatible, click Add Model, and fill in the table above.

Enable Vision, Function calling, and Stream based on the actual model capability. If unsure, keep defaults first, then click Add.

Available models can differ by account. You can confirm with:

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

Verify the setup

1. Test the newly added model on the Model Provider page, or create a blank app and select that model.
2. Send a simple message such as "Introduce yourself in one sentence."
3. If Dify replies normally and String AI shows a matching usage record, the setup works.

Common issues

See Troubleshooting Quick Reference for more checks.

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"}]}'

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"}]}'

One API

यह पेज 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 हैं।

चैनल जोड़ें

Channels -> Add Channel पर जाएँ और 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"}]}'

One API

This page builds and starts One API with Go. Node.js is not required.

Start One API

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

Open http://localhost:3000. The default username and password are admin / 123456.

Add a Channel

Go to Channels -> Add Channel and choose Proxy:

Then create model mappings for gpt-6-astra, gpt-5.6-sol, and gpt-5.6-luna in model management.

Test

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 API 付費用戶。如僅使用網頁聊天，無需 API Key，直接通過 Webchat 使用即可。

त्वरित समस्या-समाधान संदर्भ

यह गाइड String AI API भुगतान उपयोगकर्ताओं के लिए है। अगर आप सिर्फ web chat इस्तेमाल करते हैं, तो आपको API Key की जरूरत नहीं है। सीधे Webchat इस्तेमाल करें।

Troubleshooting Quick Reference

This guide is for paid String AI API users. If you only use web chat, you do not need an API Key. Use Webchat directly.

模型说明

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 与网络连通性基本正常。

模型說明

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

मॉडल अवलोकन

String AI बातचीत, चित्र निर्माण, ध्वनि-से-पाठ, कोड समीक्षा और स्वचालन के लिए मॉडल उपलब्ध कराता है। एकीकरण से पहले यह पुष्टि करें कि आपका खाता किन मॉडलों तक पहुँच रखता है, फिर स्क्रिप्ट या तृतीय-पक्ष टूल में model 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"

अगर API object: "list" और data array लौटाता है, तो आपका API Key, Base URL और नेटवर्क कनेक्शन मूल रूप से काम कर रहे हैं।

Model Overview

String AI provides models for conversation, image generation, transcription, code review, and automation. Before integrating, confirm which models your account can access, then use the model ID in scripts or third-party tools.

Conversation Models

• gpt-6-astra: The latest flagship model, recommended as the default conversation model.
• gpt-5.6-sol: Flagship model for stable text generation, Q&A, and tool-calling workflows.
• gpt-5.6-luna: Lightweight and fast model for link testing, low-latency scripts, and cost-sensitive tasks.

Coding and Automation

• codex-auto-review: Automated code review model for code review workflows.

Image Capabilities

• gpt-image-1s: Image generation model.
• gpt-image-1.5: Image generation model.
• gpt-image-2: Recommended model for image generation and image editing.

Speech Transcription

• gpt-4o-transcribe: Speech-to-text model for audio transcription scenarios.

Query Available Models

Different accounts may have different model permissions. Use the model list endpoint to confirm which models your API Key can access:

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

If the API returns object: "list" and a data array, your API Key, Base URL, and network connection are basically working.