最近发现一个挺有常见的事——很多人想用 Claude Code,但卡在了第一步。
有人不知道怎么装,有人没有 Claude 账号,还有人想接国内的模型 API 但不知道从哪下手。这三个问题其实可以一次性解决,而且比想象中简单。
先说结论:最省事的办法,是先装一个叫 opencode 的工具,然后让它帮你把 Claude Code 装好、配好。
opencode 是一个开源的终端工具,可以理解成一个"AI 助手壳子",能接各种模型。
安装方式取决于你的系统:
所有系统适用:
curl -fsSL https://opencode.ai/install | bash
装完之后,在终端输入 opencode,能进到交互界面就说明装好了。
第二步:写个配置文件,把你的模型信息存进去
这一步是关键。你需要告诉 opencode 你要用哪个模型、API 地址是什么、Key 是什么。
建议先在本地建一个 Markdown 文件,比如叫 my-model.md,把你手头的模型信息写进去。格式大概这样:
# 我的模型配置
- 模型名称:deepseek-chat(或者你用的其他模型)
- API 地址:https://api.deepseek.com/v1(换成你的服务商地址)
- API Key:sk-xxxxxx(你的真实密钥)
这个文件不用放到什么特定位置,只要你能找到就行。建议放在一个你常用的目录里,比如 ~/configs/my-model.md。
为什么要写成文件?因为后面你要把这些信息喂给 opencode,让它帮你配置。直接复制粘贴容易出错,有个文件更稳妥。
另外关于存放位置,我是放在了我的icloud里,这样后期也便于跨设备维护和管理。当然如果你担心安全问题,也可以考虑非云端同步的方式。
第三步:启动 opencode,先免费用起来
opencode 自带一个免费模式,用的是一个公开的免费模型。这个免费模式不需要任何配置,直接能用。
在终端里输入:
进去之后,你会看到一个聊天界面。这个时候它还是用的默认模型,但这不重要——你的目的是让它帮你配置。
第四步:告诉 opencode 你的需求
现在你可以跟 opencode 对话了。把你准备好的模型信息发给它,然后说清楚你要干什么。
你可以这样写:
当然,这里也可以直接通过文件路径的方式来引用你的信息。比如:
opencode 会自动读取文件内容,然后根据文件里的信息来配置。
opencode 会理解你的意图,然后帮你生成或修改配置文件。通常它会创建或编辑 ~/.config/opencode/config.toml 这个文件。
第五步:让 opencode 帮你装 Claude Code
配置好自己的模型之后,继续跟 opencode 说:
这一步 opencode 会帮你做几件事:
安装 Claude Code(通常是通过 npm 或下载二进制)
修改 Claude Code 的配置文件,指向你的模型 API
安装完成之后,你可以试着运行 claude 命令,看看能不能直接进到对话界面。如果一切正常,你应该已经可以用了——不需要 Claude 账号,用的是你自己的模型。
如果 opencode 没有自动帮你配置完整,你可能需要手动检查或编辑配置文件。
Claude Code 的配置文件通常在:
macOS / Linux:
Windows: