Codex Desktop: Manual Configuration

Codex Desktop uses the same Codex Home configuration as Codex CLI. Quit Codex Desktop completely before editing the files.

Access Information

Item	Value
OpenAI-compatible endpoint	https://ai.hctopup.com/v1
Example model	gpt-5.5
API Key	Use the Key created in HCAI

Local Runtime

Create the configuration directory for your system:

Platform	Configuration directory
Native Windows	%USERPROFILE%\.codex\
macOS	~/.codex/

Put the same config.toml and auth.json from Codex CLI manual configuration into that directory. Reopen Codex Desktop, select a project folder, and start using it.

WSL Runtime

If Codex Desktop for Windows runs the agent in WSL2, configure it inside the WSL terminal:

mkdir -p ~/.codex
cd ~/.codex

Then add the same config.toml and auth.json from Codex CLI manual configuration. Restart Codex Desktop before opening your project.

Next Steps

• OpenCode: Manual Configuration
• Codex Desktop: CC-Switch Quick Configuration