登录方式

AtomCode 支持两种方式接入 LLM:AtomGit CodingPlan(含免费额度)和传统 API Key。本页帮你选对方式,并完成绑定。

两种方式速览

v4.24.1 起 /codingplan 已折进 /login;旧的「纯 OAuth 不申领额度」入口已移除。

AtomGit CodingPlan(推荐)

AtomGit 是 CSDN / 开放原子开源基金会旗下的开源代码托管平台,AtomCode 原生集成了它的 OAuth 和 CodingPlan。/login 是新用户最省事的入口,一次操作完成登录 → 申领免费 token 额度 → 自动根据额度内的模型列表写好 provider 配置。用完这条命令,直接就能开始聊天。已登录后再跑会幂等地同步最新模型列表,不会重复申领。

从首次运行启动向导接入

1. 首次启动 atomcode,会自动弹出 3 步启动向导。
2. 第 1 步(欢迎)按 Enter,第 2 步(语言)按 1/2/3 选语言。
3. 第 3 步(配置)选 用 AtomGit CodingPlan 一键接入(选项 1)。
4. 浏览器会自动打开 AtomGit 授权页面,点击允许即可。
5. 授权完成后 TUI 会自动申领 CodingPlan 并写入 provider 配置,无需再动 config.toml,直接开始发消息。

如果跳过过了想重新跑一遍向导,任何时候执行 /welcome 即可。

在已有会话里接入

已经进入 TUI 后,任意时刻执行:

/login

会唤起浏览器完成授权、申领 CodingPlan、更新 provider 列表。再次执行会重新同步模型列表,把本地的 AtomGit* provider 同步到最新的额度模型。

从命令行接入

atomcode login

适合在脚本、远程服务器、容器镜像等场景一次性完成接入。CLI 子命令和 TUI /login 走同一套流程,输出同样的报告。注:atomcode codingplan 仍作为隐藏别名保留,老脚本和肌肉记忆都不会因为命令折叠而失效。

查看状态 / 退出

atomcode status     # 或 TUI 内 /status — 包含 CodingPlan 使用量和过期时间
atomcode logout     # 或 TUI 内 /logout — 清除 OAuth token

API Key 方式

如果你想使用自有的 OpenAI / Claude / DeepSeek / GLM 等密钥,有三种做法:

方式 A:TUI 内 /provider

1. 在 TUI 中输入 /provider。
2. 选择"添加新 provider",按提示填写 type、base URL、API Key、model 等。
3. 配置会自动写回 ~/.atomcode/config.toml。

方式 B:手动编辑配置文件

直接编辑 ~/.atomcode/config.toml,写入一个 [providers.*] 条目即可,字段参见 ProviderConfig 字段。

方式 C:命令行一次性覆盖

不想改配置文件、只想临时用另一个 provider?启动时加参数即可:

atomcode --provider deepseek --model deepseek-reasoner

选哪个?

• 第一次使用 → CodingPlan(/login),免费额度直接用。
• 已有自己的 API Key → 跳过 /login,直接用 API Key(/provider 或手动编辑配置)。需要 AtomGit 集成(/issue 等)再跑 /login,但会顺带申领 CodingPlan 并注册 AtomGit-* provider。
• 需要在 CI / 脚本里跑 → API Key + 配置文件或环境变量。
• 完全离线 → 配置一个 Ollama provider,不需要任何登录。

下一步

• 基本使用 —— 登录后第一件事:学怎么描述任务。
• 斜杠命令 —— /provider、/model、/status 详解。