88code Desktop 操作文档
目录
软件介绍
88code Desktop 是一款专为 AI 编程工具设计的跨平台配置管理工具,支持快速配置 Claude Code 和 Codex。
主要特性
- 🚀 一键配置 - 快速配置 Claude Code、Codex 和 Droid (Factory)
- 💾 智能备份 - 首次配置自动备份,保护原始设置
- 🎨 高级模式 - 支持自定义 JSON/TOML 配置
- 🌍 跨平台 - 支持 Windows、macOS 和 Linux
- 🤖 多模型支持 - 支持 Droid (Factory) 自定义模型配置
安装说明
下载安装包
从 [GitHub Releases]https://github.com/byebye-code/88code-desktop/releases/tag/V1.1.0) 下载对应系统的安装包:
- Windows:
88code-desktop_x.x.x_x64.msi
或.exe
- macOS:
88code-desktop_x.x.x_x64.dmg
- Linux:
88code-desktop_x.x.x_amd64.deb
安装步骤
Windows
- 双击下载的
.msi
或.exe
文件 - 按照安装向导提示完成安装
- 首次运行可能需要管理员权限
macOS
- 双击
.dmg
文件 - 将应用拖入"应用程序"文件夹
- 首次运行需要在"系统偏好设置 > 安全性与隐私"中允许运行
Linux
sudo dpkg -i 88code-desktop_x.x.x_amd64.deb
或者使用自行构建:
pnpm install
pnpm tauri build
Claude Code 配置
配置文件位置
- Windows:
C:\Users\<用户名>\.claude\settings.json
- macOS/Linux:
~/.claude/settings.json
基础配置(推荐)
操作步骤:
- 启动 88code Desktop
- 点击左侧导航栏的 "Claude" 标签
- 选择 "Claude Code 配置" 选项卡
- 填写配置信息:
- Base URL: 输入 API 服务地址
- 默认值:
https://www.88code.org/api
- 如果不填写,将自动使用默认值
- 默认值:
- API Key: 输入您的 API 密钥(必填)
- Base URL: 输入 API 服务地址
- 点击 "自动配置" 按钮
- 等待配置完成,看到成功提示
配置效果:
- 自动创建/更新
~/.claude/settings.json
文件 - 配置
anthropicBaseURL
和anthropicAuthToken
- 首次配置会自动创建
settings.json.bak
备份文件
验证配置:
# 查看配置文件
cat ~/.claude/settings.json
# 测试 Claude Code
claude --version
claude chat "Hello"
高级配置
适用场景:
- 需要自定义更多配置项
- 需要配置代理、超时等高级选项
- 需要完全控制配置内容
操作步骤:
- 在 Claude Code 配置页面
- 点击 "高级配置" 按钮
- 在弹出的编辑器中输入完整的 JSON 配置
- 点击 "保存配置"
配置示例:
{
"anthropicBaseURL": "https://www.88code.org/api",
"anthropicAuthToken": "your-api-key-here",
"timeout": 30000,
"maxRetries": 3
}
清空配置
操作步骤:
- 在 Claude Code 配置页面
- 点击 "清空配置" 按钮
- 确认删除操作
效果: 删除 ~/.claude/settings.json
文件
配置备份与恢复
自动备份:
- 首次配置时自动创建
.bak
备份文件 - 备份位置:
~/.claude/settings.json.bak
- 已存在的备份文件不会被覆盖
手动恢复备份:
# 恢复配置文件
cp ~/.claude/settings.json.bak ~/.claude/settings.json
Codex 配置
配置文件位置
- Windows:
C:\Users\<用户名>\.codex\auth.json
C:\Users\<用户名>\.codex\config.toml
- macOS/Linux:
~/.codex/auth.json
~/.codex/config.toml
基础配置(推荐)
操作步骤:
- 启动 88code Desktop
- 点击左侧导航栏的 "Codex" 标签
- 选择 "Codex 配置" 选项卡
- 填写配置信息:
- API Key: 输入您的 API 密钥(必填)
- Base URL: 输入 API 服务地址
- 默认值:
https://88code.org/openai/v1
- 如果不填写,将自动使用默认值
- 默认值:
- 点击 "自动配置" 按钮
- 等待配置完成,看到成功提示
配置效果:
- 自动创建/更新
~/.codex/auth.json
和config.toml
- 设置环境变量
key88=<您的API密钥>
- 首次配置自动创建备份文件
重要提示:
- Windows 用户: 配置后需要重启终端或 Codex 才能使环境变量生效
- Linux/macOS 用户: 需要重启终端或运行
source ~/.zshrc
验证配置:
# 查看配置文件
cat ~/.codex/auth.json
cat ~/.codex/config.toml
# 验证环境变量
# Windows
echo %key88%
# Linux/macOS
echo $key88
# 测试 Codex
codex --version
高级配置
适用场景:
- 需要完全自定义配置内容
- 需要配置更多高级选项
操作步骤:
- 在 Codex 配置页面
- 点击 "高级配置" 按钮
- 在弹出的编辑器中分别编辑:
- auth.json - 认证配置(JSON 格式)
- config.toml - 主配置文件(TOML 格式)
- 填写 API Key(用于设置环境变量)
- 点击 "保存配置"
auth.json 示例:
{
"api_key": "your-api-key-here",
"base_url": "https://88code.org/openai/v1",
"timeout": 30
}
config.toml 示例:
[server]
base_url = "https://88code.org/openai/v1"
timeout = 30
[model]
default = "gpt-4"
temperature = 0.7
max_tokens = 2000
[auth]
method = "apikey"
清空配置
操作步骤:
- 在 Codex 配置页面
- 点击 "清空配置" 按钮
- 确认删除操作
效果: 删除 ~/.codex/auth.json
和 config.toml
文件
注意: 环境变量 key88
不会被自动删除,需要手动清理
环境变量管理
环境变量说明: Codex 配置会自动设置环境变量 key88=<您的API密钥>
,供 Codex 工具使用。
环境变量位置:
- Windows: 用户环境变量(通过
setx
命令设置) - Linux/macOS:
~/.zshrc
或~/.bashrc
文件
手动清理环境变量:
Windows:
- 右键"此电脑" > "属性"
- 点击"高级系统设置"
- 点击"环境变量"
- 在"用户变量"中找到
key88
并删除
Linux/macOS:
# 编辑配置文件
nano ~/.zshrc # 或 ~/.bashrc
# 删除包含 key88 的行,保存退出
# 重新加载配置
source ~/.zshrc
配置备份与恢复
自动备份:
- 首次配置时自动创建
.bak
备份文件 - 备份位置:
~/.codex/auth.json.bak
~/.codex/config.toml.bak
- 已存在的备份文件不会被覆盖
手动恢复备份:
# 恢复配置文件
cp ~/.codex/auth.json.bak ~/.codex/auth.json
cp ~/.codex/config.toml.bak ~/.codex/config.toml
Droid (Factory) 配置
配置文件位置
- Windows:
C:\Users\<用户名>\.factory\config.json
- macOS/Linux:
~/.factory/config.json
关于 Droid (Factory)
Droid 是一个支持自定义 AI 模型的编程工具框架。本工具预设了三个 88code 优化模型:
- Sonnet 4.5 [88code] - Claude 最新的 Sonnet 4.5 模型
- GPT-5-Codex [88code] - 专为代码优化的 GPT-5 模型
- GPT-5 [88code] - 通用 GPT-5 模型
一键配置(推荐)
操作步骤:
- 启动 88code Desktop
- 点击左侧导航栏的 "Droid" 标签
- 填写配置信息:
- API 密钥: 输入您的 88code API 密钥(必填)
- 点击 "一键配置所有模型" 按钮
- 等待配置完成,看到成功提示
配置效果:
- 自动创建/更新
~/.factory/config.json
文件 - 配置所有预设模型(Sonnet 4.5、GPT-5、GPT-5-Codex)
- 所有模型共享同一个 API Key
- 首次配置会自动创建
config.json.bak
备份文件
配置文件示例:
{
"custom_models": [
{
"model_display_name": "Sonnet 4.5 [88code]",
"model": "claude-sonnet-4-5-20250929",
"base_url": "https://www.88code.org/droid",
"api_key": "your-api-key-here",
"provider": "anthropic"
},
{
"model_display_name": "GPT-5-Codex [88code]",
"model": "gpt-5-codex",
"base_url": "https://www.88code.org/droid/v1",
"api_key": "your-api-key-here",
"provider": "openai"
},
{
"model_display_name": "GPT-5 [88code]",
"model": "gpt-5",
"base_url": "https://www.88code.org/droid/v1",
"api_key": "your-api-key-here",
"provider": "openai"
}
]
}
验证配置:
# 查看配置文件
cat ~/.factory/config.json
# Windows
type %USERPROFILE%\.factory\config.json
高级配置
适用场景:
- 需要添加自定义模型
- 需要修改模型配置(Base URL、Provider 等)
- 需要完全控制配置内容
操作步骤:
- 在 Droid 配置页面
- 点击 "高级配置" 按钮
- 在弹出的 JSON 编辑器中:
- 在顶部 API 密钥 输入框中输入您的密钥(可选)
- 编辑下方的完整 JSON 配置
- API 密钥会自动同步到 JSON 中的所有 "你的API密钥" 占位符
- 可以点击 "使用默认模板" 恢复预设配置
- 可以点击 "格式化" 按钮美化 JSON 格式
- 点击 "应用配置" 保存
高级配置特性:
- 支持添加任意数量的自定义模型
- 支持不同的 Base URL 和 Provider
- 实时 JSON 格式验证
- 自动替换 API 密钥占位符
- 自动创建备份文件
自定义模型示例:
{
"custom_models": [
{
"model_display_name": "我的自定义模型",
"model": "custom-model-name",
"base_url": "https://your-api-endpoint.com",
"api_key": "your-api-key-here",
"provider": "openai"
}
]
}
字段说明:
model_display_name
:模型显示名称(必填)model
:模型标识符(可选,留空使用默认值)base_url
:API 服务地址(必填)api_key
:API 密钥(必填)provider
:提供商类型,如anthropic
、openai
等(必填)
模型管理
查看已配置的模型
在 Droid 配置页面会显示 "已配置的模型" 列表,包含:
- 模型显示名称
- 模型标识符
- Base URL
- Provider
- API Key 配置状态(✓ 已配置 / ⚠ 未配置)
删除单个模型
操作步骤:
- 在 "已配置的模型" 列表中找到要删除的模型
- 点击该模型右侧的 "删除" 按钮
- 确认删除操作
效果: 从配置文件中移除该模型,其他模型不受影响
导出配置
操作步骤:
- 在 Droid 配置页面点击 "导出" 按钮
- 配置将自动下载为
droid-config.json
文件
用途:
- 备份当前配置
- 分享配置给其他用户
- 迁移到其他设备
删除配置文件
操作步骤:
- 在 Droid 配置页面
- 点击配置文件路径右侧的 "删除配置文件" 按钮
- 确认删除操作
效果: 完全删除 ~/.factory/config.json
文件,所有模型配置将被清空
注意: 此操作不可恢复,请谨慎操作。如需恢复,可使用备份文件。
配置备份与恢复
自动备份:
- 首次配置时自动创建
.bak
备份文件 - 备份位置:
~/.factory/config.json.bak
- 已存在的备份文件不会被覆盖
手动恢复备份:
# 恢复配置文件
cp ~/.factory/config.json.bak ~/.factory/config.json
# Windows
copy %USERPROFILE%\.factory\config.json.bak %USERPROFILE%\.factory\config.json
使用技巧
批量更换 API Key
方法一:使用一键配置
- 输入新的 API Key
- 点击 "一键配置所有模型"
- 所有预设模型的 API Key 将被更新
方法二:使用高级配置
- 打开 "高级配置"
- 在 API 密钥 输入框中输入新密钥
- JSON 中所有的 "你的API密钥" 占位符会自动替换
- 点击 "应用配置"
混合使用不同 API Key
如果需要为不同模型使用不同的 API Key:
- 打开 "高级配置"
- 不在顶部输入 API 密钥
- 直接在 JSON 中为每个模型单独配置
api_key
字段 - 点击 "应用配置"
示例:
{
"custom_models": [
{
"model_display_name": "Sonnet 4.5 [88code]",
"model": "claude-sonnet-4-5-20250929",
"base_url": "https://www.88code.org/droid",
"api_key": "key-for-anthropic",
"provider": "anthropic"
},
{
"model_display_name": "GPT-5 [88code]",
"model": "gpt-5",
"base_url": "https://www.88code.org/droid/v1",
"api_key": "key-for-openai",
"provider": "openai"
}
]
}
常见问题
Q1: 配置后不生效怎么办?
Claude Code:
- 检查配置文件是否存在:bash
ls ~/.claude/settings.json
- 查看配置内容是否正确:bash
cat ~/.claude/settings.json
- 重启终端或 Claude Code
Codex:
- 检查环境变量是否设置:bash
# Windows echo %key88% # Linux/macOS echo $key88
- 如果环境变量未设置:
- Windows: 重启终端或命令提示符
- Linux/macOS: 运行
source ~/.zshrc
或重启终端
- 检查配置文件:bash
cat ~/.codex/auth.json cat ~/.codex/config.toml
Q2: 提示 "配置文件格式错误" 怎么办?
原因: 高级配置中的 JSON/TOML 格式不正确
解决方案:
- 优先使用基础配置模式,避免手动编辑出错
- 如果必须使用高级配置,请确保:
- JSON 格式:所有字符串使用双引号,无尾部逗号
- TOML 格式:遵循 TOML 语法规范
- 使用在线验证工具检查格式:
- JSON: https://jsonlint.com/
- TOML: https://www.toml-lint.com/
常见 JSON 错误:
// ❌ 错误:尾部逗号
{
"key": "value",
}
// ✅ 正确
{
"key": "value"
}
Q3: Windows 环境变量未生效
症状: 配置成功但命令行工具无法识别环境变量
解决方案:
- 完全关闭所有终端窗口(包括 PowerShell、CMD、Git Bash 等)
- 重新打开新的终端窗口
- 验证环境变量:cmd
echo %ANTHROPIC_BASE_URL% echo %key88%
- 如果仍未生效,尝试重启电脑
检查环境变量是否已设置:
- 右键"此电脑" > "属性"
- 点击"高级系统设置" > "环境变量"
- 在"用户变量"中查找对应的变量名
Q4: 配置后如何验证是否成功?
Claude Code 验证:
# 1. 查看配置文件
cat ~/.claude/settings.json
# 2. 测试 Claude Code 命令
claude --version
# 3. 测试聊天功能
claude chat "Hello"
# 4. 检查环境变量(如果配置了终端环境变量)
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
Codex 验证:
# 1. 查看配置文件
cat ~/.codex/auth.json
cat ~/.codex/config.toml
# 2. 检查环境变量
echo $key88 # Linux/macOS
echo %key88% # Windows
# 3. 测试 Codex 命令
codex --version
Q5: 如何更新配置?
方式一:直接重新配置(推荐)
- 在应用中重新填写新的配置信息
- 点击"自动配置"按钮
- 配置会自动覆盖旧配置,保留其他字段
方式二:手动编辑配置文件
# 编辑 Claude Code 配置
nano ~/.claude/settings.json
# 编辑 Codex 配置
nano ~/.codex/auth.json
nano ~/.codex/config.toml
# 保存后重启相关应用
方式三:清空后重新配置
- 点击"清空配置"删除现有配置
- 重新填写配置信息
- 点击"自动配置"
Q6: 配置文件被误删如何恢复?
使用自动备份恢复:
# 恢复 Claude Code 配置
cp ~/.claude/settings.json.bak ~/.claude/settings.json
# 恢复 Codex 配置
cp ~/.codex/auth.json.bak ~/.codex/auth.json
cp ~/.codex/config.toml.bak ~/.codex/config.toml
注意事项:
- 仅首次配置时创建备份
- 后续修改配置不会更新备份文件
- 如果备份文件也被删除,需要重新配置
Q7: API Key 填错了怎么办?
解决方案:
- 直接在应用中重新填写正确的 API Key
- 点击"自动配置"覆盖错误的配置
- 重启相关工具使新配置生效
或者手动修改:
# 编辑配置文件
nano ~/.claude/settings.json
# 或
nano ~/.codex/auth.json
# 修改 API Key 后保存
Q8: 配置会影响其他设置吗?
不会! 本工具采用智能配置续写:
- 仅修改相关配置项(如
anthropicBaseURL
、anthropicAuthToken
) - 保留配置文件中的所有其他字段
- 使用原子写入机制,防止配置损坏
示例: 原配置:
{
"anthropicBaseURL": "old-url",
"otherSetting": "value",
"theme": "dark"
}
配置后:
{
"anthropicBaseURL": "new-url",
"anthropicAuthToken": "new-key",
"otherSetting": "value",
"theme": "dark"
}
Q9: 如何完全卸载?
卸载应用:
- Windows: 控制面板 > 程序和功能 > 卸载 88code Desktop
- macOS: 将应用拖入废纸篓
- Linux:
sudo dpkg -r 88code-desktop
清理配置文件(可选):
# 删除所有配置
rm -rf ~/.claude ~/.codex
# 或仅删除特定配置
rm ~/.claude/settings.json
rm ~/.codex/auth.json
rm ~/.codex/config.toml
清理环境变量:
Windows:
- 右键"此电脑" > "属性" > "高级系统设置" > "环境变量"
- 删除用户变量中的:
ANTHROPIC_BASE_URL
ANTHROPIC_AUTH_TOKEN
key88
Linux/macOS:
# 编辑配置文件
nano ~/.zshrc # 或 ~/.bashrc
# 删除包含以下内容的行:
# export ANTHROPIC_BASE_URL=...
# export ANTHROPIC_AUTH_TOKEN=...
# export key88=...
# 保存后重新加载
source ~/.zshrc
Q10: Base URL 应该填什么?
Claude Code:
- 默认值:
https://www.88code.org/api
- 如果使用官方服务,请填写官方 API 地址
- 如果留空,将自动使用默认值
Codex:
- 默认值:
https://88code.org/openai/v1
- 必须是兼容 OpenAI API 的服务地址
- 如果留空,将自动使用默认值
Droid (Factory):
- Anthropic 模型默认:
https://www.88code.org/droid
- OpenAI 模型默认:
https://www.88code.org/droid/v1
- 支持自定义任意兼容的 API 地址
格式要求:
- 必须以
http://
或https://
开头 - 不要在末尾添加斜杠
/
- 示例:
https://api.example.com/v1
✅ - 错误:
api.example.com
❌(缺少协议) - 错误:
https://api.example.com/v1/
❌(多余斜杠)
Q11: Droid 配置后如何验证?
验证步骤:
检查配置文件是否存在:
bash# Linux/macOS ls ~/.factory/config.json # Windows dir %USERPROFILE%\.factory\config.json
查看配置内容:
bash# Linux/macOS cat ~/.factory/config.json # Windows type %USERPROFILE%\.factory\config.json
在应用中查看 "已配置的模型" 列表
- 确认所有模型都显示 "✓ API Key 已配置"
- 检查 Base URL 和 Provider 是否正确
使用 Droid (Factory) 工具测试模型调用
Q12: 如何为不同模型使用不同的 API Key?
Droid 支持为每个模型配置独立的 API Key:
- 点击 "高级配置" 按钮
- 不要 在顶部 "API 密钥" 输入框中填写
- 直接在 JSON 中为每个模型单独设置
api_key
- 点击 "应用配置" 保存
示例:
{
"custom_models": [
{
"model_display_name": "Sonnet 4.5 [88code]",
"model": "claude-sonnet-4-5-20250929",
"base_url": "https://www.88code.org/droid",
"api_key": "anthropic-api-key-here",
"provider": "anthropic"
},
{
"model_display_name": "GPT-5 [88code]",
"model": "gpt-5",
"base_url": "https://www.88code.org/droid/v1",
"api_key": "openai-api-key-here",
"provider": "openai"
}
]
}
Q13: 如何添加自定义模型?
方法一:通过高级配置添加
- 点击 "高级配置" 按钮
- 在
custom_models
数组中添加新的模型对象 - 填写必填字段:
model_display_name
、base_url
、api_key
、provider
- 点击 "应用配置"
方法二:导出-修改-导入
- 点击 "导出" 按钮,下载当前配置
- 编辑下载的
droid-config.json
文件,添加新模型 - 在高级配置中粘贴修改后的 JSON
- 点击 "应用配置"
自定义模型示例:
{
"model_display_name": "DeepSeek Coder V3",
"model": "deepseek-coder-v3",
"base_url": "https://api.deepseek.com/v1",
"api_key": "your-deepseek-api-key",
"provider": "openai"
}
Q14: Droid 配置文件损坏了怎么办?
解决方案:
恢复备份文件(推荐):
bash# Linux/macOS cp ~/.factory/config.json.bak ~/.factory/config.json # Windows copy %USERPROFILE%\.factory\config.json.bak %USERPROFILE%\.factory\config.json
重新一键配置:
- 在应用中点击 "删除配置文件"
- 输入 API Key
- 点击 "一键配置所有模型"
使用默认模板:
- 打开 "高级配置"
- 点击 "使用默认模板"
- 输入 API Key
- 点击 "应用配置"
Q15: 为什么显示 "⚠ API Key 未配置"?
出现此提示说明模型的 api_key
字段为空或使用了占位符 "请替换为你的 API Key"
。
解决方案:
重新一键配置(最简单):
- 输入正确的 API Key
- 点击 "一键配置所有模型"
使用高级配置更新:
- 打开 "高级配置"
- 在顶部输入 API Key
- 点击 "应用配置"
手动编辑配置文件:
bash# Linux/macOS nano ~/.factory/config.json # Windows notepad %USERPROFILE%\.factory\config.json
将所有
"api_key": "请替换为你的 API Key"
替换为实际的密钥
技术支持
获取帮助
项目地址:
报告问题:
文档:
- 项目说明:
README.md
配置文件格式参考
settings.json (Claude Code)
{
"anthropicBaseURL": "https://www.88code.org/api",
"anthropicAuthToken": "your-api-key-here"
}
auth.json (Codex)
{
"api_key": "your-api-key-here",
"base_url": "https://88code.org/openai/v1"
}
config.toml (Codex)
[server]
base_url = "https://88code.org/openai/v1"
[auth]
method = "apikey"
config.json (Droid/Factory)
{
"custom_models": [
{
"model_display_name": "Sonnet 4.5 [88code]",
"model": "claude-sonnet-4-5-20250929",
"base_url": "https://www.88code.org/droid",
"api_key": "your-api-key-here",
"provider": "anthropic"
},
{
"model_display_name": "GPT-5-Codex [88code]",
"model": "gpt-5-codex",
"base_url": "https://www.88code.org/droid/v1",
"api_key": "your-api-key-here",
"provider": "openai"
},
{
"model_display_name": "GPT-5 [88code]",
"model": "gpt-5",
"base_url": "https://www.88code.org/droid/v1",
"api_key": "your-api-key-here",
"provider": "openai"
}
]
}
许可证
MIT License
© 2025 88code
祝您使用愉快!
如有任何问题或建议,欢迎通过 GitHub Issues 与我们联系。